Compartir a través de


_snscanf_s, _snscanf_s_l, _snwscanf_s, _snwscanf_s_l

Lee dio formato datos de una longitud especificada de una cadena.Éstas son versiones de _snscanf, _snscanf_l, _snwscanf, _snwscanf_l con mejoras de seguridad como se describe en Características de seguridad en 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,
   …
);

Parámetros

  • input
    cadena de entrada a examinar.

  • length
    número de caracteres a examinar en input.

  • format
    Uno o varios especificadores de formato.

  • ... (optional)
    Las variables que se usarán para almacenar los valores extrajeron de la cadena de entrada de los especificadores de formato en format.

  • locale
    la configuración regional a utilizar.

Valor devuelto

Ambas funciones devuelven el número de campos convierten y asignados correctamente; el valor devuelto no incluye los campos que se leyeron pero no asignados.Devuelve un valor de 0 indica que no se asignó ningún campos.El valor devuelto es EOF para un error o si el final de la cadena se logra antes de la primera conversión.Para obtener más información, vea sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

Si input o format es un puntero de NULL , se invoca el controlador no válido de parámetro, tal y como se describe en Validación de parámetros.Si la ejecución puede continuar, estas funciones EOF return y errno determinado a EINVAL.

Para obtener información sobre éstos y otros códigos de error, vea _doserrno, errno, _sys_errlist, y _sys_nerr.

Comentarios

esta función es como sscanf_s salvo que proporciona la capacidad de especificar un número de caracteres fijo para examinar de la cadena de entrada.Para obtener más información, vea sscanf_s, _sscanf_s_l, swscanf_s, _swscanf_s_l.

El parámetro de tamaño de búfer se requiere con escribir caracteres de campo c, C, s, S, y [.Para obtener más información, vea caracteres de campo del tipo scanf.

[!NOTA]

El parámetro size es de unsignedtipo, no size_t.

Las versiones de estas funciones con el sufijo de _l son idénticas salvo que utilizan el parámetro locale pasado en lugar de la configuración regional del subproceso actual.

Asignaciones de la rutina de texto genérico

rutina de Tchar.h

_UNICODE y _MBCS no definido

_MBCS definido

_UNICODE definido

_sntscanf_s

_snscanf_s

_snscanf_s

_snwscanf_s

_sntscanf_s_l

_snscanf_s_l

_snscanf_s_l

_snwscanf_s_l

Requisitos

rutina

Encabezado necesario

_snscanf_s, _snscanf_s_l

<stdio.h>

_snwscanf_s, _snwscanf_s_l

<stdio.h> o <wchar.h>

Para obtener más información de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// 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 en .NET Framework

No es aplicable Para llamar a la función estándar de C, utilice PInvoke. Para obtener más información, vea La invocación de plataforma ejemplos.

Vea también

Referencia

especificación de ancho scanf