NWLmblen(3nw)

NWLmblen -- returns length of multibyte character

Synopsis

   #include <time.h> or #define NWL_EXCLUDE_TIME 
   #include <stdio.h> or #define NWL_EXCLUDE_FILE 
   #include <nwlocale.h> 
    
   N_EXTERN_LIBRARY (nint) NWLmblen 
     (const nstr N_FAR   string, 
      size_t              count);

Description

The parameters are as follows:

string: (IN) Points to the string containing a character to evaluate.
count: (IN) Specifies the maximum number of bytes to evaluate.

Return values

If string is not NULL, NWLmblen returns the length (in bytes) of the multibyte character.

If string is NULL, NWLmblen returns zero.

If the string does not form a valid multibyte character within the first count characters, NWLmblen returns -1.

Notices

NWLmblen can be used to count the number of characters in a string.

Services

Internationalization

NCP calls

None

References

NWLsetlocale(3nw)