DLI Implementation and Reference Guide - Datalogics

Multibyte Text Work 5.7
Working With DLPDFTEXT Areas
Once created, a DLPDFTEXT area may not be altered. Users may wish to create a new
DLPDFTEXT area containing a portion of the text in a previously created DLPDFTEXT
area to fit text lines to document boundaries, or to accomplish other tasks. Users may
obtain the text from a DLPDFTEXT area and use this as the basis for a new
DLPDFTEXT area, using the dlpdftextstring and dlpdftextlength calls:
dlpdftextstring
void *dlpdftextstring(DLPDFTEXT *)
This call returns the text contained in a DLPDFTEXT area, in UTF-16 format. This
text is in host-endian format (little-endian for Win32 and Intel/Linux platforms, bigendian
elsewhere) and does not include a Unicode byte-order marker. An exception
will be raised if an invalid DLPDFTEXT area is supplied.
dlpdftextlength
ASUns32 dlpdftextlength(DLPDFTEXT *)
This call returns the length of the text in a DLPDFTEXT area, in bytes. The buffer
returned by the dlpdftextstring call will be this length. With the buffer and the
length returned by these two calls, a user may make a new DLPDFTEXT area with a
subset of the returned text, using the dlpdftext call and the appropriate Unicode
encoding ASAtom.