mbrlen

  • 项目

确定填充当前区域设置中多字节字符所需的字节数，其中重启功能位于多字节字符的中间。

语法

size_t mbrlen(
   const char * str,
   size_t count,
   mbstate_t * mbstate
);

参数

str
指向多字节字符字符串中要检查的下一字节的指针。

count
要检查的最大字节数。

mbstate
指向 str 的初始字节当前移位状态的指针。

返回值

以下值之一：

值 说明
0 下一个 count 或更少字节将填充代表宽 null 字符的多字节字符。
1 到 count（含） 下一个 count 或更少的字节填充有效的多字节字符。 返回的值是填充多字节字符的字节数。
(size_t)(-2) 下一个 count 字节有利于实现不完整但可能有效的多字节字符，并且已处理所有 count 字节。
(size_t)(-1) 发生编码错误。 下一个 count 或更少字节数不有利于实现完整且有效的多字节字符。 在这种情况下，errno 设置为 EILSEQ 且未指定 mbstate 中的转换状态。

备注

mbrlen 函数最多检查由 count 指向的字节开头的 str 个字节，以确定填充下一个多字节字符（包括任何位移序列）所需的字节数。 它等效于调用 mbrtowc(NULL, str, count, &mbstate)，其中 mbstate 为用户提供的 mbstate_t 对象或库提供的静态内部对象。

mbrlen 函数将保存并使用 mbstate 参数中不完整多字节字符的移位状态。 正因为如此，**mbrlen** 可以在多字节字符中间重启（如果需要）并检查最多 count 个字节。 如果 mbstate 为 null 指针，则 mbrlen 使用内部静态的 mbstate_t 对象来存储位移状态。 由于内部 mbstate_t 对象不是线程安全的，建议始终分配和传递你自己的 mbstate 参数。

mbrlen 函数的可重启性不同于 _mbclen、mblen、_mblen_l。 位移状态存储在 mbstate 中，以便后续调用相同函数或其他可重启函数。 混合使用可重启函数和不可重启函数时，结果不确定。 例如，如果使用 wcsrlen（而非 wcslen）的后续调用，则应用程序应使用 wcsrtombs，而不是 wcstombs。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

一般文本例程映射

TCHAR.H 例程 _UNICODE 和 _MBCS 未定义 _MBCS 已定义 _UNICODE 已定义
不适用 不适用 mbrlen 不适用

要求

例程 必需的标头
mbrlen <wchar.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

此示例演示了多字节字符的解释如何取决于当前代码页，并展示了 mbrlen 的恢复功能。

// crt_mbrlen.c
// Compile by using: cl crt_mbrlen.c
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include <locale.h>
#include <wchar.h>

size_t Example(const char * pStr)
{
    size_t      charLen = 0;
    size_t      charCount = 0;
    mbstate_t   mbState = {0};

    while ((charLen = mbrlen(pStr++, 1, &mbState)) != 0 &&
            charLen != (size_t)-1)
    {
        if (charLen != (size_t)-2) // if complete mbcs char,
        {
            charCount++;
        }
    }
    return (charCount);
}

int main( void )
{
    int         cp;
    size_t      charCount = 0;
    const char  *pSample =
        "\x82\xD0\x82\xE7\x82\xAA\x82\xC8: Shift-jis hiragana.";

    cp = _getmbcp();
    charCount = Example(pSample);
    printf("\nCode page: %d\n%s\nCharacter count: %d\n",
        cp, pSample, charCount);

    setlocale(LC_ALL, "ja-JP"); // Set Japanese locale
    _setmbcp(932); // and Japanese multibyte code page
    cp = _getmbcp();
    charCount = Example(pSample);
    printf("\nCode page: %d\n%s\nCharacter count: %d\n",
        cp, pSample, charCount);
}


Code page: 0
é╨éτé¬é╚: Shift-jis hiragana.
Character count: 29

Code page: 932
????: Shift-jis hiragana.
Character count: 25

另请参阅

字符串操作
区域设置