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 文件