Skip to content

NLS get

Function : Character Manipulation
NLS_get - Retrieves a character given a pointer to it, and also advances the pointer

#include <nls.h>
NLS_STATUS LNPUBLIC NLS_get(

    BYTE far * far *ppString,
    WORD  Len,
    BYTE far *pCharacter,
    NLS_PINFO  pInfo);
Description :

Given a pointer to a character in a string, this function retrieves the character, advancing the pointer to the next character in the string.

Parameters : Input : ppString - A pointer to a pointer to a character in a string.

Len - The number of characters in the ppString.

pInfo - A pointer to an NLS_INFO struct, which contains all of the tables and attributes of the current character set. The NLS_INFO struct should have been initialized by a previous call to OSGetLMBCSCLS().

Output : (routine) - NLS_SUCCESS NLS_BADPARM - The string, the character, or the NLS_INFO structure specified in the function call was invalid. NLS_ENDOFSTRING - the string was empty.

ppString - A pointer to a pointer to the next character in the string.

pCharacter - The character that was read from the string.

See Also : NLS_INFO OSGetLMBCSCLS