ctype.h File Reference

#include <corecrt.h>
#include <corecrt_wctype.h>

Include dependency graph for ctype.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	_INC_CTYPE
#define	MB_CUR_MAX   ___mb_cur_max_func()
#define	__mb_cur_max   (___mb_cur_max_func())
#define	__chvalidchk(a, b)   (__acrt_locale_get_ctype_array_value(__PCTYPE_FUNC, (a), (b)))
#define	__ascii_isalpha(c)   ( __chvalidchk(c, _ALPHA))
#define	__ascii_isdigit(c)   ( __chvalidchk(c, _DIGIT))
#define	__ascii_isalpha_l(c, locale)   (_chvalidchk_l(c, _ALPHA, locale))
#define	__ascii_isdigit_l(c, locale)   (_chvalidchk_l(c, _DIGIT, locale))
#define	_isalpha_l(c, locale)   _ischartype_l(c, _ALPHA, locale)
#define	_isupper_l(c, locale)   _ischartype_l(c, _UPPER, locale)
#define	_islower_l(c, locale)   _ischartype_l(c, _LOWER, locale)
#define	_isdigit_l(c, locale)   _ischartype_l(c, _DIGIT, locale)
#define	_isxdigit_l(c, locale)   _ischartype_l(c, _HEX, locale)
#define	_isspace_l(c, locale)   _ischartype_l(c, _SPACE, locale)
#define	_ispunct_l(c, locale)   _ischartype_l(c, _PUNCT, locale)
#define	_isblank_l(c, locale)   (((c) == '\t') ? _BLANK : _ischartype_l(c, _BLANK, locale))
#define	_isalnum_l(c, locale)   _ischartype_l(c, _ALPHA | _DIGIT, locale)
#define	_isprint_l(c, locale)   _ischartype_l(c, _BLANK | _PUNCT | _ALPHA | _DIGIT, locale)
#define	_isgraph_l(c, locale)   _ischartype_l(c, _PUNCT | _ALPHA | _DIGIT, locale)
#define	_iscntrl_l(c, locale)   _ischartype_l(c, _CONTROL, locale)
#define	_tolower(c)   ((c) - 'A' + 'a')
#define	_toupper(c)   ((c) - 'a' + 'A')
#define	__isascii(c)   ((unsigned)(c) < 0x80)
#define	__toascii(c)   ((c) & 0x7f)
#define	__iscsymf(c)   (isalpha(c) || ((c) == '_'))
#define	__iscsym(c)   (isalnum(c) || ((c) == '_'))
#define	__iswcsymf(c)   (iswalpha(c) || ((c) == '_'))
#define	__iswcsym(c)   (iswalnum(c) || ((c) == '_'))
#define	_iscsymf_l(c, p)   (_isalpha_l(c, p) || ((c) == '_'))
#define	_iscsym_l(c, p)   (_isalnum_l(c, p) || ((c) == '_'))
#define	_iswcsymf_l(c, p)   (iswalpha(c) || ((c) == '_'))
#define	_iswcsym_l(c, p)   (iswalnum(c) || ((c) == '_'))

