std:: length_error
|
Определено в заголовке
<stdexcept>
|
||
|
class
length_error
;
|
||
Определяет тип объекта, который будет выброшен как исключение. Сообщает об ошибках, возникающих в результате попыток превысить определенные реализацией ограничения длины для некоторого объекта.
Это исключение выбрасывается функциями-членами std::basic_string и std::vector::reserve .
Все функции-члены
std::length_error
являются
constexpr
: возможно создавать и использовать объекты
std::length_error
при вычислении константного выражения.
Однако, объекты
|
(since C++26) |
Диаграмма наследования
Содержание |
Функции-члены
|
(constructor)
|
создает новый объект
length_error
с заданным сообщением
(public member function) |
|
operator=
|
заменяет объект
length_error
(public member function) |
std::length_error:: length_error
|
length_error
(
const
std::
string
&
what_arg
)
;
|
(1) | (constexpr since C++26) |
|
length_error
(
const
char
*
what_arg
)
;
|
(2) | (constexpr since C++26) |
|
length_error
(
const
length_error
&
other
)
;
|
(3) |
(noexcept since C++11)
(constexpr since C++26) |
std::length_error
, то
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
. Конструктор копирования не может генерировать исключения.
Параметры
| what_arg | - | поясняющая строка |
| other | - | другой объект исключения для копирования |
Исключения
Примечания
Поскольку копирование
std::length_error
не должно генерировать исключения, это сообщение обычно хранится внутри как отдельно выделенная строка с подсчетом ссылок. Это также объясняет, почему нет конструктора, принимающего
std::string&&
: в любом случае пришлось бы копировать содержимое.
До решения LWG issue 254 , не копирующий конструктор мог принимать только std::string . Это делало динамическое выделение памяти обязательным для создания объекта std::string .
После решения
LWG issue 471
, производный класс стандартного исключения должен иметь общедоступный конструктор копирования. Он может быть неявно определен, если поясняющие строки, полученные с помощью
what()
, одинаковы для исходного объекта и скопированного объекта.
std::length_error:: operator=
|
length_error
&
operator
=
(
const
length_error
&
other
)
;
|
(noexcept since C++11)
(constexpr since C++26) |
|
Присваивает содержимое объекта
other
. Если
*
this
и
other
оба имеют динамический тип
std::length_error
, то после присваивания
std::
strcmp
(
what
(
)
, other.
what
(
)
)
==
0
. Оператор копирующего присваивания не может генерировать исключения.
Параметры
| other | - | другой объект исключения для присваивания |
Возвращаемое значение
* this
Примечания
После решения
LWG issue 471
, производный класс стандартного исключения должен иметь общедоступный оператор копирующего присваивания. Он может быть неявно определен, пока пояснительные строки, полученные с помощью
what()
, одинаковы для исходного объекта и скопированного объекта.
Унаследовано от std:: logic_error
Унаследовано от std:: exception
Функции-члены
|
[virtual]
|
уничтожает объект исключения
(виртуальная публичная функция-член
std::exception
)
|
|
[virtual]
|
возвращает поясняющую строку
(виртуальная публичная функция-член
std::exception
)
|
Примечания
| Макрос тестирования возможностей | Значение | Стандарт | Возможность |
|---|---|---|---|
__cpp_lib_constexpr_exceptions
|
202502L
|
(C++26) | constexpr типы исключений |
Отчеты о дефектах
Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.
| DR | Applied to | Behavior as published | Correct behavior |
|---|---|---|---|
| LWG 254 | C++98 | конструктор, принимающий const char * отсутствовал | добавлен |
| LWG 471 | C++98 |
пояснительные строки копий
std::length_error
были определяемыми реализацией |
они совпадают с таковыми у исходного
объекта
std::length_error
|
Смотрите также
|
изменяет количество хранимых символов
(публичная функция-член
std::basic_string<CharT,Traits,Allocator>
)
|