std::mbrlen

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (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)，其中 internal 是类型为 std::mbstate_t 的某个隐藏对象，但表达式 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	将下一个多字节字符转换为宽字符，给定状态 (function)
mblen	返回下一个多字节字符的字节数 (function)
do_length [virtual]	计算转换为给定 InternT 缓冲区时将消耗的 ExternT 字符串的长度 (std::codecvt<InternT,ExternT,StateT> 的虚保护成员函数)
有关 mbrlen 的C 文档