.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, Bruno Haible .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH mbrlen 3 "8 февраля 2026 г." "Linux man\-pages 6.18" .SH НАИМЕНОВАНИЕ mbrlen \- вычисляет количество байт в следующем многобайтовом символе .SH БИБЛИОТЕКА Стандартная библиотека языка C (\fIlibc\fP,\ \fI\-lc\fP) .SH СИНТАКСИС .nf \fB#include \fP .P \fBsize_t mbrlen(\fPsize_t n; \fB const char \fP\fIs\fP\fB[restrict \fP\fIn\fP\fB], size_t \fP\fIn\fP\fB,\fP \fB mbstate_t *restrict \fP\fIps\fP\fB);\fP .fi .SH ОПИСАНИЕ Функция \fBmbrlen\fP() просматривает не более \fIn\fP байт в многобайтовой строке, начинающейся с \fIs\fP и извлекает следующий полный многобайтовый символ. Она изменяет состояние сдвига \fI*ps\fP. Если многобайтовый символ не является широким символом null, то возвращается количество байт, которые использовались из \fIs\fP. Если многобайтовый символ является широким символом null, состояние сдвига \fI*ps\fP сбрасывается в начальное и возвращается 0. .P Если в \fIn\fP байтах, начиная с \fIs\fP, не содержится полного многобайтового символа, то \fBmbrlen\fP() возвращает \fI(size_t)\ \-2\fP. Это может произойти даже, если \fIn\fP >= \fIMB_CUR_MAX\fP, если в многобайтовой строке содержится лишние сдвиговые последовательности. .P Если многобайтовая строка, начинающаяся с \fIs\fP, содержит некорректную многобайтовую последовательность до следующего полного символа, то \fBmbrlen\fP() возвращает \fI(size_t)\ \-1\fP и присваивает \fIerrno\fP значение \fBEILSEQ\fP. В этом случае влияние на \fI*ps\fP не определено. .P Если \fIps\fP равно NULL, то используется статическое анонимное состояние, известное только функции \fBmbrlen\fP(). .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" Функция \fBmbrlen\fP() возвращает количество байт, просмотренных в многобайтовой последовательности, начинающейся с \fIs\fP, если при этом был получен широкий символ не равный null. Она возвращает 0, если был получен широкий символ null. Она возвращает \fI(size_t)\ \-1\fP и присваивает \fIerrno\fP значение \fBEILSEQ\fP, если встречена некорректная многобайтовая последовательность. Она возвращает \fI(size_t)\ \-2\fP, если не удалось найти полную многобайтовую последовательность, что означает, что \fIn\fP должно быть увеличено. .SH АТРИБУТЫ Описание терминов данного раздела смотрите в \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Интерфейс Атрибут Значение T{ .na .nh \fBmbrlen\fP() T} Безвредность в нитях MT\-Unsafe race:mbrlen/!ps .TE .SH СТАНДАРТЫ C11, POSIX.1\-2008. .SH ИСТОРИЯ POSIX.1\-2001, C99. .SH ПРИМЕЧАНИЯ Поведение \fBmbrlen\fP() зависит от категории \fBLC_CTYPE\fP текущей локали. .SH "СМОТРИТЕ ТАКЖЕ" \fBmbrtowc\fP(3) .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства разработал(и) aereiae , Alexey , Azamat Hackimov , Dmitriy S. Seregin , Dmitry Bolkhovskikh , ITriskTI , Max Is , Yuri Kozlov , Иван Павлов и Малянов Евгений Викторович . .PP Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, .UR https://www.gnu.org/licenses/gpl-3.0.html .UE версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ. .PP Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу .MT debian-l10n-russian@lists.debian.org списка рассылки русских переводчиков .ME .