Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

offsetof — desplazamiento de un miembro dentro de un objeto

La macro offsetof de <cstddef> determina el desplazamiento en bytes de un miembro desde el inicio de un objeto. Permite comprobar la disposición de la memoria, pero su uso portable requiere un tipo de disposición estándar.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <cstddef>
offsetof(type, member-designator)

offsetof(type, member-designator) de <cstddef> produce una expresión constante entera de tipo std::size_t: el desplazamiento en bytes del miembro indicado desde el inicio de un objeto. Sus argumentos son un tipo y un designador de miembro, no una instancia de objeto. Es una macro; escribe offsetof, no std::offsetof.

Para un uso portable, elige un tipo de disposición estándar. El soporte para otros tipos de clase es condicional: una implementación no tiene por qué proporcionarlo. Aplicarla a un miembro de datos estático o a una función miembro da lugar a un comportamiento indefinido. No la apliques a campos de bits. Una invocación válida no lanza excepciones.

La alineación puede introducir bytes de relleno entre los miembros. Por tanto, no supongas que un desplazamiento equivale a la suma de los tamaños de los miembros anteriores ni que tiene el mismo valor en todas las plataformas. offsetof por sí sola no proporciona un formato de serialización portable.

El ejemplo comprueba std::is_standard_layout_v<Record> y calcula offset en tiempo de compilación. En vez de imprimir un número que depende de la plataforma, comprueba una relación garantizada: value está después de tag. La salida esperada es true seguido de un salto de línea.

Ejemplos

#include <cstddef>
#include <iostream>
#include <type_traits>

struct Record {
    char tag;
    int value;
};

static_assert(std::is_standard_layout_v<Record>);
constexpr std::size_t offset = offsetof(Record, value);
static_assert(offset >= sizeof(char));
static_assert(noexcept(offsetof(Record, value)));

int main() {
    std::cout << std::boolalpha
              << (offset >= sizeof(char)) << '\n';
}

Resultado

true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes