std::domain_error
| Определено в заголовочном файле <stdexcept>
|
||
| class domain_error; |
||
Определяет тип объекта, который бросается как исключение. Он может использоваться реализацией для сообщения об ошибках предметной области, то есть в ситуациях, когда входные данные находятся за пределами предметной области, в которой определена операция.
Компоненты стандартной библиотеки не генерируют это исключение (математические функции сообщают об ошибках предметной области, как указано в math_errhandling). Однако сторонние библиотеки используют его. Например, boost.math генерирует std::domain_error, если boost::math::policies::throw_on_error включено (настройка по умолчанию).
Диаграмма наследования
Содержание |
[править] Функции-элементы
| (конструктор) |
создаёт новый объект domain_error с заданным сообщением (public функция-элемент) |
| operator= |
заменяет объект domain_error (public функция-элемент) |
std::domain_error::domain_error
| domain_error( const std::string& what_arg ); |
(1) | |
| domain_error( const char* what_arg ); |
(2) | |
| (3) | ||
| domain_error( const domain_error& other ); |
(до C++11) | |
| domain_error( const domain_error& other ) noexcept; |
(начиная с C++11) | |
std::domain_error, тогда std::strcmp(what(), other.what()) == 0. Исключения не могут быть сгенерированы из конструктора копирования. (до C++11)Параметры
| what_arg | — | пояснительная строка |
| other | — | другой объект исключения для копирования |
Исключения
Примечание
Поскольку при копировании std::domain_error не разрешается создавать исключения, это сообщение обычно хранится внутри в виде отдельно выделенной строки с подсчётом ссылок. По этой же причине нет конструктора, принимающего std::string&&: ему всё равно пришлось бы копировать содержимое.
До разрешения LWG проблема 254, некопирующий конструктор может принимать только std::string. Это делает динамическое размещение обязательным для создания объекта std::string.
После разрешения LWG проблема 471, производный стандартный класс исключения должен иметь общедоступный конструктор копирования. Его можно определить неявно, если поясняющие строки, полученные с помощью what(), одинаковы для исходного объекта и скопированного объекта.
std::domain_error::operator=
| domain_error& operator=( const domain_error& other ); |
(до C++11) | |
| domain_error& operator=( const domain_error& other ) noexcept; |
(начиная с C++11) | |
Присваивает содержимое из other. Если *this и other имеют динамический тип std::domain_error, тогда std::strcmp(what(), other.what()) == 0 после присваивания. Оператор присваивания копированием не может вызвать исключение. (до C++11)
Параметры
| other | — | другой объект исключения для присваивания |
Возвращаемое значение
*this
Примечание
После разрешения LWG проблема 471, производный стандартный класс исключения должен иметь общедоступный оператор присваивания копированием. Его можно определить неявно, если поясняющие строки, полученные с помощью what(), одинаковы для исходного объекта и скопированного объекта.
Унаследован от std::logic_error
Унаследован от std::exception
Функции-элементы
| [virtual] |
уничтожает объект исключения (virtual public of std::exception функция-элемент)
|
| [virtual] |
возвращает поясняющую строку (virtual public of std::exception функция-элемент)
|
[править] Отчёты о дефектах
Следующие изменения поведения были применены с обратной силой к ранее опубликованным стандартам C++:
| Номер | Применён | Поведение в стандарте | Корректное поведение |
|---|---|---|---|
| LWG 254 | C++98 | конструктор, принимающий const char*, отсутствовал | добавлен |
| LWG 471 | C++98 | пояснительные строки копий std::domain_errorбыли определены реализацией |
они такие же, как у исходного объектаstd::domain_error
|
