scanf, _scanf_l, wscanf, _wscanf_l

  • [アーティクル]

標準入力ストリームから書式付きデータを読み取ります。 これらの関数のセキュリティを強化したバージョンを使用できます。「scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l」を参照してください。

Note

Visual Studio 2015 では、printf および scanf ファミリの関数は inline として宣言され、<stdio.h> および <conio.h> ヘッダーに移動されました。 古いコードを移行する場合は、これらの関数に関連してリンカー エラー LNK2019が表示されることがあります。 詳細については、Visual C++ 2003 から 2015 の変更履歴に関するページを参照してください。

構文

int scanf(
   const char *format [,
   argument]...
);
int _scanf_l(
   const char *format,
   _locale_t locale [,
   argument]...
);
int wscanf(
   const wchar_t *format [,
   argument]...
);
int _wscanf_l(
   const wchar_t *format,
   _locale_t locale [,
   argument]...
);

パラメーター

format
書式指定文字列。

argument
省略可能な引数。

locale
使用するロケール。

戻り値

正常に変換され、割り当てられたフィールドの数を返します。戻り値には、読み取られたが割り当てられないフィールドは含まれません。 戻り値が 0 の場合は、代入されたフィールドがなかったことを示します。

ポインターのNULL場合format、「パラメーターの検証」で説明されているように、無効なパラメーター ハンドラーが呼び出されます。 実行の継続が許可された場合、これらの関数は EOF を返し、errno を EINVAL に設定します。

これらのエラー コードおよびその他のエラー コードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」を参照してください。

解説

scanf 関数は、標準入力ストリーム stdin からデータを読み取り、そのデータを argument で指定されている位置に書き込みます。 各 argument は、format の型指定子に対応する型の変数へのポインターにする必要があります。 重なり合う文字列間でコピーした場合の動作は未定義です。

重要

scanf の文字列を読み取るときは、%s の書式向けに幅を必ず指定します (たとえば、%32s の代わりに %s)。それ以外の場合は、不適切な書式を入力するとバッファー オーバーランが発生しやすくなる場合があります。 scanf_s、_scanf_s_l、wscanf_s、_wscanf_s_l、または fgets の使用を検討してください。

wscanf 関数は、 scanf関数のワイド文字バージョンです。 format 関数の引数 wscanf は、ワイド文字列です。 ストリームが ANSI モードで開かれている場合、wscanf と scanf の動作は同じになります。 scanf では、UNICODE ストリームからの入力はサポートされていません。

これらの関数のうち _l サフィックスが付けられたバージョンは、現在のスレッド ロケールの代わりに渡されたロケール パラメーターを使用する点を除いて同じです。

汎用テキスト ルーチンのマップ

TCHAR.H ルーチン _UNICODE と _MBCS が定義されていない _MBCS が定義されている _UNICODE が定義されている
_tscanf scanf scanf wscanf
_tscanf_l _scanf_l _scanf_l _wscanf_l

詳細については、「書式指定フィールド: scanf およびwscanf関数」を参照してください。

必要条件

ルーチンによって返される値 必須ヘッダー
scanf, _scanf_l <stdio.h>
wscanf, _wscanf_l <stdio.h> または <wchar.h>

ユニバーサル Windows プラットフォーム (UWP) アプリではコンソールがサポートされていません。 コンソール (stdin、stdout、stderr) に関連付けられている標準ストリームのハンドルは、C ランタイム関数によって UWP アプリで使用される前に、リダイレクトする必要があります。 互換性の詳細については、「 Compatibility」を参照してください。

例

// crt_scanf.c
// compile with: /W3
// This program uses the scanf and wscanf functions
// to read formatted input.

#include <stdio.h>

int main( void )
{
   int   i, result;
   float fp;
   char  c, s[81];
   wchar_t wc, ws[81];
   result = scanf( "%d %f %c %C %80s %80S", &i, &fp, &c, &wc, s, ws ); // C4996
   // Note: scanf and wscanf are deprecated; consider using scanf_s and wscanf_s
   printf( "The number of fields input is %d\n", result );
   printf( "The contents are: %d %f %c %C %s %S\n", i, fp, c, wc, s, ws);
   result = wscanf( L"%d %f %hc %lc %80S %80ls", &i, &fp, &c, &wc, s, ws ); // C4996
   wprintf( L"The number of fields input is %d\n", result );
   wprintf( L"The contents are: %d %f %C %c %hs %s\n", i, fp, c, wc, s, ws);
}

71 98.6 h z Byte characters
36 92.3 y n Wide characters

The number of fields input is 6
The contents are: 71 98.599998 h z Byte characters
The number of fields input is 6
The contents are: 36 92.300003 y n Wide characters

関連項目

数学と浮動小数点のサポート
ストリーム入出力
ロケール
fscanf, _fscanf_l, fwscanf, _fwscanf_l
printf, _printf_l, wprintf, _wprintf_l
sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
sscanf, _sscanf_l, swscanf, _swscanf_l