Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::is_standard_layout — verificar tipos de disposição standard

std::is_standard_layout verifica em tempo de compilação se um tipo cumpre as regras de disposição standard. std::is_standard_layout_v disponibiliza diretamente o mesmo resultado como bool. Esta característica não garante a ausência de preenchimento na memória nem um formato binário portátil.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

// <type_traits> synopsis (provided by the standard library)
namespace std {
    template<class T> struct is_standard_layout;

    template<class T>
    inline constexpr bool is_standard_layout_v = is_standard_layout<T>::value;
}

O cabeçalho <type_traits> disponibiliza o modelo de classe std::is_standard_layout<T>. O seu membro value é uma constante do tipo bool: tem o valor true quando T é um tipo de disposição standard. O modelo de variável std::is_standard_layout_v<T> é uma forma abreviada de std::is_standard_layout<T>::value, não um alias de tipo. Ambas as formas podem ser usadas em static_assert e if constexpr.

Os tipos de disposição standard incluem tipos escalares, classes que cumprem regras específicas, matrizes desses tipos e as respetivas variantes qualificadas com cv. Entre os requisitos para as classes estão não terem funções virtuais nem classes base virtuais, terem o mesmo controlo de acesso para todos os membros de dados não estáticos e não terem nenhum membro de dados não estático de tipo referência ou de um tipo de classe que não seja de disposição standard. Esta restrição de tipo não se aplica aos membros de dados estáticos. A herança está sujeita a restrições adicionais; a simples ausência de funções virtuais não é suficiente.

A precondição exige que std::remove_all_extents_t<T> seja um tipo completo ou void, eventualmente qualificado com cv. Não consultes uma classe antes da sua definição completa. Para void, o resultado é false. Não acrescentes especializações próprias destas características: isso provoca comportamento indefinido.

A disposição standard e a copiabilidade trivial são propriedades distintas. Um resultado true não garante a ausência de bytes de preenchimento, uma ABI idêntica ou uma serialização segura através da escrita de bytes em bruto. No exemplo, Point cumpre as regras, enquanto Polymorphic não as cumpre devido à sua função virtual; o resultado esperado é true e, depois, false, em linhas separadas.

Exemplos

#include <iostream>
#include <type_traits>

struct Point {
    int x;
    int y;
};

struct Polymorphic {
    virtual void draw() {}
};

static_assert(std::is_standard_layout<Point>::value);
static_assert(std::is_standard_layout_v<Point>);
static_assert(!std::is_standard_layout_v<Polymorphic>);

int main() {
    std::cout << std::boolalpha
              << std::is_standard_layout<Point>::value << '\n'
              << std::is_standard_layout_v<Polymorphic> << '\n';
}

Resultado

true
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes