std::ws

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de E/S

Manipuladores de E/S

E/S estilo C

Búferes

basic_streambuf

basic_filebuf

basic_stringbuf

strstreambuf (en desuso en C++98)

basic_syncbuf (C++20)

Flujos

Abstracciones

ios_base

basic_ios

basic_istream

basic_ostream

basic_iostream

E/S de archivos

basic_ifstream

basic_ofstream

basic_fstream

E/S de cadenas

basic_istringstream

basic_ostringstream

basic_stringstream

E/S de arrays

istrstream (en desuso en C++98)

ostrstream (en desuso en C++98)

strstream (en desuso en C++98)

Salida sincronizada

basic_osyncstream (C++20)

Tipos

streamoff

streamsize

fpos

Interfaz de categoría de error

iostream_category (C++11)

io_errc (C++11)

 

Manipuladores de E/S

Formateo de punto flotante
showpointnoshowpoint setprecision	fixedscientifichexfloatdefaultfloat (C++11)(C++11)
Formateo de enteros
setbase showbasenoshowbase	dechexoct
Formateo de booleanos
boolalphanoboolalpha
Control de ancho de campo y relleno
setfill setw	internalleftright
Otro formateo
showposnoshowpos	uppercasenouppercase
Procesamiento de espacio en blanco
ws ends	skipwsnoskipws
Vaciado de salida
flush endl flush_emit (C++20)	unitbufnounitbuf emit_on_flushnoemit_on_flush (C++20)(C++20)
Manipulación de indicadores de estado
resetiosflags	setiosflags
E/S de tiempo y dinero
get_money (C++11) get_time (C++11)	put_money (C++11) put_time (C++11)
Manipulación entre comillas
quoted (C++14)

 

Definido en el archivo de encabezado <istream>
template<class CharT, class Traits > std::basic_istream<CharT, Traits>& ws(std::basic_istream<CharT, Traits>& is );

Descarta los espacios en blanco iniciales de un flujo de entrada.

Se comporta como una FunciónDeEntradaSinFormato, excepto que is.gcount() no se modifica. Después de construir y verificar el objeto centinela, extrae caracteres del flujo y los descarta hasta que se produzca alguna de las siguientes condiciones:

• se produce una condición de fin de archivo en la secuencia de entrada (en cuyo caso la función llama a setstate(eofbit) pero no establece failbit; esto no se aplica si eofbit ya está establecido en is antes de la llamada a ws, en cuyo caso la construcción del objeto centinela establecería failbit).

• el siguiente carácter disponible c en la secuencia de entrada no es un espacio en blanco según lo determinado por std::isspace(c, is.getloc()). No se extraen los caracteres que no son espacios en blanco.

Este es un manipulador de E/S de solo entrada, que se puede llamar con una expresión como in >> std::ws para cualquier in del tipo std::basic_istream.

Parámetros

is

-

Referencia al flujo de entrada.

Valor de retorno

is (referencia al flujo después de la extracción de espacios consecutivos).

Notas

Si eofbit se establece en la transmisión antes de la llamada, la construcción del objeto centinela establecerá failbit.

Ejemplo

Ejecuta este código

#include <iomanip>#include <iostream>#include <istream>#include <sstream>#include <string>   int main(){for(constchar* str :{" #1 test", "\t #2 test", "#3 test"}){std::string line;std::getline(std::istringstream{str}, line);std::cout<<"getline devuelve:\t"<<std::quoted(line)<<'\n';   std::istringstream iss{str};std::getline(iss >> std::ws, line);std::cout<<"ws + getline devuelve:\t"<<std::quoted(line)<<'\n';}}

Salida:

getline devuelve: " #1 test" ws + getline devuelve: "#1 test" getline devuelve: " #2 test" ws + getline devuelve: "#2 test" getline devuelve: "#3 test" ws + getline devuelve: "#3 test"

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 415	C++98	Llamar a std::ws podría no construir el objeto centinela (no es coherente con otras funciones de entrada).	Es necesario construir el objeto centinela.

Véase también

ignore

Extrae y descarta caracteres hasta encontrar el carácter dado. (función miembro pública de std::basic_istream)