DLI Implementation and Reference Guide - Datalogics

5.6 DLI Implementation and Reference Guide
obtain a list of these encodings, use the dlpdftextshowencodingnames function
call:
void dlpdftextshowencodingnames(char Concepts and Facilities: Guide to *) the DL Pager Composition System
This function call will write out a file containing a list of valid encoding names and
aliases to the pathname supplied as the input parameter. It will raise an exception if
unable to write this file.
dlpdftext Shortcut Functions
For NULL-terminated Unicode text (the NULL terminator will vary from encoding to
encoding), the following shortcut functions are provided, each using the encoding
listed in parentheses:
• DLPDFTEXT *dlpdftextfromutf8(void *) (utf-8)
• DLPDFTEXT *dlpdftextfromutf16be(void *) (utf-16be)
• DLPDFTEXT *dlpdftextfromutf16he(void *) (utf-16be or utf-16le, by
platform)
• DLPDFTEXT *dlpdftextfromutf16le(void *) (utf-16le)
• DLPDFTEXT *dlpdftextfromutf32be(void *) (utf-32be)
• DLPDFTEXT *dlpdftextfromutf32he(void *) (utf-32be or utf-32le, by
platform)
• DLPDFTEXT *dlpdftextfromutf32le(void *) (utf-32le)
These shortcut functions require the input text to be NULL-terminated, but do not
require a Unicode byte-order marker. An exception will be raised for invalid input, or
if the input text could not be properly converted to the platform-endian Unicode
representation.