_ismbblead, _ismbblead_l

Article
12/18/2017

The latest version of this topic can be found at _ismbblead, _ismbblead_l.

Tests a character to determine whether it is a lead byte of a multibyte character.

Syntax

int _ismbblead(  
   unsigned int c   
);  
int _ismbblead_l(  
   unsigned int c,  
   _locale_t locale  
);

Parameters

c
Integer to be tested.

locale
Locale to use.

Return Value

Returns a nonzero value if the integer c is the first byte of a multibyte character.

Remarks

Multibyte characters consist of a lead byte followed by a trailing byte. Lead bytes are distinguished by being in a particular range for a given character set. For example, in code page 932 only, lead bytes range from 0x81 – 0x9F and 0xE0 – 0xFC.

_ismbblead uses the current locale for locale-dependent behavior. _ismbblead_l is identical except that it uses the locale passed in instead. For more information, see Locale.

Generic-Text Routine Mappings

Tchar.h routine	_UNICODE and _MBCS not defined	_MBCS defined	_UNICODE defined
`_istlead`	Always returns false	`_ismbblead`	Always returns false

Requirements

Routine	Required header	Optional header
`_ismbblead`	<mbctype.h> or <mbstring.h>	<ctype.h>,* <limits.h>, <stdlib.h>
`_ismbblead_l`	<mbctype.h> or <mbstring.h>	<ctype.h>,* <limits.h>, <stdlib.h>

* For manifest constants for the test conditions.

For more compatibility information, see Compatibility.

.NET Framework Equivalent

Not applicable. To call the standard C function, use PInvoke. For more information, see Platform Invoke Examples.

Share via