static_assert declaration (since C++11)

Realiza comprobación de aserciones en tiempo de compilación.

Sintaxis

Declara una aserción estática. Si la aserción falla, el programa está mal formado y puede generarse un mensaje de error de diagnóstico.

Explicación

Una declaración static_assert puede aparecer en el ámbito de espacio de nombres y de bloque scope (como una declaración de bloque ) y dentro del cuerpo de una clase (como una declaración de miembro ).

Si bool-constexpr está bien formado y evalúa a true , o es evaluado en el contexto de una definición de plantilla y la plantilla no está instanciada, esta declaración no tiene efecto. De lo contrario, se emite un error en tiempo de compilación, y el mensaje proporcionado por el usuario, si existe, se incluye en el mensaje de diagnóstico.

El texto del mensaje proporcionado por el usuario se determina de la siguiente manera:

• Si el mensaje coincide con los requisitos sintácticos de unevaluated-string , el texto del mensaje es el texto de la unevaluated-string .

Notas

El estándar no requiere que un compilador imprima el texto literal del mensaje de error , aunque los compiladores generalmente lo hacen tanto como es posible.

Palabras clave

static_assert

Ejemplo

#include <format>
#include <type_traits>
static_assert(03301 == 1729); // desde C++17 el mensaje de texto es opcional
template<class T>
void swap(T& a, T& b) noexcept
{
    static_assert(std::is_copy_constructible_v<T>,
                  "Swap requires copying");
    static_assert(std::is_nothrow_copy_constructible_v<T> &&
                  std::is_nothrow_copy_assignable_v<T>,
                  "Swap requires nothrow copy/assign");
    auto c = b;
    b = a;
    a = c;
}
template<class T>
struct data_structure
{
    static_assert(std::is_default_constructible_v<T>,
                  "Data structure requires default-constructible elements");
};
template<class>
constexpr bool dependent_false = false; // solución temporal antes de CWG2518/P2593R1
template<class T>
struct bad_type
{
    static_assert(dependent_false<T>, "error on instantiation, workaround");
    static_assert(false, "error on instantiation"); // OK debido a CWG2518/P2593R1
};
struct no_copy
{
    no_copy(const no_copy&) = delete;
    no_copy() = default;
};
struct no_default
{
    no_default() = delete;
};
#if __cpp_static_assert >= 202306L
// No es C++ real aún (std::format debería ser constexpr para funcionar):
static_assert(sizeof(int) == 4, std::format("Expected 4, got {}", sizeof(int)));
#endif
int main()
{
    int a, b;
    swap(a, b);
    no_copy nc_a, nc_b;
    swap(nc_a, nc_b); // 1
    [[maybe_unused]] data_structure<int> ds_ok;
    [[maybe_unused]] data_structure<no_default> ds_error; // 2
}

1: error: static assertion failed: Swap requires copying
2: error: static assertion failed: Data structure requires default-constructible elements
3: error: static assertion failed: Expected 4, got 2

Informes de defectos

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

Referencias

Véase también