PDFlib Text Extraction Toolkit (TET) Manual

10.2 General Functions
Perl PHP resource TET_new( )
C TET *TET_new(void)
Create a new TET object.
Returns
Bindings
A handle to a TET object to be used in subsequent calls. If this function doesn’t succeed
due to unavailable memory it will return NULL.
This function is not available in object-oriented language bindings since it is hidden in
the TET constructor.
Java void delete( )
C# void Dispose( )
Perl PHP resource TET_delete(resource tet)
C void TET_delete(TET *tet)
Delete a TET object and release all related internal resources.
Details
Bindings
Deleting a TET object automatically closes all of its open documents. The TET object
must no longer be used in any function after it has been deleted.
In object-oriented language bindings this function is generally not required since it is
hidden in the TET destructor. However, in Java it is available nevertheless to allow explicit
cleanup in addition to automatic garbage collection. In .NET Dispose( ) should be
called at the end of processing to clean up unmanaged resources.
C++
Perl PHP
C
string utf8_to_utf16(string utf8string, string ordering)
string TET_utf8_to_utf16(resource tet, string utf8string, string ordering)
const char *TET_utf8_to_utf16(TET *tet, const char *utf8string, const char *ordering, int *size)
Convert a string from UTF-8 format to UTF-16.
utf8string String to be converted. It must contain a valid UTF-8 sequence (on EBCDIC
platforms it must be encoded in EBCDIC). If a Byte Order Mark (BOM) is present, it will
be removed.
ordering Specifies the byte ordering of the result string:
> utf16 or an empty string: The converted string will not have a 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 LE BOM (\xFF\xFE).
> utf16be: The converted string will be formatted in big endian format, and will be prefixed
with the BE BOM (\xFE\xFF).
size (C language binding only) Pointer to a memory location where the length of the
returned string (in bytes, but excluding the terminating two null bytes) will be stored.
Returns
The converted UTF-16 string. In C it will be terminated by two null bytes. The returned
string is valid until the next call to any function other than TET_utf16_to_utf8( ), TET_
10.2 General Functions 123