Namespaces
Variants

std:: length_error

From cppreference.net
C++
Diagnostics library
헤더에 정의됨 <stdexcept>
class length_error ;

예외로 던져질 객체의 유형을 정의합니다. 일부 객체에 대해 구현에서 정의된 길이 제한을 초과하려는 시도로 인해 발생하는 오류를 보고합니다.

이 예외는 std::basic_string 와 std::vector::reserve 의 멤버 함수에 의해 발생됩니다.

std::length_error 의 모든 멤버 함수는 constexpr 입니다: 상수 표현식 평가에서 std::length_error 객체를 생성하고 사용하는 것이 가능합니다.

그러나 std::length_error 객체는 일반적으로 constexpr 일 수 없습니다. 왜냐하면 동적으로 할당된 저장 공간은 동일한 상수 표현식 평가에서 해제되어야 하기 때문입니다.

(C++26부터)
cpp/error/exception cpp/error/logic error std-length error-inheritance.svg

상속 다이어그램

목차

멤버 함수

(생성자)
주어진 메시지로 새로운 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)
1) what_arg 를 설명 문자열로 사용하여 예외 객체를 생성합니다. 생성 후, std:: strcmp ( what ( ) , what_arg. c_str ( ) ) == 0 입니다.
2) what_arg 를 설명 문자열로 사용하여 예외 객체를 생성합니다. 생성 후, std:: strcmp ( what ( ) , what_arg ) == 0 입니다.
3) 복사 생성자입니다. * this 와 other 모두 동적 타입이 std::length_error 인 경우, std:: strcmp ( what ( ) , other. what ( ) ) == 0 입니다. 복사 생성자에서는 예외가 발생하지 않습니다.

매개변수

what_arg - 설명 문자열
other - 복사할 다른 예외 객체

예외

1,2) std::bad_alloc 을 던질 수 있습니다.

참고 사항

std::length_error 의 복사는 예외를 던지는 것이 허용되지 않기 때문에, 이 메시지는 일반적으로 별도로 할당된 참조 카운트 문자열로 내부에 저장됩니다. 이것이 std::string&& 를 취하는 생성자가 없는 이유이기도 합니다: 어차피 내용을 복사해야 하기 때문입니다.

LWG 이슈 254 가 해결되기 전에는, 비복사 생성자는 std::string 만 받을 수 있었습니다. 이는 std::string 객체를 생성하기 위해 동적 할당을 필수적으로 만들었습니다.

LWG 이슈 471 가 해결된 후, 파생된 표준 예외 클래스는 공개적으로 접근 가능한 복사 생성자를 가져야 합니다. 원본 객체와 복사된 객체에 대해 what() 으로 얻은 설명 문자열이 동일한 한 암시적으로 정의될 수 있습니다.

std::length_error:: operator=

length_error & operator = ( const length_error & other ) ;
(C++11부터 noexcept)
(C++26부터 constexpr)

other 의 내용을 할당합니다. * this 와 other 모두 동적 타입 std::length_error 를 갖는 경우, 할당 후 std:: strcmp ( what ( ) , other. what ( ) ) == 0 입니다. 복사 할당 연산자에서는 예외가 발생하지 않습니다.

매개변수

other - 할당할 다른 예외 객체

반환값

* this

참고

LWG 이슈 471 해결 이후, 파생된 표준 예외 클래스는 공개적으로 접근 가능한 복사 할당 연산자를 가져야 합니다. 원본 객체와 복사된 객체에 대해 what() 로 얻은 설명 문자열이 동일한 한 암시적으로 정의될 수 있습니다.

std:: logic_error 에서 상속됨

std:: exception 로부터 상속됨

멤버 함수

[virtual]
예외 객체를 파괴함
( std::exception 의 virtual public 멤버 함수)
[virtual]
설명 문자열을 반환함
( std::exception 의 virtual public 멤버 함수)

참고 사항

기능 테스트 매크로 값 표준 기능
__cpp_lib_constexpr_exceptions 202502L (C++26) constexpr 예외 타입

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

DR 적용 대상 게시된 동작 올바른 동작
LWG 254 C++98 const char * 를 받는 생성자가 누락됨 추가됨
LWG 471 C++98 std::length_error 의 설명 문자열이
구현에 따라 정의됨 		원본 std::length_error 객체와
동일함

참고 항목

저장된 문자 수를 변경합니다
( std::basic_string<CharT,Traits,Allocator> 의 public 멤버 함수)