NLS string chars

Function : Character Manipulation

NLS_string_chars - Returns the number of characters in a string.

#include <nls.h>
NLS_STATUS LNPUBLIC NLS_string_chars(

    const BYTE far *pString,
    WORD  NumBytes,
    WORD far *pNumChars,
    NLS_PINFO  pInfo);

Description :

Returns the number of characters in a string, given the string's length in bytes. If a multibyte character set is in use, the number of characters in a string will likely be smaller than the number of bytes in the string.

Parameters : Input : pString - A pointer to a string in which the characters are to be counted.

NumBytes - The number of bytes in a string. If the string is null-terminated, specifying NLS_NULLTERM for this argument will make this operation more efficient.

pNumChars - A pointer to a WORD to receive the character count.

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 - the operation completed successfully.

pNumChars - A pointer to a WORD containing the number of characters in the string.