PDFlib Text Extraction Toolkit (TET) Manual

utf8_to_utf16( ), or TET_utf32_to_utf16( ) or until an exception is thrown. Clients must
copy the string if they need it longer.
Bindings
This function is not available in Unicode-capable language bindings. The memory used
for the converted string will be managed by TET, and must not be freed by the client.
C++
Perl PHP
C
string utf16_to_utf8(string utf16string)
string TET_utf16_to_utf8(resource tet, string utf16string)
const char *TET_utf16_to_utf8(TET *tet, const char *utf16string, int len, int *size)
Convert a string from UTF-16 format to UTF-8.
utf16string The string to be converted. A Byte Order Mark (BOM) in the string will be
interpreted. If it is missing the platform’s native byte ordering is assumed.
len
(C language binding only) Length of utf16string in bytes.
size (C language binding only) C-style pointer to a memory location where the length
of the returned string (in bytes) will be stored. If the pointer is NULL it will be ignored.
Returns
Bindings
The converted UTF-8 string. The generated UTF-8 string will start with the UTF-8 BOM
(\xEF\xBB\xBF). On EBCDIC platforms the conversion result including the BOM will finally
be converted to EBCDIC. The returned string is valid until the next call to any function
other than TET_utf16_to_utf8( ), TET_utf8_to_utf16( ), or TET_utf32_to_utf16( ) or until
an exception is thrown. Clients must copy the string if they need it longer.
This function is not available in Unicode-capable language bindings.
C++
Perl PHP
C
string utf32_to_utf16(string utf32string, string ordering)
string TET_utf32_to_utf16(resource p, string utf32string, string ordering)
const char *TET_utf32_to_utf16(TET *tet, const char *utf32string, int len, const char *ordering, int
*size)
Convert a string from UTF-32 format to UTF-16.
utf32string The string to be converted, which must contain a valid UTF-32 sequence. If
a Byte Order Mark (BOM) is present, it will be interpreted
len
(C language binding only) Length of utf32string in bytes.
ordering Specifies the byte ordering of the result string:
> utf16 or an empty string: the converted string will not have any BOM, and will be
stored in the platform’s native byte order.
> utf16le: the converted string will be formatted in little endian format, and will be prefixed
with the little-endian BOM (\xFF\xFE).
> utf16be: the converted string will be formatted in big endian format, and will be prefixed
with the big-endian BOM (\xFE\xFF).
size (C language binding only) C-style pointer to a memory location where the length
of the returned string (in bytes) will be stored.
124 Chapter 10: TET Library API Reference