.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright (c) Bruno Haible <haible@clisp.cons.org>
.\"
.\" SPDX-License-Identifier: GPL-2.0-or-later
.\"
.\" 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 btowc 3 "20 июля 2023 г." "Linux man\-pages 6.05.01" 
.SH ИМЯ
btowc \- преобразует один байт в широкий символ
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <wchar.h>\fP
.PP
\fBwint_t btowc(int \fP\fIc\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Функция \fBbtowc\fP() преобразует аргумент \fIc\fP, который считает многобайтовой
последовательностью с длиной 1 и находящийся в начальном состоянии сдвига, в
широкий символ, и возвращает его. Если значение \fIc\fP равно \fBEOF\fP или не
содержит правильной многобайтовой последовательности длиной 1, то \fBbtowc\fP()
возвращает \fBWEOF\fP.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBbtowc\fP() возвращает широкий символ, преобразованный из \fIc\fP. Если
значение \fIc\fP равно \fBEOF\fP или содержит некорректную многобайтовую
последовательность длиной 1, то возвращается \fBWEOF\fP.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBbtowc\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.sp 1
.SH СТАНДАРТЫ
C11, POSIX.1\-2008.
.SH ИСТОРИЯ
C99, POSIX.1\-2001.
.SH ЗАМЕЧАНИЯ
Поведение \fBbtowc\fP() зависит от категории \fBLC_CTYPE\fP текущий локали.
.PP
Эту функцию не стоит использовать. Она не работает с кодировками, имеющими
состояние, и абсолютно бесполезна для трактовки байтов, отличных от
многобайтовых последовательностей. Вместо неё используйте функцию
\fBmbtowc\fP(3) или нитебезопасную \fBmbrtowc\fP(3).
.SH "СМ. ТАКЖЕ"
\fBmbrtowc\fP(3), \fBmbtowc\fP(3), \fBwctob\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
Artyom Kunyov <artkun@guitarplayer.ru>,
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitriy Ovchinnikov <dmitriyxt5@gmail.com>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
ITriskTI <ITriskTI@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>
и
Иван Павлов <pavia00@gmail.com>
.
.PP
Этот перевод является бесплатной документацией; прочитайте
.UR https://www.gnu.org/licenses/gpl-3.0.html
Стандартную общественную лицензию GNU версии 3
.UE
или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
.PP
Если вы обнаружите ошибки в переводе этой страницы руководства,
пожалуйста, отправьте электронное письмо на
.MT man-pages-ru-talks@lists.sourceforge.net
.ME .