Functions
_UCRT_DISABLE_CLANG_WARNINGS _CRT_BEGIN_C_HEADER _Check_return_ _ACRTIMP int __cdecl	_isctype (_In_ int _C, _In_ int _Type)
_Check_return_ _ACRTIMP int __cdecl	_isctype_l (_In_ int _C, _In_ int _Type, _In_opt_ _locale_t _Locale)
_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl	isalpha (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isalpha_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl	isupper (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isupper_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl	islower (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_islower_l (_In_ int _C, _In_opt_ _locale_t _Locale)
	_When_ (_Param_(1)==0, _Post_equal_to_(0)) _Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl isdigit(_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isdigit_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	isxdigit (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isxdigit_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	_isspace_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	ispunct (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_ispunct_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	isblank (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isblank_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl	isalnum (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isalnum_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	isprint (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isprint_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	isgraph (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_isgraph_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	iscntrl (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_iscntrl_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl	_tolower (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_tolower_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl	_toupper (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	_toupper_l (_In_ int _C, _In_opt_ _locale_t _Locale)
_Check_return_ _ACRTIMP int __cdecl	__isascii (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	__toascii (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	__iscsymf (_In_ int _C)
_Check_return_ _ACRTIMP int __cdecl	__iscsym (_In_ int _C)
__inline int __CRTDECL	__acrt_locale_get_ctype_array_value (_In_reads_(_Char_value+1) unsigned short const *const _Locale_pctype_array, _In_range_(-1, 255) int const _Char_value, _In_ int const _Mask)
	_Post_satisfies_ (return > 0 &&return< 5) _ACRTIMP int __cdecl ___mb_cur_max_func(void)
__forceinline int __CRTDECL	__ascii_tolower (int const _C)
__forceinline int __CRTDECL	__ascii_toupper (int const _C)
__forceinline int __CRTDECL	__ascii_iswalpha (int const _C)
__forceinline int __CRTDECL	__ascii_iswdigit (int const _C)
__forceinline int __CRTDECL	__ascii_towlower (int const _C)
__forceinline int __CRTDECL	__ascii_towupper (int const _C)
__inline __crt_locale_data_public *__CRTDECL	__acrt_get_locale_data_prefix (void const volatile *const _LocalePointers)
__inline int __CRTDECL	_chvalidchk_l (_In_ int const _C, _In_ int const _Mask, _In_opt_ _locale_t const _Locale)
__inline int __CRTDECL	_ischartype_l (_In_ int const _C, _In_ int const _Mask, _In_opt_ _locale_t const _Locale)

Macro Definition Documentation

__ascii_isalpha

#define __ascii_isalpha

(

c

)

( __chvalidchk(c, _ALPHA))

Definition at line 141 of file ctype.h.

__ascii_isalpha_l

#define __ascii_isalpha_l	(		c,
			locale
	)		(_chvalidchk_l(c, _ALPHA, locale))

Definition at line 236 of file ctype.h.

__ascii_isdigit

#define __ascii_isdigit

(

c

)

( __chvalidchk(c, _DIGIT))

Definition at line 142 of file ctype.h.

__ascii_isdigit_l

#define __ascii_isdigit_l	(		c,
			locale
	)		(_chvalidchk_l(c, _DIGIT, locale))

Definition at line 237 of file ctype.h.

__chvalidchk

#define __chvalidchk	(		a,
			b
	)		(__acrt_locale_get_ctype_array_value(__PCTYPE_FUNC, (a), (b)))

Definition at line 136 of file ctype.h.

__isascii

#define __isascii

(

c

)

((unsigned)(c) < 0x80)

Definition at line 279 of file ctype.h.

__iscsym

#define __iscsym

(

c

)

(isalnum(c) || ((c) == '_'))

Definition at line 285 of file ctype.h.

__iscsymf

#define __iscsymf

(

c

)

(isalpha(c) || ((c) == '_'))

Definition at line 284 of file ctype.h.

__iswcsym

#define __iswcsym

(

c

)

(iswalnum(c) || ((c) == '_'))

Definition at line 287 of file ctype.h.

__iswcsymf

#define __iswcsymf

(

c

)

(iswalpha(c) || ((c) == '_'))

Definition at line 286 of file ctype.h.

__mb_cur_max

#define __mb_cur_max   (___mb_cur_max_func())

Definition at line 118 of file ctype.h.

__toascii

#define __toascii

(

c

)

((c) & 0x7f)

Definition at line 280 of file ctype.h.

_INC_CTYPE

#define _INC_CTYPE

Definition at line 10 of file ctype.h.

_isalnum_l

#define _isalnum_l	(		c,
			locale
	)		_ischartype_l(c, _ALPHA | _DIGIT, locale)

Definition at line 271 of file ctype.h.

_isalpha_l

#define _isalpha_l	(		c,
			locale
	)		_ischartype_l(c, _ALPHA, locale)

Definition at line 263 of file ctype.h.

_isblank_l

#define _isblank_l	(		c,
			locale
	)		(((c) == '\t') ? _BLANK : _ischartype_l(c, _BLANK, locale))

Definition at line 270 of file ctype.h.

_iscntrl_l

#define _iscntrl_l	(		c,
			locale
	)		_ischartype_l(c, _CONTROL, locale)

Definition at line 274 of file ctype.h.

_iscsym_l

#define _iscsym_l	(		c,
			p
	)		(_isalnum_l(c, p) || ((c) == '_'))

Definition at line 290 of file ctype.h.

_iscsymf_l

#define _iscsymf_l	(		c,
			p
	)		(_isalpha_l(c, p) || ((c) == '_'))

Definition at line 289 of file ctype.h.

_isdigit_l

#define _isdigit_l	(		c,
			locale
	)		_ischartype_l(c, _DIGIT, locale)

Definition at line 266 of file ctype.h.

_isgraph_l

#define _isgraph_l	(		c,
			locale
	)		_ischartype_l(c, _PUNCT | _ALPHA | _DIGIT, locale)

Definition at line 273 of file ctype.h.

_islower_l

#define _islower_l	(		c,
			locale
	)		_ischartype_l(c, _LOWER, locale)

Definition at line 265 of file ctype.h.

_isprint_l

#define _isprint_l	(		c,
			locale
	)		_ischartype_l(c, _BLANK | _PUNCT | _ALPHA | _DIGIT, locale)

Definition at line 272 of file ctype.h.

_ispunct_l

#define _ispunct_l	(		c,
			locale
	)		_ischartype_l(c, _PUNCT, locale)

Definition at line 269 of file ctype.h.

_isspace_l

#define _isspace_l	(		c,
			locale
	)		_ischartype_l(c, _SPACE, locale)

