> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/locale/mblen.3.md).

# mblen(3)

`mblen` — 获取字符的字节数

## 名称

`mblen`

## 库

Lb libc

## 概要

`#include <stdlib.h>`

`Ft int Fn mblen const char *mbchar size_t nbytes`

## 描述

`mblen` 函数根据当前转换状态计算多字节字符 `mbchar` 的字节长度。最多检查 `nbytes` 个字节。

以空 `mbchar` 指针调用时，若当前 locale 需要移位状态则返回非零值，否则返回零；若需要移位状态，则将移位状态重置为初始状态。

## 返回值

若 `mbchar` 为 `NULL`，当支持移位状态时 `mblen` 函数返回非零值，否则返回零。

否则，若 `mbchar` 不是空指针，`mblen` 在 `mbchar` 表示空的宽字符时返回 0，在成功时返回 `mbchar` 中处理的字节数，在无法识别或转换任何多字节字符时返回 -1。在这种情况下，`mblen` 的内部转换状态是未定义的。

## 错误

`mblen` 函数在以下情况下会失败：

**\[Er** EILSEQ] 检测到无效的多字节序列。

**\[Er** EINVAL] 内部转换状态无效。

## 参见

[mbrlen(3)](/locale/mbrlen.3.md), [mbtowc(3)](/locale/mbtowc.3.md), [multibyte(3)](/locale/multibyte.3.md)

## 标准

`mblen` 函数遵循 ISO/IEC 9899:1999 ("ISO C99")。