НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Стандартная библиотека языка C (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():
           Начиная с glibc 2.10:
               _XOPEN_SOURCE >= 700
           До 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.

АТРИБУТЫ

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

СТАНДАРТЫ

       towupper()
              C11, POSIX.1-2008 (XSI).

       towupper_l()
              POSIX.1-2008.

ИСТОРИЯ

       towupper()
              C99, POSIX.1-2001 (XSI). Устарело в POSIX.1-2008 (XSI).

       towupper_l()
              POSIX.1-2008.  glibc 2.3.

ПРИМЕЧАНИЯ

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

       Эти  функции  не очень подходят для работы с символами Юникода, так как в Юникоде есть три типа регистра:
       верхний, нижний и заглавный.

СМОТРИТЕ ТАКЖЕ

       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> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот перевод является свободной программной документацией; он распространяется на условиях  общедоступной
       лицензии  GNU  (GNU  General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите  об  этом
       разработчику(ам)   по   его(их)  адресу(ам)  электронной  почты  или  по  адресу  списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                      towupper(3)