std::mbrlen

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

文本处理库

本地化库

正则表达式库 (C++11)

格式化库 (C++20)

空终止序列工具

字节字符串

多字节字符串

宽字符串

原始数值转换

to_chars (C++17) to_chars_result (C++17) from_chars (C++17) from_chars_result (C++17) chars_format (C++17)

文本编码识别

text_encoding (C++26)

 

空终止多字节字符串

函数 宽字节/多字节检查 mblen mbrlen mbsinit 多字节/宽字节转换 mbtowc mbstowcs btowc mbrtowc mbsrtowcs    wctomb wcstombs wctob wcrtomb wcsrtombs mbrtoc8 (C++20) mbrtoc16 (C++11) mbrtoc32 (C++11) c8rtomb (C++20) c16rtomb (C++11) c32rtomb (C++11)

类型

mbstate_t

宏

MB_LEN_MAX MB_CUR_MAX __STDC_UTF_16__ __STDC_UTF_32__ (C++11)(C++11)

 

定义于头文件 <cwchar>
std::size_t mbrlen( const char* s, std::size_t n, std::mbstate_t* ps);

确定以字节为单位的多字节字符的剩余大小，该多字节字符的第一个字节由 s 指向，并给定当前的转换状态 ps。

此函数等效于调用 std::mbrtowc(nullptr, s, n, ps ? ps : &internal) 对于某些类型为 std::mbstate_t 的隐藏对象 internal，除了表达式 ps 只被评估一次。

参数

s	-	指向多字节字符串元素的指针
n	-	可以检查的 s 中的字节数限制
ps	-	指向保存转换状态的变量的指针

返回值

• ​0​ 如果接下来的 n 个或更少的字节完成空字符。
• 完成有效多字节字符的字节数（介于 1 和 n 之间）。
• std::size_t(-1) 如果发生编码错误。
• std::size_t(-2) 如果接下来的 n 个字节是可能有效的多字节字符的一部分，但在检查所有 n 个字节后仍然不完整。

示例

运行此代码

#include <clocale>
#include <cwchar>
#include <iostream>
#include <string>
 
int main()
{
    // allow mbrlen() to work with UTF-8 multibyte encoding
    std::setlocale(LC_ALL, "en_US.utf8");
 
    // UTF-8 narrow multibyte encoding
    std::string str = "水"; // or u8"\u6c34" or "\xe6\xb0\xb4"
    std::mbstate_t mb = std::mbstate_t();
 
    // simple use: length of a complete multibyte character
    const std::size_t len = std::mbrlen(&str[0], str.size(), &mb);
    std::cout << "The length of " << str << " is " << len << " bytes\n";
 
    // advanced use: restarting in the middle of a multibyte character
    const std::size_t len1 = std::mbrlen(&str[0], 1, &mb);
    if (len1 == std::size_t(-2))
        std::cout << "The first 1 byte of " << str
                  << " is an incomplete multibyte char (mbrlen returns -2)\n";
 
    const std::size_t len2 = std::mbrlen(&str[1], str.size() - 1, &mb);
    std::cout << "The remaining " << str.size() - 1 << " bytes of " << str
              << " hold " << len2 << " bytes of the multibyte character\n";
 
    // error case:
    std::cout << "Attempting to call mbrlen() in the middle of " << str
              << " while in initial shift state returns "
              << (int)mbrlen(&str[1], str.size(), &mb) << '\n';
}

输出

The length of 水 is 3 bytes.
The first 1 byte of 水 is an incomplete multibyte char (mbrlen returns -2)
The remaining 2 bytes of 水 hold 2 bytes of the multibyte character
Attempting to call mbrlen() in the middle of 水 while in initial shift state returns -1

参见

mbrtowc	将下一个多字节字符转换为宽字符，给定状态 (函数)
mblen	返回下一个多字节字符中的字节数 (函数)
do_length [virtual]	计算将被转换为给定 InternT 缓冲区的 ExternT 字符串的长度 (std::codecvt<InternT,ExternT,StateT> 的虚保护成员函数)
C 文档 关于 mbrlen