.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA) .\" Copyright (C) 2001-2011 .\" National Institute of Advanced Industrial Science and Technology (AIST) .\" This file is part of the m17n library documentation. .\" Permission is granted to copy, distribute and/or modify this document .\" under the terms of the GNU Free Documentation License, Version 1.2 or .\" any later version published by the Free Software Foundation; with no .\" Invariant Section, no Front-Cover Texts, .\" and no Back-Cover Texts. A copy of the license is included in the .\" appendix entitled "GNU Free Documentation License". .TH "mconv_encode_buffer" 3m17n "Mon Sep 25 2023" "Version 1.8.4" "The m17n Library" \" -*- nroff -*- .ad l .nh .SH NAME mconv_encode_buffer \- .SH SYNOPSIS int \fBmconv_encode_buffer\fP (MSymbol \fIname\fP, \fBMText\fP * \fImt\fP, unsigned char * \fIbuf\fP, int \fIn\fP) .SH DESCRIPTION .PP Encode an M\-text into a buffer area\&. The .ft B mconv_encode_buffer() .ft R function encodes M\-text .ft B mt .ft R based on coding system .ft B name .ft R and writes the resulting byte sequence into the buffer area pointed to by .ft B buf\fP\&. At most .ft B n .ft R bytes are written\&. A temporary code converter for encoding is automatically created and freed\&. .PP .SH RETURN VALUE .PP .RS 4 If the operation was successful, .ft B mconv_encode_buffer() .ft R returns the number of written bytes\&. Otherwise it returns \-1 and assigns an error code to the external variable .ft B merror_code\fP\&. .br .RE .PP .SH ERRORS .PP .RS 4 \fCMERROR_IO\fP, .ft R .ft C MERROR_CODING .ft R .RE .PP .SH "SEE ALSO" .PP .RS 4 \fBmconv_encode()\fP, .ft R .ft B mconv_encode_stream() .ft R .br .RE .PP .SH COPYRIGHT Copyright (C) 2001 Information\-technology Promotion Agency (IPA) .br Copyright (C) 2001\-2011 National Institute of Advanced Industrial Science and Technology (AIST) .br Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License .