Export (0) Print
Expand All
div
eof
Expand Minimize

_mbsninc, _mbsninc_l, _strninc, _wcsninc

Advances a string pointer by n characters.

unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count 
);
unsigned char *_mbsninc(
   const unsigned char *str,
   size_t count,
   _locale_t locale
);
char *_strninc(
   const char *str,
   size_t count 
);
wchar_t *_wcsninc(
   const wchar_t *str,
   size_t count 
);

str

Source string.

count

Number of characters to increment a string pointer.

locale

Locale to use.

Each of these routines returns a pointer to str after str 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 str, the result is undefined.

The _mbsninc function increments str by count multibyte characters. _mbsninc recognizes multibyte-character sequences according to the multibyte code page currently in use.

Generic-Text Routine Mappings

Tchar.h routine

_UNICODE and _MBCS not defined

_MBCS defined

_UNICODE defined

_tcsninc

_strninc

_mbsninc

_wcsninc

_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 Generic-Text Mappings.

_mbsninc_l is identical except that it uses the locale parameter passed in instead. For more information, see Locale.

Routine

Required header

_mbsninc

<mbstring.h>

_mbsninc_l

<mbstring.h>

_strninc

<tchar.h>

_wcsninc

<tchar.h>

For more compatibility information, see Compatibility in the Introduction.

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Community Additions

ADD
Show:
© 2014 Microsoft