ИМЯ

       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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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