C ライブラリ関数 -mbstowcs()
説明
C ライブラリ関数mbstowcsマルチバイト文字列をワイド文字列に変換するために使用されます。
mbstowcs関数は <stdlib.h> ヘッダーファイルで定義されています。
宣言
以下は mbstowcs() 関数の宣言です。
size_t mbstowcs(wchar_t *pwcs, const char *mbs, size_t n);
パラメータ
pwcs: 変換後のワイド文字列を格納するためのバッファを指します。もしpwcsが NULL の場合、関数は実際の変換を行わずに必要なバッファ長を返します。mbs: マルチバイト文字列を指すポインタ。n: 変換する最大文字数。終端文字に遭遇する前に変換されたn文字数に達すると、変換は早めに停止します。
戻り値
- 成功した場合は、終端のヌル文字を含まない変換後のワイド文字数を返します。
- 無効なマルチバイトシーケンスに遭遇した場合は、
(size_t)-1を返し、errno。
例
以下の例は、mbstowcs() 関数の使い方を示しています。
例 1
#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("最初のマルチバイト文字の16進値:%#.4x\n", pmb);
printf("ワイド文字列への逆変換\n");
len = mbstowcs( pwcs, pmb, MB_CUR_MAX);
printf("変換された文字 %d\n", len);
printf("最初のワイド文字の16進値:%#.4x\n\n", pwcs);
return(0);
}
上記のプログラムをコンパイルして実行すると、次の結果が得られます。
转换为多字节字符串 被转换的字符 1 第一个多字节字符的十六进制值:0x19a60010 转换回宽字符字符串 被转换的字符 1 第一个宽字符的十六进制值:0x19a60030
例 2
#include <stdio.h>
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
int main() {
// 現在のロケールをユーザーの環境変数で指定されたロケールに設定する
setlocale(LC_ALL, "");
// マルチバイト文字列を定義
const char *mbstr = "Hello, 世界!";
// 必要なバッファサイズを計算
size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;
// ワイド文字バッファを割り当てる
wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
if (wcs == NULL) {
perror("malloc");
return 1;
}
// 変換を実行
mbstowcs(wcs, mbstr, wcs_len);
// ワイド文字列を出力
wprintf(L"%ls\n", wcs);
// メモリを解放
free(wcs);
return 0;
}
#include <stdlib.h>
#include <wchar.h>
#include <locale.h>
int main() {
// 現在のロケールをユーザーの環境変数で指定されたロケールに設定する
setlocale(LC_ALL, "");
// マルチバイト文字列を定義
const char *mbstr = "Hello, 世界!";
// 必要なバッファサイズを計算
size_t wcs_len = mbstowcs(NULL, mbstr, 0) + 1;
// ワイド文字バッファを割り当てる
wchar_t *wcs = (wchar_t *)malloc(wcs_len * sizeof(wchar_t));
if (wcs == NULL) {
perror("malloc");
return 1;
}
// 変換を実行
mbstowcs(wcs, mbstr, wcs_len);
// ワイド文字列を出力
wprintf(L"%ls\n", wcs);
// メモリを解放
free(wcs);
return 0;
}
上記のプログラムをコンパイルして実行すると、次の結果が得られます。
Hello, 世界!
注意事項
- Locale: 関数の動作は現在の
locale設定の影響を受けます。通常、mbstowcsを呼び出す前に、setlocaleを呼び出して適切なlocale。 - エラー処理: 入力のマルチバイト文字列に無効なマルチバイトシーケンスが含まれている場合、関数は
(size_t)-1を返し、errnoを設定します。呼び出し側は戻り値を確認し、起こり得るエラーを処理する必要があります。 - メモリ割り当て: 呼び出し側は、
pwcsが変換後のワイド文字列を格納するのに十分なスペースがあることを確認する必要があります。最初の呼び出しで、mbstowcsをpwcsに設定してNULL必要なバッファサイズを計算できます。
C 標準ライブラリ - <stdlib.h>