mbrlen

マルチバイト文字の表現におけるサイズをバイト単位で決定します。

この関数は、型 mbstate_t の隠れオブジェクト internal に対して mbrtowc ( NULL , s, n, ps ? ps : & internal ) を呼び出すことと等価ですが、式 ps は一度だけ評価される点が異なります。

パラメータ

戻り値

以下のうち最初に該当するもの：

• ​ 0 ​ 次の n バイト以内でナル文字が完成する場合、または s がナルポインタの場合。どちらの場合も変換状態をリセットする。
• 有効なマルチバイト文字を完成させるバイト数 [ 1 ... n ]
• ( size_t ) - 2 次の n バイトが有効な可能性のあるマルチバイト文字の一部であり、 n バイトすべてを検査した後もまだ不完全な場合
• ( size_t ) - 1 エンコーディングエラーが発生した場合。 errno の値は EILSEQ となる。変換状態は未指定。

例

#include <locale.h>
#include <stdio.h>
#include <string.h>
#include <wchar.h>
int main(void)
{
    // allow mbrlen() to work with UTF-8 multibyte encoding
    setlocale(LC_ALL, "en_US.utf8");
    // UTF-8 narrow multibyte encoding
    const char* str = "水";
    size_t sz = strlen(str);
    mbstate_t mb;
    memset(&mb, 0, sizeof mb);
    int len1 = mbrlen(str, 1, &mb);
    if (len1 == -2)
        printf("The first 1 byte of %s is an incomplete multibyte char"
               " (mbrlen returns -2)\n", str);
    int len2 = mbrlen(str + 1, sz - 1, &mb);
    printf("The remaining %zu  bytes of %s hold %d bytes of the multibyte"
           " character\n", sz - 1, str, len2);
    printf("Attempting to call mbrlen() in the middle of %s while in initial"
           " shift state returns %zd\n", str, mbrlen(str + 1, sz - 1, &mb));
}

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

参考文献

関連項目