C/C++のmbrlen()関数とは？マルチバイト文字の長さを取得する方法を解説

mbrlen()関数は、マルチバイト文字の長さ（バイト数）を取得するために使用される標準ライブラリ関数です。引数として渡されたポインタが指すマルチバイト文字のサイズを返します。

mbrlen()関数の構文

C言語におけるmbrlen()関数の構文は以下の通りです。

size_t mbrlen(const char* pointer, size_t size, mbstate_t* state);

パラメータの説明

• pointer − マルチバイト文字の先頭バイトへのポインタ
• size − チェックする最大バイト数
• state − mbstate_t型オブジェクトへのポインタ（変換状態を保持する）

この関数は、正常に解析できた場合はそのマルチバイト文字のバイト数を、不正なシーケンスの場合は-1を、不完全なシーケンスの場合は-2を返します。また、ヌル文字に到達した場合は0を返します。

mbrlen()関数の使用例

以下は、C言語でmbrlen()関数を使用したサンプルプログラムです。

#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>

int main(void) {
    char a[] = "s";
    mbstate_t s;
    int len;
    
    len = mbrlen(a, 5, &s);
    printf("Length of multibyte character : %d \n", len);
    return 0;
}

実行結果

Length of multibyte character : 1

プログラムの解説

上記のプログラムでは、mbrlen()関数を使ってマルチバイト文字の長さをバイト単位で計算しています。

char a[] = "s";
mbstate_t s;
int len;
len = mbrlen(a, 5, &s);

ここでは、文字列aに格納された文字「s」の長さを求めています。ASCII文字である「s」は1バイトで表現されるため、実行結果として1が出力されます。なお、日本語などのマルチバイト文字（UTF-8では3〜4バイト）を渡した場合には、その文字が占めるバイト数が返されます。

mbrlen()関数を使用する際は、ヘッダーファイル<wchar.h>をインクルードする必要がある点に注意してください。