Definition at line 268 of file ctype.h.

_isupper_l

#define _isupper_l	(		c,
			locale
	)		_ischartype_l(c, _UPPER, locale)

Definition at line 264 of file ctype.h.

_iswcsym_l

#define _iswcsym_l	(		c,
			p
	)		(iswalnum(c) || ((c) == '_'))

Definition at line 292 of file ctype.h.

_iswcsymf_l

#define _iswcsymf_l	(		c,
			p
	)		(iswalpha(c) || ((c) == '_'))

Definition at line 291 of file ctype.h.

_isxdigit_l

#define _isxdigit_l	(		c,
			locale
	)		_ischartype_l(c, _HEX, locale)

Definition at line 267 of file ctype.h.

_tolower

#define _tolower

(

c

)

((c) - 'A' + 'a')

Definition at line 276 of file ctype.h.

_toupper

#define _toupper

(

c

)

((c) - 'a' + 'A')

Definition at line 277 of file ctype.h.

MB_CUR_MAX

#define MB_CUR_MAX   ___mb_cur_max_func()

Definition at line 112 of file ctype.h.

Function Documentation

__acrt_get_locale_data_prefix()

__inline __crt_locale_data_public *__CRTDECL __acrt_get_locale_data_prefix

(

void const volatile *const

_LocalePointers

)

Definition at line 208 of file ctype.h.

    {
        _locale_t const _TypedLocalePointers = (_locale_t)_LocalePointers;
        return (__crt_locale_data_public*)_TypedLocalePointers->locinfo;
    }

Referenced by _chvalidchk_l(), and _ischartype_l().

__acrt_locale_get_ctype_array_value()

__inline int __CRTDECL __acrt_locale_get_ctype_array_value	(	_In_reads_(_Char_value+1) unsigned short const *const	_Locale_pctype_array,
		_In_range_(-1, 255) int const	_Char_value,
		_In_ int const	_Mask
	)

Definition at line 85 of file ctype.h.

{
    // The C Standard specifies valid input to a ctype function ranges from -1 to 255.
    // To avoid undefined behavior, we should check this range for all accesses.
    // Note _locale_pctype array does extend to -127 to support accessing
    // _pctype directly with signed chars.
 
    if (_Char_value >= -1 && _Char_value <= 255)
    {
        return _Locale_pctype_array[_Char_value] & _Mask;
    }
 
    return 0;
}

Referenced by _chvalidchk_l().

__ascii_iswalpha()

__forceinline int __CRTDECL __ascii_iswalpha

(

int const

_C

)

Definition at line 170 of file ctype.h.

        {
            return (_C >= 'A' && _C <= 'Z') || (_C >= 'a' && _C <= 'z');
        }

