debian man page for mtext_from_data

Query: mtext_from_data

OS: debian

Section: 3m17n

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

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)
Related Man Pages
mconv_buffer_converter(3m17n) - debian
mdraw_image_text(3m17n) - debian
mdraw_per_char_extents(3m17n) - debian
mtext_get_prop_keys(3m17n) - debian
mtext_get_prop_values(3m17n) - debian
Similar Topics in the Unix Linux Community
coverting html data to text in 'c'
copy loses the text format
Editing the timestamp
Sum value in text file