Export (0) Print
Expand All
Expand Minimize

_mbsnextc, _strnextc, _wcsnextc

Find the next character in a string.

unsigned int _mbsnextc(
   const unsigned char *string 
);

Parameter

string
Source string.

Return Value

Each of these functions returns the integer value of the next character in string.

Remarks

The _mbsnextc function returns the integer value of the next multibyte-character in string, without advancing the string pointer. _mbsnextc recognizes multibyte-character sequences according to the multibyte code page currently in use.

Security Note    This API incurs a potential threat brought about by a buffer overrun problem. Buffer overrun problems are a frequent method of system attack, resulting in an unwarranted elevation of privilege. For more information, see Avoiding Buffer Overruns.

Generic-Text Routine Mappings

TCHAR.H routine _UNICODE & _MBCS not defined _MBCS defined _UNICODE defined
_tcsnextc _strnextc _mbsnextc _wcsnextc

_strnextc and _wcsnextc are single-byte–character string and wide-character string versions of _mbsnextc. _wcsnextc returns the integer value of the next wide character in string; _strnextc returns the integer value of the next single-byte character in string. _strnextc and _wcsnextc are provided only for this mapping and should not be used otherwise. For more information, see Using Generic-Text Mappings and Generic-Text Mappings.

Requirements

Routine Required header Compatibility
_mbsnextc <mbstring.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_strnextc <tchar.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_wcsnextc <tchar.h> Win 98, Win Me, Win NT, Win 2000, Win XP

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All versions of the C run-time libraries.

See Also

String Manipulation Routines | _mbsdec | _mbsinc | _mbsninc | Run-Time Routines and .NET Framework Equivalents

Show:
© 2014 Microsoft