isalpha(3) Library Functions Manual isalpha(3) NAZWA isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace, isupper, isxdigit, isalnum_l, isalpha_l, isascii_l, isblank_l, iscntrl_l, isdigit_l, isgraph_l, islower_l, isprint_l, ispunct_l, isspace_l, isupper_l, isxdigit_l - funkcje klasyfikujace znaki BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include int isalnum(int c); int isalpha(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); int isascii(int c); int isblank(int c); int isalnum_l(int c, locale_t locale); int isalpha_l(int c, locale_t locale); int isblank_l(int c, locale_t locale); int iscntrl_l(int c, locale_t locale); int isdigit_l(int c, locale_t locale); int isgraph_l(int c, locale_t locale); int islower_l(int c, locale_t locale); int isprint_l(int c, locale_t locale); int ispunct_l(int c, locale_t locale); int isspace_l(int c, locale_t locale); int isupper_l(int c, locale_t locale); int isxdigit_l(int c, locale_t locale); int isascii_l(int c, locale_t locale); Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)): isascii(): _XOPEN_SOURCE || /* glibc >= 2.19: */ _DEFAULT_SOURCE || /* glibc <= 2.19: */ _SVID_SOURCE isblank(): _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L salnum_l(), salpha_l(), sblank_l(), scntrl_l(), sdigit_l(), sgraph_l(), slower_l(), sprint_l(), spunct_l(), sspace_l(), supper_l(), sxdigit_l(): Od glibc 2.10: _XOPEN_SOURCE >= 700 Przed glibc 2.10: _GNU_SOURCE isascii_l(): Od glibc 2.10: _XOPEN_SOURCE >= 700 && (_SVID_SOURCE || _BSD_SOURCE) Przed glibc 2.10: _GNU_SOURCE OPIS Funkcje te sprawdzaja, czy c, ktore jest zmienna typu unsigned char lub wartoscia EOF, nalezy do pewnej klasy znakow okreslonej przez okreslone ustawienia regionalne (locale). Funkcje bez przyrostka "_l" przeprowadzaja sprawdzenie w oparciu o biezace locale. Funkcje z przyrostkiem "_l" przeprowadzaja sprawdzenie w oparciu o ustawienia regionalne okreslone przez obiekt locale locale. Ich zachowanie jest niezdefiniowane, jesli locale nie jest specjalnym obiektem locale LC_GLOBAL_LOCALE (zob. duplocale(3)) albo nie jest prawidlowym uchwytem obiektu locale. Ponizsza lista wyjasnia dzialanie funkcji bez przyrostka "_l". Funkcje z przyrostkiem "_l" roznia sie wylacznie tym, ze uzywaja obiekt locale locale, zamiast ustawien biezacych. isalnum() sprawdza, czy znak jest alfanumeryczny; jest to rownowazne (isalpha(c) || isdigit(c)). isalpha() sprawdza, czy znak jest alfabetyczny; w standardowych ustawieniach regionalnych "C" jest to rownowazne (isupper(c) || islower(c)). W niektorych ustawieniach jezykowych do klasy tej moga nalezec dodatkowe znaki, dla ktorych isalpha() jest prawdziwe -- litery, ktore nie sa ani wielkie, ani male. isascii() sprawdza, czy c jest 7-bitowa zmienna unsigned char, ktora nalezy do zbioru znakow ASCII. isblank() sprawdza, czy znak jest pusty, czyli czy jest to spacja lub tabulacja. iscntrl() sprawdza, czy znak jest znakiem sterujacym. isdigit() sprawdza, czy jest to cyfra (0 do 9). isgraph() sprawdza, czy jest to jakikolwiek znak drukowalny oprocz spacji. islower() sprawdza, czy znak jest mala litera. isprint() sprawdza, czy znak jest drukowalny (lacznie ze spacja). ispunct() sprawdza, czy znak jest drukowalny i nie jest spacja lub znakiem alfanumerycznym. isspace() checks for white-space characters. In the "C" and "POSIX" locales, these are: space, form-feed ('\f'), newline ('\n'), carriage return ('\r'), horizontal tab ('\t'), and vertical tab ('\v'). isupper() sprawdza, czy znak jest wielka litera. isxdigit() sprawdza, czy znak jest cyfra szesnastkowa, czyli czy jest jednym z 0 1 2 3 4 5 6 7 8 9 0 a b c d e f A B C D E F. WARTOSC ZWRACANA Zwracana jest wartosc niezerowa, jesli znak c nalezy do sprawdzanej klasy, a zero jesli nie nalezy. ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +---------------------------+--------------------------+---------------+ |Interfejs | Atrybut | Wartosc | +---------------------------+--------------------------+---------------+ |isalnum(), isalpha(), | Bezpieczenstwo watkowe | MT-bezpieczne | |isascii(), isblank(), | | | |iscntrl(), isdigit(), | | | |isgraph(), islower(), | | | |isprint(), ispunct(), | | | |isspace(), isupper(), | | | |isxdigit() | | | +---------------------------+--------------------------+---------------+ STANDARDY isalnum() isalpha() iscntrl() isdigit() isgraph() islower() isprint() ispunct() isspace() isupper() isxdigit() isblank() C11, POSIX.1-2008. isascii() isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() POSIX.1-2008. isascii_l() GNU. HISTORIA isalnum() isalpha() iscntrl() isdigit() isgraph() islower() isprint() ispunct() isspace() isupper() isxdigit() C89, POSIX.1-2001. isblank() C99, POSIX.1-2001. isascii() POSIX.1-2001 (XSI). POSIX.1-2008 oznacza ja jako przestarzala, zauwazajac, ze nie moze byc uzywana w sposob przenosny w aplikacji obslugujacej ustawienia regionalne. isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() glibc 2.3. POSIX.1-2008. isascii_l() glibc 2.3. ZASTRZEZENIA Standard wymaga, aby argumentem c tych funkcji bylo albo EOF, albo wartosc reprezentowalna w typie unsigned char, w innym przypadku zachowanie jest niezdefiniowane. Jesli argument c ma typ char, musi rzutowac na unsigned char, jak w ponizszym przykladzie: char c; ... res = toupper((unsigned char) c); Jest to konieczne, poniewaz char moze byc odpowiednikiem signed char; w takim przypadku bajt, w ktorym gorny bit jest ustawiony, przy konwersji do int, mialby swoj znak rozszerzony, co daloby wartosc poza zakresem unsigned char. Szczegoly tego, ktore znaki naleza do ktorej klasy, zaleza od ustawien regionalnych (locale). Np. isupper() nie rozpozna A-umlaut (A) jako wielkiej litery w domyslnym ustawieniu regionalnym "C". ZOBACZ TAKZE iswalnum(3), iswalpha(3), iswblank(3), iswcntrl(3), iswdigit(3), iswgraph(3), iswlower(3), iswprint(3), iswpunct(3), iswspace(3), iswupper(3), iswxdigit(3), newlocale(3), setlocale(3), toascii(3), tolower(3), toupper(3), uselocale(3), ascii(7), locale(7) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: Przemek Borys , Andrzej Krzysztofowicz , Robert Luberda i Michal Kulach Niniejsze tlumaczenie jest wolna dokumentacja. Blizsze informacje o warunkach licencji mozna uzyskac zapoznajac sie z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje sie ZADNEJ ODPOWIEDZIALNOSCI. Bledy w tlumaczeniu strony podrecznika prosimy zglaszac na adres listy dyskusyjnej . Linux man-pages 6.9.1 15 czerwca 2024 r. isalpha(3)