unsigned char *_mbsninc( const unsigned char *string, size_t count );
| Routine | Required Header | Compatibility |
| _mbsninc | <mbstring.h> | Win 95, Win NT |
| _strninc | <tchar.h> | Win 95, Win NT |
| _wcsninc | <tchar.h> | Win 95, Win NT |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
| LIBC.LIB | Single thread static library, retail version |
| LIBCMT.LIB | Multithread static library, retail version |
| MSVCRT.LIB | Import library for MSVCRT.DLL, retail version |
Return Value
Each of these routines returns a pointer to string after string has been incremented by count characters, or NULL if the supplied pointer is NULL. If count is greater than or equal to the number of characters in string, the result is undefined.
Parameters
string
Source string
count
Number of characters to increment string pointer
Remarks
The _mbsninc function increments string by count multibyte characters. _mbsninc recognizes multibyte-character sequences according to the multibyte code page currently in use.
The generic-text function _tcsninc, defined in TCHAR.H, maps to _mbsninc if _MBCS has been defined, or to _wcsninc if _UNICODE has been defined. Otherwise _tcsninc maps to _strninc. _strninc and _wcsninc are single-byte–character string and wide-character string versions of _mbsninc. _wcsninc and _strninc are provided only for this mapping and should not be used otherwise. For more information, see Using Generic-Text Mappings and Appendix B, Generic-Text Mappings.