std::ws

template< class CharT, class Traits >
std::basic_istream<CharT, Traits>& ws( std::basic_istream<CharT, Traits>& is );

Отбрасывает начальные пробельные символы из входного потока.

Ведёт себя как UnformattedInputFunction, за исключением того, что is.gcount() не изменяется. После создания и проверки объекта sentry, извлекает символы из потока и отбрасывает их, пока не выполнится одно из следующих условий:

• возникает условие конца файла в последовательности входных данных (в этом случае функция вызывает setstate(eofbit) но не устанавливает failbit; это не относится к случаю, если eofbit уже установлено на is до вызова ws, в этом случае создание объекта sentry установит failbit).
• следующий доступный символ c в последовательности входных данных не является пробельным символом, как определено std::isspace(c, is.getloc()). Символ, не являющийся пробельным, не извлекается.

Это манипулятор ввода-вывода только для ввода; его можно вызвать с выражением, таким как in >> std::ws для любого in типа std::basic_istream.

Параметры

Значение результата

is (ссылка на поток после извлечения последовательных пробельных символов).

Примечания

Если eofbit установлено в потоке до вызова, создание объекта sentry установит failbit.

Пример

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

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

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроактивно к ранее опубликованным стандартам C++.

См. также