_mbsnextc, _strnextc, _wcsnextc
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

_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:
© 2016 Microsoft