_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
