std:: vscanf, std:: vfscanf, std:: vsscanf
|
Definido en el encabezado
<cstdio>
|
||
|
int
vscanf
(
const
char
*
format, std
::
va_list
vlist
)
;
|
(1) | (desde C++11) |
|
int
vfscanf
(
std::
FILE
*
stream,
const
char
*
format, std
::
va_list
vlist
)
;
|
(2) | (desde C++11) |
|
int
vsscanf
(
const
char
*
buffer,
const
char
*
format, std
::
va_list
vlist
)
;
|
(3) | (desde C++11) |
Lee datos de una variedad de fuentes, los interpreta según el format y almacena los resultados en ubicaciones definidas por vlist .
Contenidos |
Parámetros
| stream | - | flujo de archivo de entrada desde el cual leer |
| buffer | - | puntero a una cadena de caracteres terminada en nulo desde la cual leer |
| format | - | puntero a una cadena de caracteres terminada en nulo que especifica cómo leer la entrada |
| vlist | - | lista de argumentos variables que contiene los argumentos receptores. |
La cadena de
formato
consiste en
- caracteres multibyte que no son espacios en blanco excepto % : cada uno de estos caracteres en la cadena de formato consume exactamente un carácter idéntico del flujo de entrada, o provoca que la función falle si el siguiente carácter en el flujo no es igual.
- caracteres de espacio en blanco: cualquier carácter de espacio en blanco individual en la cadena de formato consume todos los caracteres de espacio en blanco consecutivos disponibles de la entrada (determinado como si se llamara a std::isspace en un bucle). Nótese que no hay diferencia entre " \n " , " " , " \t \t " , u otros espacios en blanco en la cadena de formato.
- especificaciones de conversión. Cada especificación de conversión tiene el siguiente formato:
-
- carácter % introductorio.
-
- (opcional) carácter de supresión de asignación * . Si esta opción está presente, la función no asigna el resultado de la conversión a ningún argumento receptor.
-
- (opcional) número entero (mayor que cero) que especifica el ancho máximo de campo , es decir, el número máximo de caracteres que la función puede consumir al realizar la conversión especificada por la especificación de conversión actual. Nótese que % s y % [ pueden provocar desbordamiento de búfer si no se proporciona el ancho.
-
- (opcional) modificador de longitud que especifica el tamaño del argumento receptor, es decir, el tipo de destino real. Esto afecta la precisión de conversión y las reglas de desbordamiento. El tipo de destino predeterminado es diferente para cada tipo de conversión (ver tabla abajo).
-
- especificador de formato de conversión.
Los siguientes especificadores de formato están disponibles:
|
Especificador
de conversión |
Explicación |
Tipo de
argumento esperado |
||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Modificador de Longitud→ |
hh
|
h
|
ninguno |
l
|
ll
|
j
|
z
|
t
|
L
|
|
| Solo disponible desde C++11→ | Sí | Sí | Sí | Sí | Sí | |||||
%
|
Coincide con el literal
%
.
|
N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A | N/A |
c
|
Coincide con un carácter o una secuencia de caracteres .
|
N/A | N/A |
char
*
|
wchar_t
*
|
N/A | N/A | N/A | N/A | N/A |
s
|
Coincide con una secuencia de caracteres que no son espacios en blanco (una string ).
|
|||||||||
[
set
]
|
Coincide con una secuencia no vacía de caracteres del set de caracteres.
|
|||||||||
d
|
Coincide con un entero decimal .
|
signed
char
*
o
unsigned
char
*
|
signed
short
*
o
unsigned
short
*
|
signed
int
*
o
unsigned
int
*
|
signed
long
*
o
unsigned
long
*
|
signed
long
long
*
o
unsigned
long
long
*
|
N/A | |||
i
|
Coincide con un entero .
|
|||||||||
u
|
Coincide con un entero decimal sin signo .
|
|||||||||
o
|
Coincide con un entero octal sin signo .
|
|||||||||
x
X
|
Coincide con un entero hexadecimal sin signo .
|
|||||||||
n
|
Devuelve el número de caracteres leídos hasta el momento .
|
|||||||||
a
(C++11)
A
(C++11)
e
E
f
F
(C++11)
g
G
|
Coincide con un número de punto flotante .
|
N/A | N/A |
float
*
|
double
*
|
N/A | N/A | N/A | N/A |
long
double
*
|
p
|
Coincide con la secuencia de caracteres definida por la implementación que define un puntero .
|
N/A | N/A |
void
**
|
N/A | N/A | N/A | N/A | N/A | N/A |
| Notas | ||||||||||
|
Para cada especificador de conversión distinto de n , la secuencia más larga de caracteres de entrada que no exceda el ancho de campo especificado y que sea exactamente lo que el especificador de conversión espera o sea un prefijo de una secuencia que esperaría, es lo que se consume del flujo. El primer carácter, si existe, después de esta secuencia consumida permanece sin leer. Si la secuencia consumida tiene longitud cero o si la secuencia consumida no puede convertirse como se especificó anteriormente, ocurre un fallo de coincidencia a menos que el fin de archivo, un error de codificación o un error de lectura impidieran la entrada del flujo, en cuyo caso es un fallo de entrada. Todos los especificadores de conversión distintos de [ , c , y n consumen y descartan todos los caracteres de espacio en blanco iniciales (determinados como si se llamara a std::isspace ) antes de intentar analizar la entrada. Estos caracteres consumidos no cuentan para el ancho de campo máximo especificado. Los especificadores de conversión lc , ls , y l [ realizan conversión de caracteres multibyte a ancho como si se llamara a std::mbrtowc con un objeto std::mbstate_t inicializado a cero antes de convertir el primer carácter. Los especificadores de conversión s y [ siempre almacenan el terminador nulo además de los caracteres coincidentes. El tamaño del array de destino debe ser al menos uno mayor que el ancho de campo especificado. El uso de % s o % [ , sin especificar el tamaño del array de destino, es tan inseguro como std::gets . Las especificaciones de conversión correctas para los tipos de enteros de ancho fijo ( std::int8_t , etc.) se definen en el encabezado <cinttypes> (aunque SCNdMAX , SCNuMAX , etc. son sinónimos de % jd , % ju , etc.). Hay un punto de secuencia después de la acción de cada especificador de conversión; esto permite almacenar múltiples campos en la misma variable "receptora". Al analizar un valor de coma flotante incompleto que termina en el exponente sin dígitos, como analizar "100er" con el especificador de conversión % f , la secuencia "100e" (el prefijo más largo de un posible número de coma flotante válido) se consume, resultando en un error de coincidencia (la secuencia consumida no puede convertirse a un número de coma flotante), con "r" restante. Algunas implementaciones existentes no siguen esta regla y retroceden para consumir solo "100" , dejando "er" , por ejemplo, error de glibc 1765 . Si una especificación de conversión es inválida, el comportamiento es indefinido. |
||||||||||
Valor de retorno
Número de argumentos leídos exitosamente, o EOF si ocurre un fallo.
Notas
Todas estas funciones invocan
va_arg
al menos una vez, el valor de
arg
es indeterminado después del retorno. Estas funciones no invocan
va_end
, y debe ser realizado por el llamador.
Ejemplo
#include <cstdarg> #include <cstdio> #include <iostream> #include <stdexcept> void checked_sscanf(int count, const char* buf, const char *fmt, ...) { std::va_list ap; va_start(ap, fmt); if (std::vsscanf(buf, fmt, ap) != count) throw std::runtime_error("parsing error"); va_end(ap); } int main() { try { int n, m; std::cout << "Analizando '1 2'... "; checked_sscanf(2, "1 2", "%d %d", &n, &m); std::cout << "éxito\n"; std::cout << "Analizando '1 a'... "; checked_sscanf(2, "1 a", "%d %d", &n, &m); std::cout << "éxito\n"; } catch (const std::exception& e) { std::cout << e.what() << '\n'; } }
Salida:
Analizando '1 2'... éxito Analizando '1 a'... parsing error
Véase también
|
lee entrada formateada desde
stdin
, un flujo de archivo o un búfer
(función) |
|
|
imprime salida formateada a
stdout
, un flujo de archivo o un búfer
usando lista de argumentos variables (función) |
|
|
Documentación de C
para
vscanf
,
vfscanf
,
vsscanf
|
|