Namespaces
Variants

    std:: range_error

    From es.cppreference.net
    C++
    Diagnostics library
    Definido en el encabezado <stdexcept>
    class range_error ;

    Define un tipo de objeto que se lanzará como excepción. Se puede utilizar para reportar errores de rango (es decir, situaciones donde el resultado de un cálculo no puede ser representado por el tipo de destino).

    Los únicos componentes de la biblioteca estándar que lanzan esta excepción son std::wstring_convert::from_bytes y std::wstring_convert::to_bytes .

    Las funciones matemáticas en los componentes de la biblioteca estándar no lanzan esta excepción (las funciones matemáticas reportan errores de rango como se especifica en math_errhandling ).

    Todas las funciones miembro de std::range_error son constexpr : es posible crear y utilizar objetos std::range_error en la evaluación de una expresión constante.

    Sin embargo, los objetos std::range_error generalmente no pueden ser constexpr , porque cualquier almacenamiento asignado dinámicamente debe liberarse en la misma evaluación de la expresión constante.

    		(since C++26)
    cpp/error/exception cpp/error/runtime error std-range error-inheritance.svg

    Diagrama de herencia

    Contenidos

    Funciones miembro

    (constructor)
    		construye un nuevo objeto range_error con el mensaje dado
    (función miembro pública)
    operator=
    		reemplaza el objeto range_error
    (función miembro pública)

    std::range_error:: range_error

    range_error ( const std:: string & what_arg ) ;
    		(1) (constexpr desde C++26)
    range_error ( const char * what_arg ) ;
    		(2) (constexpr desde C++26)
    range_error ( const range_error & other ) ;
    		(3) (noexcept desde C++11)
    (constexpr desde C++26)
    1) Construye el objeto de excepción con what_arg como cadena explicativa. Después de la construcción, std:: strcmp ( what ( ) , what_arg. c_str ( ) ) == 0 .
    2) Construye el objeto de excepción con what_arg como cadena explicativa. Después de la construcción, std:: strcmp ( what ( ) , what_arg ) == 0 .
    3) Constructor de copia. Si * this y other tienen ambos tipo dinámico std::range_error entonces std:: strcmp ( what ( ) , other. what ( ) ) == 0 . Ninguna excepción puede ser lanzada desde el constructor de copia.

    Parámetros

    what_arg - cadena explicativa
    other - otro objeto de excepción a copiar

    Excepciones

    1,2) Puede lanzar std::bad_alloc .

    Notas

    Debido a que copiar std::range_error no está permitido lanzar excepciones, este mensaje típicamente se almacena internamente como una cadena con conteo de referencias asignada por separado. Esta es también la razón por la cual no hay un constructor que tome std::string&& : tendría que copiar el contenido de todas formas.

    Antes de la resolución de LWG issue 254 , el constructor no copia solo podía aceptar std::string . Esto hace que la asignación dinámica sea obligatoria para construir un objeto std::string .

    Después de la resolución de LWG issue 471 , una clase de excepción estándar derivada debe tener un constructor de copia públicamente accesible. Puede estar definido implícitamente siempre que las cadenas explicativas obtenidas por what() sean las mismas para el objeto original y el objeto copiado.

    std::range_error:: operator=

    range_error & operator = ( const range_error & other ) ;
    		(noexcept desde C++11)
    (constexpr desde C++26)

    Asigna los contenidos con los de other . Si * this y other tienen ambos el tipo dinámico std::range_error entonces std:: strcmp ( what ( ) , other. what ( ) ) == 0 después de la asignación. Ninguna excepción puede ser lanzada desde el operador de asignación de copia.

    Parámetros

    other - otro objeto de excepción con el cual asignar

    Valor de retorno

    * this

    Notas

    Después de la resolución de LWG issue 471 , una clase de excepción estándar derivada debe tener un operador de asignación de copia públicamente accesible. Puede estar definido implícitamente siempre que las cadenas explicativas obtenidas por what() sean las mismas para el objeto original y el objeto copiado.

    Heredado de std:: runtime_error


    Heredado de std:: exception

    Funciones miembro

    [virtual]
    		destruye el objeto de excepción
    (función miembro pública virtual de std::exception )
    [virtual]
    		devuelve una cadena explicativa
    (función miembro pública virtual de std::exception )

    Notas

    Macro de prueba de características Valor Std Característica
    __cpp_lib_constexpr_exceptions 202502L (C++26) constexpr tipos de excepción

    Informes de defectos

    Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a los estándares publicados anteriormente de C++.

    DR Aplicado a Comportamiento publicado Comportamiento correcto
    LWG 254 C++98 faltaba el constructor que acepta const char * añadido
    LWG 471 C++98 las cadenas explicativas de las copias de std::range_error
    estaban definidas por la implementación     		son las mismas que las del objeto
    original std::range_error