sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l

Articolo
03/05/2013

Dati formattati letti da una stringa.queste sono versioni di sscanf, _sscanf_l, swscanf, _swscanf_l con i miglioramenti della sicurezza come descritto in Funzionalità di sicurezza in CRT.

int sscanf_s(
   const char *buffer,
   const char *format [,
   argument ] ...
);
int _sscanf_s_l(
   const char *buffer,
   const char *format,
   locale_t locale [,
   argument ] ...
);
int swscanf_s(
   const wchar_t *buffer,
   const wchar_t *format [,
   argument ] ...
);
int _swscanf_s_l(
   const wchar_t *buffer,
   const wchar_t *format,
   locale_t locale [,
   argument ] ...
);

Parametri

buffer
dati archiviati
format
stringa del Formato-controllo.Per ulteriori informazioni, vedere Specifiche di formato.
argument
argomenti facoltativi
locale
le impostazioni locali da utilizzare

Valore restituito

Ognuna di queste 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.

se buffer 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, queste funzioni restituiscono -1 e impostate errno in EINVAL

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

Note

sscanf_sla funzione legge i dati da buffer nella posizione specificata da ognuno argument.Gli argomenti dopo che la stringa di formato specifica i puntatori a variabili con un tipo che corrisponde a un identificatore del tipo in format.A differenza del minore garantiscono la versione sscanf, un parametro di dimensione del buffer è obbligatorio quando si utilizzano i caratteri di campo del tipo c, C, s, Se [.Le dimensioni del buffer i caratteri devono essere fornite come parametro aggiuntivo dopo ciascun buffer che lo richiede.Per ulteriori informazioni, vedere scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l e caratteri di campo del tipo di scanf.

[!NOTA]

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

format l'argomento controlla interpretazione dei campi di input e presenta lo stesso form e di funzione format argomento per scanf_s funzione.Se copiare si trova tra le stringhe che si sovrappongono, il comportamento sarà indefinito.

swscanf_s è una versione a caratteri estesi di sscanf_s; gli argomenti a swscanf_s sono le stringhe di caratteri estesi.sscanf_s non gestisce i caratteri esadecimali multibyte.swscanf_s non gestisce caratteri a byte doppio dell'area di esadecimale o “di compatibilità„ Unicode.In caso contrario, swscanf_s e sscanf_s comportano in modo identico.

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 & _MBCS non definiti	_MBCS definito	_UNICODE definito
_stscanf_s	sscanf_s	sscanf_s	swscanf_s
_stscanf_s_l	_sscanf_s_l	_sscanf_s_l	_swscanf_s_l

Requisiti

routine	Intestazione di associazione
sscanf_s, _sscanf_s_l	<stdio.h>
swscanf_s, _swscanf_s_l	<stdio.h> o <wchar.h>

per informazioni di compatibilità aggiuntive, vedere compatibilità nell'introduzione.

Esempio

// crt_sscanf_s.c
// This program uses sscanf_s to read data items
// from a string named tokenstring, then displays them.

#include <stdio.h>
#include <stdlib.h>

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 plus NULL terminator
   sscanf_s( tokenstring, "%s", s, _countof(s) );
   sscanf_s( tokenstring, "%c", &c, sizeof(char) );
   sscanf_s( tokenstring, "%d", &i );
   sscanf_s( tokenstring, "%f", &fp );

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