Export (0) Print
Expand All
Expand Minimize

_mbsinc, _strinc, _wcsinc

Advance a string pointer by one character.

unsigned char *_mbsinc(
   const unsigned char *current 
);

Parameter

current
Character pointer.

Return Value

Each of these routines returns a pointer to the character that immediately follows current.

Remarks

The _mbsinc function returns a pointer to the first byte of the multibyte character that immediately follows current. _mbsinc recognizes multibyte-character sequences according to the multibyte code page currently in use.

The generic-text function _tcsinc, defined in TCHAR.H, maps to _mbsinc if _MBCS has been defined, or to _wcsinc if _UNICODE has been defined. Otherwise _tcsinc maps to _strinc. _strinc and _wcsinc are single-byte character and wide-character versions of _mbsinc. _strinc and _wcsinc are provided only for this mapping and should not be used otherwise. For more information, see Using Generic-Text Mappings and Generic-Text Mappings.

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.

Requirements

Routine Required header Compatibility
_mbsinc <mbstring.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_strinc <tchar.h> Win 98, Win Me, Win NT, Win 2000, Win XP
_wcsinc <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 | _mbsnextc | _mbsninc | Run-Time Routines and .NET Framework Equivalents

Show:
© 2014 Microsoft