Spec-Zone.ru › C++

std::basic_ios<CharT,Traits>::clear

void clear( std::ios_base::iostate state = std::ios_base::goodbit );

Устанавливает флаги состояния ошибки потока, присваивая им значение state. По умолчанию присваивает std::ios_base::goodbit, что приводит к сбросу всех флагов состояния ошибки.

Если rdbuf() является указателем null (т.е. нет связанного буфера потока), то state | std::ios_base::badbit присваивается.

Параметры

state - новое значение флагов состояния ошибки. Оно может быть комбинацией следующих констант:
Константа Объяснение
goodbit нет ошибки
badbit невосстановимая ошибка потока
failbit операция ввода/вывода завершилась неудачно (ошибка форматирования или извлечения)
eofbit связанная последовательность ввода достигла конца файла

Возвращаемое значение

(ничего)

Исключения

Если новое состояние ошибки включает бит, также включённый в маску exceptions(), выбрасывается исключение типа failure.

Пример

clear() без аргументов может быть использован для сброса флага failbit после неожиданного ввода; для std::cin.putback(c) см. ungetc.

#include <iostream>
#include <string>
 
int main()
{
    for (char c : {'\n', '4', '1', '.', '3', '\n', 'Z', 'Y', 'X'})
        std::cin.putback(c); // emulate user's input (not portable: see ungetc Notes)
 
    double n;
    while (std::cout << "Please, enter a number: " && !(std::cin >> n))
    {
        std::cin.clear();
        std::string line;
        std::getline(std::cin, line);
        std::cout << line << "\nI am sorry, but '" << line << "' is not a number\n";
    }
    std::cout << n << "\nThank you for entering the number " << n << '\n';
}

Вывод:

Please, enter a number: XYZ
I am sorry, but 'XYZ' is not a number
Please, enter a number: 3.14
Thank you for entering the number 3.14

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

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

DR Применено к Поведение, как опубликовано Правильное поведение
LWG 412 C++98 исключение будет выброшено, если текущее состояние ошибки
включает бит, также включённый в маску exceptions()
проверяется новое
состояние ошибки вместо

См. также

setstate
устанавливает флаги состояния
(публичный член-функция)
rdstate
возвращает флаги состояния
(публичный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/io/basic_ios/clear

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API