std::range_error
| Определено в заголовочном файле <stdexcept>
|
||
| class range_error; |
||
Определяет тип объекта, который бросается как исключение. Его можно использовать для сообщения об ошибках диапазона (то есть в ситуациях, когда результат вычисления не может быть представлен типом результата).
Единственными компонентами стандартной библиотеки, вызывающими это исключение, являются std::wstring_convert::from_bytes и std::wstring_convert::to_bytes.
Математические функции в компонентах стандартной библиотеки не генерируют это исключение (математические функции сообщают об ошибках диапазона, как указано в math_errhandling).
Диаграмма наследования
Содержание |
[править] Функции-элементы
| (конструктор) |
создаёт новый объект range_error с заданным сообщением (public функция-элемент) |
| operator= |
заменяет объект range_error (public функция-элемент) |
std::range_error::range_error
| range_error( const std::string& what_arg ); |
(1) | |
| range_error( const char* what_arg ); |
(2) | |
| (3) | ||
| range_error( const range_error& other ); |
(до C++11) | |
| range_error( const range_error& other ) noexcept; |
(начиная с C++11) | |
std::range_error, тогда std::strcmp(what(), other.what()) == 0. Исключения не могут быть сгенерированы из конструктора копирования. (до C++11)Параметры
| what_arg | — | пояснительная строка |
| other | — | другой объект исключения для копирования |
Исключения
Примечание
Поскольку при копировании std::range_error не разрешается создавать исключения, это сообщение обычно хранится внутри в виде отдельно выделенной строки с подсчётом ссылок. По этой же причине нет конструктора, принимающего std::string&&: ему всё равно пришлось бы копировать содержимое.
До разрешения LWG проблема 254, некопирующий конструктор может принимать только std::string. Это делает динамическое размещение обязательным для создания объекта std::string.
После разрешения LWG проблема 471, производный стандартный класс исключения должен иметь общедоступный конструктор копирования. Его можно определить неявно, если поясняющие строки, полученные с помощью what(), одинаковы для исходного объекта и скопированного объекта.
std::range_error::operator=
| range_error& operator=( const range_error& other ); |
(до C++11) | |
| range_error& operator=( const range_error& other ) noexcept; |
(начиная с C++11) | |
Присваивает содержимое из other. Если *this и other имеют динамический тип std::range_error, тогда std::strcmp(what(), other.what()) == 0 после присваивания. Оператор присваивания копированием не может вызвать исключение. (до C++11)
Параметры
| other | — | другой объект исключения для присваивания |
Возвращаемое значение
*this
Примечание
После разрешения LWG проблема 471, производный стандартный класс исключения должен иметь общедоступный оператор присваивания к��пированием. Его можно определить неявно, если поясняющие строки, полученные с помощью what(), одинаковы для исходного объекта и скопированного объекта.
Унаследован от std::runtime_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::range_error былиопределены реализацией |
они такие же, как у исходного объектаstd::range_error
|
