_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Legge i dati formattati di una lunghezza specificata da una stringa. Queste funzioni sono versioni di _snscanf, _snscanf_l, _snwscanf, _snwscanf_l con miglioramenti della sicurezza, come descritto in Funzionalità di sicurezza in CRT.

Sintassi

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format [, argument_list]
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   _locale_t locale [, argument_list]
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format [, argument_list]
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   _locale_t locale [, argument_list]
);

Parametri

input
Stringa di input da esaminare.

length
Numero di caratteri da esaminare in input.

format
Uno o più identificatori di formato.

locale
Impostazioni locali da usare.

argument_list
Argomenti facoltativi da assegnare in base alla stringa di formato.

Valore restituito

Entrambe queste funzioni restituiscono il numero di campi convertiti e assegnati correttamente; Il valore restituito non include campi letti ma non assegnati. Un valore restituito pari a 0 indica che nessun campo è stato assegnato. Il valore restituito è EOF in caso di errore o se viene raggiunta la fine della stringa prima della prima conversione. Per altre informazioni, vedere sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Se input o format è un NULL puntatore, viene richiamato il gestore di parametri non validi, come descritto in Convalida dei parametri. Se l'esecuzione può continuare, queste funzioni restituiscono EOF e impostano errno su EINVAL.

Per informazioni su questi e altri codici di errore, vedere errno, _doserrno, _sys_errliste _sys_nerr.

Osservazioni:

Questa funzione è simile sscanf_sa , ad eccezione del fatto che consente di specificare un numero fisso di caratteri da esaminare dalla stringa di input. Per altre informazioni, vedere sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Il parametro delle dimensioni del buffer è obbligatorio con i caratteri del campo di tipo c, C, s, S e [. Per altre informazioni, vedere Caratteri di campo di tipo per scanf.

Nota

Il parametro di dimensione è di tipo unsigned non size_t.

Le versioni di queste funzioni con il suffisso _l sono identiche ad eccezione per il fatto che utilizzano il parametro delle impostazioni locali passato al posto di quelle del thread corrente.

Mapping di routine di testo generico

Routine Tchar.h	_UNICODE e _MBCS non definito	_MBCS Definito	_UNICODE Definito
_sntscanf_s	_snscanf_s	_snscanf_s	_snwscanf_s
_sntscanf_s_l	_snscanf_s_l	_snscanf_s_l	_snwscanf_s_l

Requisiti

Ciclo	Intestazione obbligatoria
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> o <wchar.h>

Per altre informazioni sulla compatibilità, vedere Compatibility (Compatibilità).

Esempio

// crt_snscanf_s.c
// This example scans a string of
// numbers, using both the character
// and wide character secure versions
// of the snscanf function.

#include <stdio.h>

int main( )
{
    char        str1[] = "15 12 14...";
    wchar_t     str2[] = L"15 12 14...";
    char        s1[3];
    wchar_t     s2[3];
    int         i;
    float       fp;

    i = _snscanf_s( str1, 6,  "%s %f", s1, 3, &fp);
    printf_s("_snscanf_s converted %d fields: ", i);
    printf_s("%s and %f\n", s1, fp);

    i = _snwscanf_s( str2, 6,  L"%s %f", s2, 3, &fp);
    wprintf_s(L"_snwscanf_s converted %d fields: ", i);
    wprintf_s(L"%s and %f\n", s2, fp);
}

_snscanf_s converted 2 fields: 15 and 12.000000
_snwscanf_s converted 2 fields: 15 and 12.000000

Vedi anche

Specifica della larghezza per scanf