_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Articolo
03/05/2013

Reads formattata i dati di lunghezza specificata da una stringa.queste sono versioni di _snscanf, _snscanf_l, _snwscanf, _snwscanf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

int __cdecl _snscanf_s(
   const char * input,
   size_t length,
   const char * format,
   ...
);
int __cdecl _snscanf_s_l(
   const char * input,
   size_t length,
   const char * format,
   locale_t locale,
   ...
);
int __cdecl _snwscanf_s(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   ...
);
int __cdecl _snwscanf_s_l(
   const wchar_t * input,
   size_t length,
   const wchar_t * format,
   locale_t locale,
   …
);

Parametri

input
stringa di input da esaminare.
length
Numero di caratteri da esaminare in input.
format
uno o più identificatori di formato.
... (optional)
Le variabili da utilizzare per archiviare i valori estrarre la stringa di input da identificatori di formato in format.
locale
le impostazioni locali da utilizzare.

Valore restituito

Entrambe le funzioni restituisce il numero di campi correttamente conversione e assegnati; il valore restituito non include campi che sono stati letti ma non assegnato.Un valore restituito pari a 0 indica che nessun campo è stato assegnato.il valore restituito è EOF per un errore o la fine della stringa viene raggiunta prima della prima conversione.Per ulteriori informazioni, vedere sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

se input o format è un oggetto NULL il puntatore, il gestore non valido di parametro viene richiamato, come descritto in Convalida dei parametri.Se l'esecuzione è consentita per continuare, ritorno di queste funzioni EOF e set errno in EINVAL.

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

Note

questa funzione è come sscanf_s con la differenza che consente di specificare un numero di caratteri fisso per esaminare la stringa di input.Per ulteriori informazioni, vedere sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Il parametro di dimensione del buffer è obbligatorio con i caratteri di campo del tipo c, C, s, Se [.Per ulteriori informazioni, vedere caratteri di campo del tipo di scanf.

[!NOTA]

il parametro di dimensione è di tipo unsigned, non size_t.

le versioni di queste funzioni con _l il suffisso è identico con la differenza che utilizzano il parametro delle impostazioni locali passato alle impostazioni locali del thread corrente.

Mapping di routine a testo generico

routine di Tchar.h	_UNICODE e _MBCS non definiti	_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

routine	Intestazione di associazione
_snscanf_s, _snscanf_s_l	<stdio.h>
_snwscanf_s, _snwscanf_s_l	<stdio.h> o <wchar.h>

Per ulteriori informazioni sulla compatibilità, vedere compatibilità nell'introduzione.

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);
}

Equivalente .NET Framework

Non applicabile. Per chiamare la funzione c standard, utilizzare PInvoke. Per ulteriori informazioni, vedere Esempi di pinvoke.

Vedere anche

Riferimenti

specifica la larghezza di scanf

Condividi tramite