NWIncrement(3nw)

NWIncrement -- increments a multi-byte string pointer by a specified number of characters

Synopsis

   #include <time.h> or #define NWL_EXCLUDE_TIME 
   #include <stdio.h> or #define NWL_EXCLUDE_FILE 
   #include <nwlocale.h> 
    
   char NWFAR NWAPI NWIncrement 
     (char NWFAR   string, 
      size_t        numChars);

Description

The parameters are as follows:

string: (IN) Points to the string to increment.
numChars: (IN) Specifies the number of characters to increment.

Return values

NULL: Less than numChars.
Non-NULL: Pointer to the position of numChars past the starting point of the string.

Notices

NWIncrement counts characters, not bytes.

Services

Internationalization

NCP calls

None

References

NWLsetlocale(3nw), NWNextChar(3nw)