offsetof

La macro offsetof se expande a una expresión constante entera de tipo std::size_t , cuyo valor es el desplazamiento, en bytes, desde el inicio de un objeto del tipo especificado hasta su subobjeto especificado, incluyendo bits de relleno si los hay.

Dado un objeto o de tipo type con duración de almacenamiento estático, o. member será una expresión constante lvalue que se refiere a un subobjeto de o . De lo contrario, el comportamiento es indefinido. En particular, si member es un miembro de datos estático , un campo de bits , o una función miembro , el comportamiento es indefinido.

Si type no es un PODType (hasta C++11) tipo de diseño estándar (desde C++11) , el resultado de offsetof es indefinido (hasta C++17) el uso de la macro offsetof es condicionalmente soportado (desde C++17) .

La expresión offsetof ( type, member ) nunca es dependiente de tipo y es dependiente de valor si y solo si type es dependiente.

Excepciones

offsetof no lanza excepciones.

Notas

offsetof no se puede implementar en C++ estándar y requiere soporte del compilador: GCC , LLVM .

member no está restringido a un miembro directo. Puede denotar un subobjeto de un miembro dado, como un elemento de un miembro array. Esto está especificado por C DR 496 .

Se especifica en C23 que definir un nuevo tipo que contenga una coma sin paréntesis en offsetof es comportamiento indefinido, y dicho uso generalmente no es compatible con las implementaciones en modos C++: offsetof ( struct Foo { int a, b ; } , a ) es rechazado por todas las implementaciones conocidas.

Ejemplo

#include <cstddef>
#include <iostream>
struct S
{
    char   m0;
    double m1;
    short  m2;
    char   m3;
//  private: int z; // warning: 'S' is a non-standard-layout type
};
int main()
{
    std::cout
        << "offset of char   m0 = " << offsetof(S, m0) << '\n'
        << "offset of double m1 = " << offsetof(S, m1) << '\n'
        << "offset of short  m2 = " << offsetof(S, m2) << '\n'
        << "offset of char   m3 = " << offsetof(S, m3) << '\n';
}

offset of char   m0 = 0
offset of double m1 = 8
offset of short  m2 = 16
offset of char   m3 = 18

Informes de defectos

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

Véase también