ИМЯ

       towupper, towupper_l - преобразует широкий символ к верхнему регистру

LIBRARY

       Standard C library (libc, -lc)

СИНТАКСИС

       #include <wctype.h>

       wint_t towupper(wint_t wc);
       wint_t towupper_l(wint_t wc, locale_t locale);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       towupper_l():
           Since glibc 2.10:
               _XOPEN_SOURCE >= 700
           Before glibc 2.10:
               _GNU_SOURCE

ОПИСАНИЕ

       Функция  towupper()  является  широкосимвольным  аналогом  функции  toupper(3).  Если wc является широким
       символом в нижнем регистре и в текущей локали существует эквивалент в верхнем регистре,  то  возвращается
       эквивалент wc в верхнем регистре. Во всех остальных случаях wc возвращается неизменным.

       Функция  towupper_l()  производит то же действие, но выполняет преобразование на основе информации о типе
       символа в локали, указанной в locale.  Поведение towupper_l() не определёно, если значение  locale  равно
       специальному  объекту локали LC_GLOBAL_LOCALE (смотрите duplocale(3)) или некорректному описателю объекта
       локали.

       Аргумент wc должен быть представим типом wchar_t и  быть  корректным  символом  в  локали  или  равняться
       значению WEOF.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

       Если wc был преобразован к верхнему регистру, то towupper() возвращает его эквивалент в верхнем регистре;
       в противном случае возвращается wc.

ВЕРСИИ

       Функция towupper_l() впервые появилась в glibc 2.3.

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌───────────────────────────────────────────────────────────────┬──────────────────────┬────────────────┐
       │ Интерфейс                                                     │ Атрибут              │ Значение       │
       ├───────────────────────────────────────────────────────────────┼──────────────────────┼────────────────┤
       │ towupper()                                                    │ Безвредность в нитях │ MT-Safe locale │
       ├───────────────────────────────────────────────────────────────┼──────────────────────┼────────────────┤
       │ towupper_l()                                                  │ Безвредность в нитях │ MT-Safe        │
       └───────────────────────────────────────────────────────────────┴──────────────────────┴────────────────┘

СТАНДАРТЫ

       towupper(): C99, POSIX.1-2001 (XSI); расширение XSI в POSIX.1-2008, но помечена как устаревшая.

       towupper_l(): POSIX.1-2008.

ЗАМЕЧАНИЯ

       Поведение этих функций зависит от категории LC_CTYPE локали.

       These functions are not very appropriate for dealing with Unicode characters, because Unicode knows about
       three cases: upper, lower, and title case.

СМ. ТАКЖЕ

       iswupper(3), towctrans(3), towlower(3), locale(7)

ПЕРЕВОД

       Русский  перевод этой страницы руководства был сделан Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry
       Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное  письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                           15 декабря 2022 г.                                    towupper(3)