---
name: "mconv_encode_buffer"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mconv_encode_buffer"
---

# mconv\_encode\_buffer(3m17n)

## NAME

mconv\_encode\_buffer -

## SYNOPSIS

int **mconv\_encode\_buffer** (MSymbol *name*, **MText** \* *mt*, unsigned char \* *buf*, int *n*)

## DESCRIPTION

Encode an M-text into a buffer area. The **mconv\_encode\_buffer()** function encodes M-text **mt** based on coding system **name** and writes the resulting byte sequence into the buffer area pointed to by **buf**. At most **n** bytes are written. A temporary code converter for encoding is automatically created and freed.

## RETURN VALUE

If the operation was successful, **mconv\_encode\_buffer()** returns the number of written bytes. Otherwise it returns -1 and assigns an error code to the external variable **merror\_code**. \

## ERRORS

`MERROR_IO`, `MERROR_CODING`

## SEE ALSO

**mconv\_encode()**, **mconv\_encode\_stream()**\

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.
