.\" -*- coding: UTF-8 -*- .\" and Copyright (C) 2014 Michael Kerrisk .\" .\" %%%LICENSE_START(GPLv2+_DOC_ONEPARA) .\" This is free documentation; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License as .\" published by the Free Software Foundation; either version 2 of .\" the License, or (at your option) any later version. .\" %%%LICENSE_END .\" .\" References consulted: .\" GNU glibc-2 source code and manual .\" Dinkumware C library reference http://www.dinkumware.com/ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH TOWUPPER 3 "15 сентября 2017 г." GNU "Руководство программиста Linux" .SH ИМЯ towupper, towupper_l \- преобразует широкий символ к верхнему регистру .SH СИНТАКСИС .nf \fB#include \fP .PP \fBwint_t towupper(wint_t \fP\fIwc\fP\fB);\fP .PP \fBwint_t towupper_l(wint_t \fP\fIwc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP .fi .PP .RS -4 Требования макроса тестирования свойств для glibc (см. \fBfeature_test_macros\fP(7)): .RE .PP \fBtowupper_l\fP(): .PD 0 .RS 4 .TP Начиная с glibc 2.10: _XOPEN_SOURCE\ >=\ 700 .TP До glibc 2.10: _GNU_SOURCE .RE .PD .SH ОПИСАНИЕ Функция \fBtowupper\fP() является широкосимвольным аналогом функции \fBtoupper\fP(3). Если \fIwc\fP является широким символом в нижнем регистре и в текущей локали существует эквивалент в верхнем регистре, то возвращается эквивалент \fIwc\fP в верхнем регистре. Во всех остальных случаях \fIwc\fP возвращается неизменным. .PP Функция \fBtowupper_l\fP() производит то же действие, но выполняет преобразование на основе информации о типе символа в локали, указанной в \fIlocale\fP. Поведение \fBtowupper_l\fP() не определёно, если значение \fIlocale\fP равно специальному объекту локали \fBLC_GLOBAL_LOCALE\fP (смотрите \fBduplocale\fP(3)) или некорректному описателю объекта локали. .PP Аргумент \fIwc\fP должен быть представим типом \fIwchar_t\fP и быть корректным символом в локали или равняться значению \fBWEOF\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Если \fIwc\fP был преобразован к верхнему регистру, то \fBtowupper\fP() возвращает его эквивалент в верхнем регистре; в противном случае возвращается \fIwc\fP. .SH ВЕРСИИ Функция \fBtowupper_l\fP() впервые появилась в glibc 2.3. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lb lb lb l l l. Интерфейс Атрибут Значение T{ \fBtowupper\fP() T} Безвредность в нитях MT\-Safe locale T{ \fBtowupper_l\fP() T} Безвредность в нитях MT\-Safe .TE .SH "СООТВЕТСТВИЕ СТАНДАРТАМ" \fBtowupper\fP(): C99, POSIX.1\-2001 (XSI); расширение XSI в POSIX.1\-2008, но помечена как устаревшая. .PP \fBtowupper_l\fP(): POSIX.1\-2008. .SH ЗАМЕЧАНИЯ Поведение этих функций зависит от категории \fBLC_CTYPE\fP локали. .PP Эти функции не очень подходят для работы с символами Юникода, так как в Юникоде есть три типа регистра: верхний, нижний и заглавный. .SH "СМ. ТАКЖЕ" \fBiswupper\fP(3), \fBtowctrans\fP(3), \fBtowlower\fP(3), \fBlocale\fP(7) .SH ЗАМЕЧАНИЯ Эта страница является частью проекта Linux \fIman\-pages\fP версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу \%https://www.kernel.org/doc/man\-pages/. .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан Azamat Hackimov , Dmitry Bolkhovskikh , Yuri Kozlov и Иван Павлов . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .