isxdigit, iswxdigit, _isxdigit_l, _iswxdigit_l

Determines whether an integer represents a character that is a hexadecimal digit.

Syntax

int isxdigit(
   int c
);
int iswxdigit(
   wint_t c
);
int _isxdigit_l(
   int c,
   _locale_t locale
);
int _iswxdigit_l(
   wint_t c,
   _locale_t locale
);

Parameters

c
Integer to test.

locale
Locale to use.

Return value

Each of these routines returns nonzero if c is a particular representation of a hexadecimal digit. isxdigit returns a nonzero value if c is a hexadecimal digit (A - F, a - f, or 0 - 9). iswxdigit returns a nonzero value if c is a wide character that corresponds to a hexadecimal digit character. Each of these routines returns 0 if c doesn't satisfy the test condition.

For the "C" locale, the iswxdigit function doesn't support Unicode full-width hexadecimal characters.

The versions of these functions that have the _l suffix use the locale that's passed in instead of the current locale for their locale-dependent behavior. For more information, see Locale.

The behavior of isxdigit and _isxdigit_l is undefined if c isn't EOF or in the range 0 through 0xFF, inclusive. When a debug CRT library is used and c isn't one of these values, the functions raise an assertion.

Generic-text routine mappings

TCHAR.H routine _UNICODE and _MBCS not defined _MBCS defined _UNICODE defined
_istxdigit isxdigit isxdigit iswxdigit

Remarks

By default, this function's global state is scoped to the application. To change this behavior, see Global state in the CRT.

Requirements

Routine Required header
isxdigit <ctype.h>
iswxdigit <ctype.h> or <wchar.h>
_isxdigit_l <ctype.h>
_iswxdigit_l <ctype.h> or <wchar.h>

For more compatibility information, see Compatibility.

See also

Character classification
Locale
is, isw routines