_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
