.\" -*- 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 mbsinit 3 "28 января 2024 г." "Linux man\-pages 6.06" 
.SH ИМЯ
mbsinit \- проверяет начальное состояние сдвига
.SH LIBRARY
Standard C library (\fIlibc\fP, \fI\-lc\fP)
.SH СИНТАКСИС
.nf
\fB#include <wchar.h>\fP
.P
\fBint mbsinit(const mbstate_t *\fP\fIps\fP\fB);\fP
.fi
.SH ОПИСАНИЕ
Character conversion between the multibyte representation and the wide
character representation uses conversion state, of type \fImbstate_t\fP.
Conversion of a string uses a finite\-state machine; when it is interrupted
after the complete conversion of a number of characters, it may need to save
a state for processing the remaining characters.  Such a conversion state is
needed for the sake of encodings such as ISO/IEC\~2022 and UTF\-7.
.P
Начальное состояние  — это состояние в начале преобразования строки. Есть
два типа состояния: первое используется функциями преобразования
многобайтовых символов в широкие (\fBmbsrtowcs\fP(3)); второе используется
функциями преобразования широких символов в многобайтовые
(\fBwcsrtombs\fP(3)). Для начального состояния обоих типов используется тип
\fImbstate_t\fP.
.P
For 8\-bit encodings, all states are equivalent to the initial state.  For
multibyte encodings like UTF\-8, EUC\-*, BIG5, or SJIS, the wide character to
multibyte conversion functions never produce non\-initial states, but the
multibyte to wide\-character conversion functions like \fBmbrtowc\fP(3)  do
produce non\-initial states when interrupted in the middle of a character.
.P
Одним из способов создания \fImbstate_t\fP в начальном состоянии является
присвоение нулевого значения:
.P
.in +4n
.EX
mbstate_t state;
memset(&state, 0, sizeof(state));
.EE
.in
.P
В Linux также работает и следующее, но может привести к появлению
предупреждения компилятора:
.P
.in +4n
.EX
mbstate_t state = { 0 };
.EE
.in
.P
Функция \fBmbsinit\fP() проверяет \fI*ps\fP на соответствие начальному состоянию.
.SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ"
Функция \fBmbsinit\fP() возвращает ненулевое значение, если \fI*ps\fP находится в
начальном состоянии, или если \fIps\fP равно NULL. В противном случае
возвращается 0.
.SH АТРИБУТЫ
Описание терминов данного раздела смотрите в \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
Интерфейс	Атрибут	Значение
T{
.na
.nh
\fBmbsinit\fP()
T}	Безвредность в нитях	MT\-Safe
.TE
.SH СТАНДАРТЫ
C11, POSIX.1\-2008.
.SH ИСТОРИЯ
POSIX.1\-2001, C99.
.SH ЗАМЕЧАНИЯ
Поведение \fBmbsinit\fP() зависит от категории \fBLC_CTYPE\fP текущей локали.
.SH "СМ. ТАКЖЕ"
\fBmbrlen\fP(3), \fBmbrtowc\fP(3), \fBmbsrtowcs\fP(3), \fBwcrtomb\fP(3), \fBwcsrtombs\fP(3)
.PP
.SH ПЕРЕВОД
Русский перевод этой страницы руководства был сделан
aereiae <aereiae@gmail.com>,
Alexey <a.chepugov@gmail.com>,
Azamat Hackimov <azamat.hackimov@gmail.com>,
Dmitriy S. Seregin <dseregin@59.ru>,
Dmitry Bolkhovskikh <d20052005@yandex.ru>,
ITriskTI <ITriskTI@gmail.com>,
Max Is <ismax799@gmail.com>,
Yuri Kozlov <yuray@komyakino.ru>,
Иван Павлов <pavia00@gmail.com>
и
Малянов Евгений Викторович <maljanow@outlook.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 .