Referenced by get_drive_number_from_path(), is_root_or_empty(), and __crt_strtox::parse_digit().

__ascii_iswdigit()

__forceinline int __CRTDECL __ascii_iswdigit

(

int const

_C

)

Definition at line 175 of file ctype.h.

        {
            return _C >= '0' && _C <= '9';
        }

__ascii_tolower()

__forceinline int __CRTDECL __ascii_tolower

(

int const

_C

)

Definition at line 152 of file ctype.h.

        {
            if (_C >= 'A' && _C <= 'Z')
            {
                return _C - ('A' - 'a');
            }
            return _C;
        }

Referenced by __ascii_memicmp(), __ascii_stricmp(), __ascii_strnicmp(), __ascii_towlower(), and tolower().

__ascii_toupper()

__forceinline int __CRTDECL __ascii_toupper

(

int const

_C

)

Definition at line 161 of file ctype.h.

        {
            if (_C >= 'a' && _C <= 'z')
            {
                return _C - ('a' - 'A');
            }
            return _C;
        }

Referenced by __ascii_towupper(), and toupper().

__ascii_towlower()

__forceinline int __CRTDECL __ascii_towlower

(

int const

_C

)

Definition at line 180 of file ctype.h.

        {
            return __ascii_tolower(_C);
        }

Referenced by __ascii_wcsicmp(), __ascii_wcsnicmp(), _expandlocale(), and get_drive_number_from_path().

__ascii_towupper()

__forceinline int __CRTDECL __ascii_towupper

(

int const

_C

)

Definition at line 185 of file ctype.h.

        {
            return __ascii_toupper(_C);
        }

Referenced by get_drive_number_from_path(), and __crt_strtox::parse_digit().

__isascii()

_Check_return_ _ACRTIMP int __cdecl __isascii

(

_In_ int

_C

)

__iscsym()

_Check_return_ _ACRTIMP int __cdecl __iscsym

(

_In_ int

_C

)

__iscsymf()

_Check_return_ _ACRTIMP int __cdecl __iscsymf

(

_In_ int

_C

)

__toascii()

_Check_return_ _ACRTIMP int __cdecl __toascii

(

_In_ int

_C

)

_chvalidchk_l()

__inline int __CRTDECL _chvalidchk_l	(	_In_ int const	_C,
		_In_ int const	_Mask,
		_In_opt_ _locale_t const	_Locale
	)

Definition at line 218 of file ctype.h.

    {
        #ifdef _DEBUG
        return _chvalidator_l(_Locale, _C, _Mask);
        #else
        if (!_Locale)
        {
            return __chvalidchk(_C, _Mask);
        }
 
        return __acrt_locale_get_ctype_array_value(__acrt_get_locale_data_prefix(_Locale)->_locale_pctype, _C, _Mask);
        #endif
    }

_isalnum_l()

_Check_return_ _ACRTIMP int __cdecl _isalnum_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 193 of file stubs.c.

{
    return  _ischartype_l(c, _ALPHA | _DIGIT, locale);
}

_isalpha_l()

_Check_return_ _ACRTIMP int __cdecl _isalpha_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 205 of file stubs.c.

{
    return _ischartype_l(c, _ALPHA, locale);
}

_isblank_l()

_Check_return_ _ACRTIMP int __cdecl _isblank_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

_ischartype_l()

__inline int __CRTDECL _ischartype_l	(	_In_ int const	_C,
		_In_ int const	_Mask,
		_In_opt_ _locale_t const	_Locale
	)

Definition at line 239 of file ctype.h.

    {
        if (!_Locale)
        {
            return _chvalidchk_l(_C, _Mask, 0);
        }
 
        if (_C >= -1 && _C <= 255)
        {
            return __acrt_get_locale_data_prefix(_Locale)->_locale_pctype[_C] & _Mask;
        }
 
        if (__acrt_get_locale_data_prefix(_Locale)->_locale_mb_cur_max > 1)
        {
            return _isctype_l(_C, _Mask, _Locale);
        }
 
        return 0; // >0xFF and SBCS locale
    }

_iscntrl_l()

