_mbsninc, _strninc, _wcsninc

Visual Studio 6.0

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.


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.



Source string


Number of characters to increment string pointer


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.

String Manipulation Routines

See Also   _mbsdec, _mbsinc, _mbsnextc