_mbsnextc, _strnextc, _wcsnextc
unsignedint_mbsnextc(constunsignedchar*string);
| Routine | Required Header | Compatibility |
| _mbsnextc | <mbstring.h> | Win 95, Win NT |
| _strnextc | <tchar.h> | Win 95, Win NT |
| _wcsnextc | <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 functions returns the integer value of the next character in string.
Parameter
string
Source 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.
The generic-text function _tcsnextc, defined in TCHAR.H, maps to _mbsnextc if _MBCS has been defined, or to _wcsnextc if _UNICODE has been defined. Otherwise _tcsnextc maps to _strnextc. _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 Appendix B, Generic-Text Mappings.