_Check_return_ _ACRTIMP int __cdecl _iscntrl_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 217 of file stubs.c.

{
    return _ischartype_l(c, _CONTROL, locale);
}

_isctype()

_UCRT_DISABLE_CLANG_WARNINGS _CRT_BEGIN_C_HEADER _Check_return_ _ACRTIMP int __cdecl _isctype	(	_In_ int	_C,
		_In_ int	_Type
	)

_isctype_l()

_Check_return_ _ACRTIMP int __cdecl _isctype_l	(	_In_ int	_C,
		_In_ int	_Type,
		_In_opt_ _locale_t	_Locale
	)

_isdigit_l()

_Check_return_ _ACRTIMP int __cdecl _isdigit_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 229 of file stubs.c.

{
    return _ischartype_l(c, _DIGIT, locale);
}

_isgraph_l()

_Check_return_ _ACRTIMP int __cdecl _isgraph_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 241 of file stubs.c.

{
    return _ischartype_l(c, _PUNCT | _ALPHA | _DIGIT, locale);
}

_islower_l()

_Check_return_ _ACRTIMP int __cdecl _islower_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 253 of file stubs.c.

{
    return _ischartype_l(c, _LOWER, locale);
}

_isprint_l()

_Check_return_ _ACRTIMP int __cdecl _isprint_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 265 of file stubs.c.

{
    return _ischartype_l(c, _BLANK | _PUNCT | _ALPHA | _DIGIT, locale);
}

_ispunct_l()

_Check_return_ _ACRTIMP int __cdecl _ispunct_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

_isspace_l()

_Check_return_ _ACRTIMP int __cdecl _isspace_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 277 of file stubs.c.

{
    return _ischartype_l(c, _SPACE, locale);
}

_isupper_l()

_Check_return_ _ACRTIMP int __cdecl _isupper_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 289 of file stubs.c.

{
    return _ischartype_l(c, _UPPER, locale);
}

_isxdigit_l()

_Check_return_ _ACRTIMP int __cdecl _isxdigit_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 447 of file stubs.c.

{
    return _ischartype_l(c, _HEX, locale);
}

_Post_satisfies_()

_Post_satisfies_

(

return

= =iColor

)

Globals

iXlate functions

Definition at line 14 of file xlateobj.c.

                         {{0, XO_TRIVIAL, 0, 0, 0, 0}, EXLATEOBJ_iXlateTrivial};

_tolower()

_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl _tolower

(

_In_ int

_C

)

_tolower_l()

_Check_return_ _ACRTIMP int __cdecl _tolower_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 697 of file stubs.c.

{
    UNIMPLEMENTED;
    return 0;
}

Referenced by test__tolower_l().

_toupper()

_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl _toupper

(

_In_ int

_C

)

_toupper_l()

_Check_return_ _ACRTIMP int __cdecl _toupper_l	(	_In_ int	_C,
		_In_opt_ _locale_t	_Locale
	)

Definition at line 709 of file stubs.c.

{
    UNIMPLEMENTED;
    return 0;
}

_When_()

_When_	(	_Param_(1)	= =0,
		_Post_equal_to_(0)
	)

isalnum()

_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl isalnum

(

_In_ int

_C

)

isalpha()

_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl isalpha

(

_In_ int

_C

)

isblank()

_Check_return_ _ACRTIMP int __cdecl isblank

(

_In_ int

_C

)

iscntrl()

_Check_return_ _ACRTIMP int __cdecl iscntrl

(

_In_ int

_C

)

isgraph()

_Check_return_ _ACRTIMP int __cdecl isgraph

(

_In_ int

_C

)

islower()

_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl islower

(

_In_ int

_C

)

isprint()

_Check_return_ _ACRTIMP int __cdecl isprint

(

_In_ int

_C

)

ispunct()

_Check_return_ _ACRTIMP int __cdecl ispunct

(

_In_ int

_C

)

isupper()

_Check_return_ _CRT_JIT_INTRINSIC _ACRTIMP int __cdecl isupper

(

_In_ int

_C

)

isxdigit()

_Check_return_ _ACRTIMP int __cdecl isxdigit

(

_In_ int

_C

)