C character classification is a group of operations in the C standard library that test a character for membership in a particular class of characters; such as alphabetic, control, etc. Both single-byte, and wide characters are supported.[1]
Early C programmers working on the Unix operating system developed programming idioms for classifying characters. For example, the following code evaluates as true for an ASCII letter character c:
Eventually, the interface to common character classification functionality was codified in the C standard library file ctype.h.
For performance, the standard character classification functions are usually implemented as macros instead of functions. But, due to limitations of macro evaluation, they are generally not implemented today as they were in early versions of Linux like:
This can lead to an error when the macro parameter x is expanded to an expression with a side effect; for example: isdigit(x++). If the implementation was a function, then x would be incremented only once. But for this macro definition it is incremented twice.
To eliminate this problem, a common implementation is for the macro to use table lookup. For example, the standard library provides an array of 256 integers one for each character value that each contain a bit-field for each supported classification. A macro references an integer by character value index and accesses the associated bit-field. For example, if the low bit indicates whether the character is a digit, then the isdigit macro could be written as:
The macro argument, c, is referenced only once, so is evaluated only once.
The functions that operate on single-byte characters are defined in ctype.h header file (cctype in C++). The functions that operate on wide characters are defined in wctype.h header file (cwctype in C++).
The classification is evaluated according to the effective locale.
| Byte character | Wide character | Description | |
|---|---|---|---|
[http://en.cppreference.com/w/c/string/byte/isalnum isalnum] | [http://en.cppreference.com/w/c/string/wide/iswalnum iswalnum] | checks whether the operand is alphanumeric | |
[http://en.cppreference.com/w/c/string/byte/isalpha isalpha] | [http://en.cppreference.com/w/c/string/wide/iswalpha iswalpha] | checks whether the operand is alphabetic | |
[http://en.cppreference.com/w/c/string/byte/islower islower] | [http://en.cppreference.com/w/c/string/wide/iswlower iswlower] | checks whether the operand is lowercase | |
[http://en.cppreference.com/w/c/string/byte/isupper isupper] | [http://en.cppreference.com/w/c/string/wide/iswupper iswupper] | checks whether the operand is an uppercase | |
[http://en.cppreference.com/w/c/string/byte/isdigit isdigit] | [http://en.cppreference.com/w/c/string/wide/iswdigit iswdigit] | checks whether the operand is a digit | |
[http://en.cppreference.com/w/c/string/byte/isxdigit isxdigit] | [http://en.cppreference.com/w/c/string/wide/iswxdigit iswxdigit] | checks whether the operand is hexadecimal | |
[http://en.cppreference.com/w/c/string/byte/iscntrl iscntrl] | [http://en.cppreference.com/w/c/string/wide/iswcntrl iswcntrl] | checks whether the operand is a control character | |
[http://en.cppreference.com/w/c/string/byte/isgraph isgraph] | [http://en.cppreference.com/w/c/string/wide/iswgraph iswgraph] | checks whether the operand is a graphical character | |
[http://en.cppreference.com/w/c/string/byte/isspace isspace] | [http://en.cppreference.com/w/c/string/wide/iswspace iswspace] | checks whether the operand is space | |
[http://en.cppreference.com/w/c/string/byte/isblank isblank] | [http://en.cppreference.com/w/c/string/wide/iswblank iswblank] | checks whether the operand is a blank space character | |
[http://en.cppreference.com/w/c/string/byte/isprint isprint] | [http://en.cppreference.com/w/c/string/wide/iswprint iswprint] | checks whether the operand is a printable character | |
[http://en.cppreference.com/w/c/string/byte/ispunct ispunct] | [http://en.cppreference.com/w/c/string/wide/iswpunct iswpunct] | checks whether the operand is punctuation | |
[http://en.cppreference.com/w/c/string/byte/tolower tolower] | [http://en.cppreference.com/w/c/string/wide/towlower towlower] | converts the operand to lowercase | |
[http://en.cppreference.com/w/c/string/byte/toupper toupper] | [http://en.cppreference.com/w/c/string/wide/towupper towupper] | converts the operand to uppercase | |
[http://en.cppreference.com/w/c/string/wide/iswctype iswctype] | checks whether the operand falls into specific class | ||
[http://en.cppreference.com/w/c/string/wide/towctrans towctrans] | converts the operand using a specific mapping | ||
[http://en.cppreference.com/w/c/string/wide/wctype wctype] | returns a wide character class to be used with iswctype | ||
[http://en.cppreference.com/w/c/string/wide/wctrans wctrans] | returns a transformation mapping to be used with towctrans |