_mbsinc, _strinc, _wcsinc
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

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