nextmb

Returns the address of the next multibyte character.

Library:LibC
Classification:Novell
Service:General C Services

Syntax

  #include <stdlib.h> 
   
  char *nextmb (
     const char   *string);
  

Parameters

string

(IN) Points to a character in a multibyte string.

Return Values

If the character pointed at by string is a double-byte character, returns the address of the next single or double-byte character, after the starting point.

Remarks

If the host configuration supports multibyte characters, the nextmb function uses the host table, as recorded by the library at start up, to determine the next multibyte character. On NetWare, this is either the next byte or the one after it, because NetWare supports only double-byte characters.

The returned address can point beyond the end of the string, if the string was malformed.

The nextmb function does not work accurately for strings in codepages other than the host page in force at the time this call is made. If the host locale on the server is modified between calls to this function, the result is entirely unpredictable (and almost certainly inaccurate).

See Also