vsscanf、vswscanfvsscanf, vswscanf

文字列から書式付きデータを読み込みます。Reads formatted data from a string. これらの関数にはセキュリティが強化されたバージョンがあります。「vsscanf_s、vswscanf_s」をご覧ください。More secure versions of these functions are available; see vsscanf_s, vswscanf_s.

構文Syntax

int vsscanf(
   const char *buffer,
   const char *format,
   va_list arglist
);
int vswscanf(
   const wchar_t *buffer,
   const wchar_t *format,
   va_list arglist
);

パラメーターParameters

バッファーbuffer
格納されるデータ。Stored data

formatformat
書式指定文字列。Format-control string. 詳細については、「Format Specification Fields: scanf and wscanf Functions」(scanf 関数と wscanf 関数の書式指定フィールド) をご覧ください。For more information, see Format Specification Fields: scanf and wscanf Functions.

arglistarglist
可変個引数リスト。Variable argument list.

戻り値Return Value

これらの関数は、正常に変換および代入されたフィールドの数を返します。読み込まれただけで代入されなかったフィールドは戻り値には含まれません。Each of these functions returns the number of fields that are successfully converted and assigned; the return value does not include fields that were read but not assigned. 戻り値が 0 の場合は、代入されたフィールドがなかったことを示します。A return value of 0 indicates that no fields were assigned. 戻り値はEOFエラーの最初の変換の前に、文字列の末尾に達した場合またはします。The return value is EOF for an error or if the end of the string is reached before the first conversion.

場合バッファーまたは形式は、 NULL 」の説明に従って、ポインター、無効なパラメーター ハンドラーが呼び出されるパラメーターの検証です。If buffer or format is a NULL pointer, the invalid parameter handler is invoked, as described in Parameter Validation. 実行の継続が許可された場合、これらの関数は-1 を返し設定とerrnoEINVALします。If execution is allowed to continue, these functions return -1 and set errno to EINVAL.

エラー コードの詳細については、「errno、_doserrno、_sys_errlist、_sys_nerr」をご覧ください。For information about these and other error codes, see errno, _doserrno, _sys_errlist, and _sys_nerr.

RemarksRemarks

Vsscanf関数からデータを読み取るバッファーの各引数で指定されている場所に、 arglist引数リスト。The vsscanf function reads data from buffer into the locations that are given by each argument in the arglist argument list. リスト内のすべての引数に型指定子に対応する型を持つ変数へのポインターである必要があります形式します。Every argument in the list must be a pointer to a variable that has a type that corresponds to a type specifier in format. 形式引数コントロール入力の解釈のフィールドし、同じ形式し、機能、形式の引数、 scanf関数。The format argument controls the interpretation of the input fields and has the same form and function as the format argument for the scanf function. 重なり合う文字列間でコピーした場合の動作は未定義です。If copying takes place between strings that overlap, the behavior is undefined.

重要

使用するとvsscanfの幅を常に文字列を読み取り、指定、 %s形式 (たとえば、 「% 男女」 の代わりに "%s");それ以外の場合、正しくない形式の入力には、バッファー オーバーランを可能性があります。When you use vsscanf to read a string, always specify a width for the %s format (for example, "%32s" instead of "%s"); otherwise, incorrectly formatted input can cause a buffer overrun.

vswscanfのワイド文字バージョンは、 vsscanf; 引数vswscanfはワイド文字列です。vswscanf is a wide-character version of vsscanf; the arguments to vswscanf are wide-character strings. vsscanfマルチバイトの 16 進数の文字を処理しません。vsscanf does not handle multibyte hexadecimal characters. vswscanf Unicode の全角 16 進数または「互換区域」の文字を処理しません。vswscanf does not handle Unicode full-width hexadecimal or "compatibility zone" characters. それ以外の場合、 vswscanfvsscanf動作は同じです。Otherwise, vswscanf and vsscanf behave identically.

汎用テキスト ルーチンのマップGeneric-Text Routine Mappings

TCHAR.H のルーチンTCHAR.H routine _UNICODE および _MBCS が未定義の場合_UNICODE & _MBCS not defined _MBCS が定義されている場合_MBCS defined _UNICODE が定義されている場合_UNICODE defined
_vstscanf_vstscanf vsscanfvsscanf vsscanfvsscanf vswscanfvswscanf

必要条件Requirements

ルーチンによって返される値Routine 必須ヘッダーRequired header
vsscanfvsscanf <stdio.h><stdio.h>
vswscanfvswscanf <stdio.h> または <wchar.h><stdio.h> or <wchar.h>

互換性の詳細については、「 互換性」を参照してください。For additional compatibility information, see Compatibility.

Example

// crt_vsscanf.c
// compile with: /W3
// This program uses vsscanf to read data items
// from a string named tokenstring, then displays them.

#include <stdio.h>
#include <stdarg.h>

int call_vsscanf(char *tokenstring, char *format, ...)
{
    int result;
    va_list arglist;
    va_start(arglist, format);
    result = vsscanf(tokenstring, format, arglist);
    va_end(arglist);
    return result;
}

int main( void )
{
    char  tokenstring[] = "15 12 14...";
    char  s[81];
    char  c;
    int   i;
    float fp;

    // Input various data from tokenstring:
    // max 80 character string:
    call_vsscanf(tokenstring, "%80s", s);
    call_vsscanf(tokenstring, "%c", &c);
    call_vsscanf(tokenstring, "%d", &i);
    call_vsscanf(tokenstring, "%f", &fp);

    // Output the data read
    printf("String    = %s\n", s);
    printf("Character = %c\n", c);
    printf("Integer:  = %d\n", i);
    printf("Real:     = %f\n", fp);
}
String    = 15
Character = 1
Integer:  = 15
Real:     = 15.000000

関連項目See also

ストリーム入出力Stream I/O
scanf、_scanf_l、wscanf、_wscanf_lscanf, _scanf_l, wscanf, _wscanf_l
sscanf、_sscanf_l、swscanf、_swscanf_lsscanf, _sscanf_l, swscanf, _swscanf_l
sprintf、_sprintf_l、swprintf、_swprintf_l、__swprintf_lsprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l
vsscanf_s、vswscanf_svsscanf_s, vswscanf_s