isleadbyte, _isleadbyte_l
Collapse the table of content
Expand the table of content
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

isleadbyte, _isleadbyte_l

Determine if a character is the lead byte of a multibyte character.

int isleadbyte(
   int c 
int _isleadbyte_l(
   int c 


Integer to test.

isleadbyte returns a nonzero value if the argument satisfies the test condition or 0 if it does not. In the "C" locale and in single-byte character set (SBCS) locales, isleadbyte always returns 0.

The isleadbyte macro returns a nonzero value if its argument is the first byte of a multibyte character. isleadbyte produces a meaningful result for any integer argument from –1 (EOF) to UCHAR_MAX (0xFF), inclusive.

The expected argument type of isleadbyte is int; if a signed character is passed, the compiler may convert it to an integer by sign extension, yielding unpredictable results.

The version of this function with the _l suffix is identical except that it uses the locale passed in instead of the current locale for its locale-dependent behavior.

Generic-Text Routine Mappings

TCHAR.H routine

_UNICODE & _MBCS not defined

_MBCS defined

_UNICODE defined


Always returns false


Always returns false


Required header





For additional compatibility information, see Compatibility in the Introduction.

© 2015 Microsoft