toupper(3) Library Functions Manual toupper(3) NAZWA toupper, tolower, toupper_l, tolower_l - przeksztalca litere na wielka lub mala BIBLIOTEKA Standardowa biblioteka C (libc, -lc) SKLADNIA #include int toupper(int c); int tolower(int c); int toupper_l(int c, locale_t locale); int tolower_l(int c, locale_t locale); Wymagane ustawienia makr biblioteki glibc (patrz feature_test_macros(7)): toupper_l(), tolower_l(): Od glibc 2.10: _XOPEN_SOURCE >= 700 Przed glibc 2.10: _GNU_SOURCE OPIS Te funkcje przeksztalcaja male litery na wielkie i na odwrot. Jesli c jest mala litera toupper() zwraca jej odpowiednik bedacy wielka litera, jesli tylko istnieje on w biezacych ustawieniach regionalnych (locale). W przeciwnym razie zwraca c. Funkcja toupper_l() sluzy temu samemu celowi, lecz uzywa ustawien regionalnych ustawionych w locale. Jesli c jest wielka litera tolower() zwraca jej odpowiednik bedacy mala litera, jesli tylko istnieje on w biezacych ustawieniach regionalnych (locale). W przeciwnym razie zwraca c. Funkcja tolower_l() sluzy temu samemu celowi, lecz uzywa ustawien regionalnych ustawionych w locale. Jesli c nie ani jest wartoscia unsigned char ani nie ma wartosci EOF, zachowanie tych funkcji jest nieokreslone. Zachowanie toupper_l() i tolower_l() jest niezdefiniowane, jesli locale jest specjalnym obiektem locale LC_GLOBAL_LOCALE (wiecej informacji w duplocale(3)) lub nie jest prawidlowym locale. WARTOSC ZWRACANA Zwracana jest wartosc przeksztalconej litery lub c, gdy przeksztalcenie nie jest mozliwe. ATRYBUTY Informacje o pojeciach uzywanych w tym rozdziale mozna znalezc w podreczniku attributes(7). +---------------------------+--------------------------+---------------+ |Interfejs | Atrybut | Wartosc | +---------------------------+--------------------------+---------------+ |toupper(), tolower(), | Bezpieczenstwo watkowe | MT-bezpieczne | |toupper_l(), tolower_l() | | | +---------------------------+--------------------------+---------------+ STANDARDY toupper() tolower() C11, POSIX.1-2008. toupper_l() tolower_l() POSIX.1-2008. HISTORIA toupper() tolower() C89, 4.3BSD, POSIX.1-2001. toupper_l() tolower_l() POSIX.1-2008. UWAGI Standard wymaga, aby argumentem c tych funkcji bylo albo EOF, albo wartosc reprezentowalna w typie unsigned char. 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 gornym bit jest ustawiony, przy konwersji do int, mialby swoj znak rozszerzony, co daloby wartosc poza zakresem unsigned char. Co dokladnie stanowi wielkie i male litery, zalezy od ustawien regionalnych. Na przyklad domyslne ustawienia regionalne "C" nie znaja umlautow, wiec nie jest wykonywane ich przeksztalcenie. W niektorych nieangielskich ustawieniach regionalnych wystepuja male litery bez odpowiadajacych im liter wielkich; niemieckie ostre s jest jednym z przykladow. ZOBACZ TAKZE isalpha(3), newlocale(3), setlocale(3), towlower(3), towupper(3), uselocale(3), locale(7) TLUMACZENIE Autorami polskiego tlumaczenia niniejszej strony podrecznika sa: 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 2 maja 2024 r. toupper(3)