isleadbyte, _isleadbyte_l

  • Article

Indicates whether the first byte of the specified character is the lead byte of a multibyte character.

int isleadbyte(
   int c 
);
int _isleadbyte_l(
   int c, 
   _locale_t locale
);

Parameters

  • c
    A character to test. This parameter is expected to be a multibyte character whose type is int.

  • locale
    A locale, instead of the current locale, that governs this operation. For more information, see Locale.

Return Value

A nonzero value if the first byte of the c parameter is the lead byte of a multibyte character; otherwise, zero. The return value is always zero in the "C" locale and in single-byte character set (SBCS) locales.

Remarks

The isleadbyte and _isleadbyte_l functions test the result of casting parameter c to an unsigned char.

Generic-Text Routine Mappings

TCHAR.H routine

_UNICODE & _MBCS not defined

_MBCS defined

_UNICODE defined

_isleadbyte

Always returns false

_isleadbyte

Always returns false

Requirements

Routine

Required header

isleadbyte

<ctype.h>

_isleadbyte_l

<ctype.h>

For additional compatibility information, see Compatibility in the Introduction.

.NET Framework Equivalent

Not applicable, but see System::Globalization::CultureInfo.

See Also

Reference

Locale

Byte Classification

_ismbb Routines

Concepts

Support for Multibyte Character Sets (MBCSs)

Change History

Date

History

Reason

May 2011

Documented the "locale" parameter of _isleadbyte_l.

Information enhancement.