C ライブラリ関数 -mblen()

C 标准库 - <stdlib.h>C 標準ライブラリ - <stdlib.h>

説明

C ライブラリ関数int mblen(const char *str, size_t n)戻りパラメータstr指し示すマルチバイト文字の長さ。

宣言

以下は mblen() 関数の宣言です。

int mblen(const char *str, size_t n)

引数

  • str-- マルチバイト文字の最初のバイトを指すポインタ。
  • n-- チェックする文字の長さの最大バイト数。

戻り値

非ヌルワイド文字が認識された場合、mblen() 関数は str から始まるマルチバイトシーケンスの解析されたバイト数を返します。ヌルワイド文字が認識された場合は 0 を返します。無効なマルチバイトシーケンスが認識された場合、または完全なマルチバイト文字を解析できない場合は -1 を返します。

例

以下の例は mblen() 関数の使い方を示しています。

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

int main()
{
   int len;
   char *pmbnull  = NULL;
   char *pmb = (char *)malloc( MB_CUR_MAX );
   wchar_t *pwc = L"Hi";
   wchar_t *pwcs = (wchar_t *)malloc( sizeof( wchar_t ));

   printf("转换为多字节字符串\n");
   len = wcstombs( pmb, pwc, MB_CUR_MAX);
   printf("被转换的字符 %d\n", len);
   printf("第一个多字节字符的十六进制值:%#.4x\n", pmb);
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "多字节字符 %x 的字节长度:%u\n", pmb, len );
   
   pmb = NULL;
   
   len = mblen( pmb, MB_CUR_MAX );
   printf( "多字节字符 %x 的字节长度:%u\n", pmb, len );
   
   return(0);
}

上記のプログラムをコンパイルして実行すると、次の結果が得られます。

转换为多字节字符串
被转换的字符 1
第一个多字节字符的十六进制值:0x168c6010
多字节字符 168c6010 的字节长度:1
多字节字符 0 的字节长度:0

C 标准库 - <stdlib.h>C 標準ライブラリ - <stdlib.h>

その他の拡張