mtext(3m17n) [debian man page]

mtext(3m17n)							 The m17n Library						      mtext(3m17n)

NAME

       mtext - Allocate a new M-text.

SYNOPSIS

       MText* mtext ()

DESCRIPTION

       Allocate a new M-text. The mtext() function allocates a new M-text of length 0 and returns a pointer to it. The allocated M-text will not
       be freed unless the user explicitly does so with the m17n_object_unref() function.

SEE ALSO

	   m17n_object_unref()

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>.

Version 1.6.2							    12 Jan 2011 						      mtext(3m17n)

mtext_from_data(3m17n)						 The m17n Library					    mtext_from_data(3m17n)

NAME

       mtext_from_data - Allocate a new M-text with specified data.

SYNOPSIS

       MText* mtext_from_data (const void * data, int nitems, enum MTextFormat format)

DESCRIPTION

       Allocate a new M-text with specified data. The mtext_from_data() function allocates a new M-text whose character sequence is specified by
       array data of nitems elements.  format specifies the format of data.

       When format is either MTEXT_FORMAT_US_ASCII or MTEXT_FORMAT_UTF_8, the contents of data must be of the type unsigned char, and nitems
       counts by byte.

       When format is either MTEXT_FORMAT_UTF_16LE or MTEXT_FORMAT_UTF_16BE, the contents of data must be of the type unsigned short, and nitems
       counts by unsigned short.

       When format is either MTEXT_FORMAT_UTF_32LE or MTEXT_FORMAT_UTF_32BE, the contents of data must be of the type unsigned, and nitems counts
       by unsigned.

       The character sequence of the M-text is not modifiable. The contents of data must not be modified while the M-text is alive.

       The allocated M-text will not be freed unless the user explicitly does so with the m17n_object_unref() function. Even in that case, data is
       not freed.

RETURN VALUE

	   If the operation was successful, mtext_from_data() returns a pointer to the allocated M-text. Otherwise it returns NULL and assigns an
	   error code to the external variable merror_code.

ERRORS

	   MERROR_MTEXT

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>.

Version 1.6.2							    12 Jan 2011 					    mtext_from_data(3m17n)