C言語のwprintf()とwscanf()関数の使い方を徹底解説

C言語には、ワイド文字（wide character）を扱うための標準入出力関数として、wprintf()とwscanf()が用意されています。これらは、普段よく使われるprintf()やscanf()のワイド文字版に相当する関数で、ヘッダーファイル<wchar.h>内で定義されています。

本記事では、それぞれの関数の基本的な使い方をサンプルコードとともにわかりやすく解説します。

wprintf()関数とは

wprintf()は、ワイド文字列を標準出力へ出力するための関数です。フォーマット文字列には「%」記号で始まる書式指定子を含めることができ、これらは引数として渡された変数の値に置き換えられます。

構文

int wprintf(const wchar_t* format, ...);

引数と戻り値

• format： ヌル終端されたワイド文字列へのポインタです。コンソールに出力される内容を表し、ワイド文字と「%」で始まる書式指定子を含みます。
• ...（可変個引数）： 出力したいデータを渡します。データは書式指定子が出現する順序に従って処理されます。

戻り値は正常に出力された文字数です。エラーが発生した場合は負の値を返します。

使用例

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

int main() {
    wint_t my_int = 10;
    wchar_t string[] = L"Hello World";

    wprintf(L"The my_int is: %d \n", my_int);
    wprintf(L"The string is: %ls \n", string);

    return 0;
}

実行結果

The my_int is: 10
The string is: Hello World

この例では、整数値を出力するために「%d」、ワイド文字列を出力するために「%ls」という書式指定子を使用しています。

wscanf()関数とは

wscanf()は、コンソールからデータを読み込み、適切な変数に格納するための関数です。追加の引数には、フォーマット文字列内の対応する書式指定子で指定された型の、あらかじめ確保済みオブジェクトへのポインタを渡す必要があります。

使用例

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

int main() {
    wint_t my_int = 10;

    wprintf(L"Enter a number: ");
    wscanf(L"%d", &my_int);
    wprintf(L"The given integer is: %d \n", my_int);

    return 0;
}

実行結果

Enter a number: 40
The given integer is: 40

この例では、ユーザーが入力した数値をwscanf()で読み取り、変数my_intに格納しています。その後、wprintf()を使って入力された値を表示しています。

まとめ

• wprintf()：ワイド文字列を標準出力に出力する関数。printf()のワイド文字版。
• wscanf()：標準入力からワイド文字としてデータを読み込む関数。scanf()のワイド文字版。
• どちらも<wchar.h>ヘッダーをインクルードして使用します。

日本語などのマルチバイト文字を扱うプログラムでは、ワイド文字対応の入出力関数を使うことで文字化けを防ぎ、より安全な文字列処理が可能になります。