C/isalnum

Deklaracja

#include <ctype.h>

int isalnum(int c);
int isalpha(int c);
int isblank(int c);
int iscntrl(int c);
int isdigit(int c);
int isgraph(int c);
int islower(int c);
int isprint(int c);
int ispunct(int c);
int isspace(int c);
int isupper(int c);
int isxdigit(int c);

Argumenty

c: wartość znaku reprezentowana w jako typ unsigned char lub wartość makra EOF. Z tego powodu, przed przekazaniem funkcji argumentu typu char lub signed char należy go zrzutować na typ unsigned char lub unsigned int.

Opis

Funkcje sprawdzają czy podany znak spełnia jakiś konkretny warunek. Biorąc pod uwagę ustawienia języka i dla różnych znaków w różnych locale'ach mogą zwracać różne wartości.

isalnum: sprawdza czy znak jest liczbą lub literą,
isalpha: sprawdza czy znak jest literą,
isblank: sprawdza czy znak jest znakiem odstępu służącym do oddzielania wyrazów (standardowymi znakami odstępu są spacja i znak tabulacji),
iscntrl: sprawdza czy znak jest znakiem sterującym,
isdigit: sprawdza czy znak jest cyfrą dziesiętna,
isgraph: sprawdza czy znak jest znakiem drukowalnym różnym od spacji,
islower: sprawdza czy znak jest małą literą,
isprint: sprawdza czy znak jest znakiem drukowalnym (włączając w to spację),
ispunct: sprawdza czy znak jest znakiem przestankowym, dla którego ani isspace ani isalnum nie są prawdziwe (standardowo są to wszystkie znaki drukowalne, dla których te funkcje zwracają zero),
isspace: sprawdza czy znak jest tzw. białym znakiem (standardowymi białymi znakami są: spacja, wysunięcie strony '\f', znak przejścia do nowej linii '\n', znak powrotu karetki '\r', tabulacja pozioma '\t' i tabulacja pionowa '\v'),
isupper: sprawdza czy znak jest dużą literą,
isxdigit: sprawdza czy znak jest cyfrą szesnastkową, tj. cyfrą dziesiętną lub literą od 'a' do 'f' niezależnie od wielkości.

Funkcja isblank nie występowała w oryginalnym standardzie ANSI C z 1989 roku (tzw. C89) i została dodana dopiero w nowszym standardzie z 1999 roku (tzw. C99).

Wartość zwracana

Liczba niezerowa gdy podany argument spełnia konkretny warunek, w przeciwnym wypadku - zero.

Przykład użycia

#include <ctype.h>   // funkcje is*
#include <locale.h>  // setlocale
#include <stdio.h>   // printf i scanf
 
void identify_char(unsigned char c)
{
    printf("  Litera lub cyfra:   %s\n", isalnum (c) ? "tak" : "nie");
#if __STDC_VERSION__ >= 199901L
    // w przypadku standardu C99
    printf("  Odstęp:             %s\n", isblank (c) ? "tak" : "nie");
#endif
    printf("  Znak sterujący:     %s\n", iscntrl (c) ? "tak" : "nie");
    printf("  Cyfra dziesiętna:   %s\n", isdigit (c) ? "tak" : "nie");
    printf("  Graficzny:          %s\n", isgraph (c) ? "tak" : "nie");
    printf("  Mała litera:        %s\n", islower (c) ? "tak" : "nie");
    printf("  Drukowalny:         %s\n", isprint (c) ? "tak" : "nie");
    printf("  Przestankowy:       %s\n", ispunct (c) ? "tak" : "nie");
    printf("  Biały znak:         %s\n", isspace (c) ? "tak" : "nie");
    printf("  Wielka litera:      %s\n", isupper (c) ? "tak" : "nie");
    printf("  Cyfra szesnastkowa: %s\n", isxdigit(c) ? "tak" : "nie");
    printf("  Litera:             %s\n", isalpha (c) ? "tak" : "nie");
}
 
int main()
{
    unsigned char c;

    puts("Naciśnij jakiś klawisz.");
    if (scanf("%c", &c) == 1)
    {
        identify_char(c);
        setlocale(LC_ALL, "pl_PL");   // przystosowanie do warunków polskich
        puts("Po zmianie ustawien jezyka:");
        identify_char(c);
    }
    return 0;
}

Zobacz też

tolower, toupper