offsetof

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Dienstprogramm-Bibliotheken

Sprachunterstützung Typunterstützung (Basistypen, RTTI) Bibliotheks-Feature-Test-Makros (C++20) Programm-Dienstprogramme Variadische Funktionen initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Coroutine-Unterstützung (C++20) Vertragsunterstützung (C++26) Drei-Wege-Vergleich three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Allgemeine Hilfsmittel Funktionsobjekte Bit-Manipulation (C++20) bitset hash (C++11) Relationale Operatoren (in C++20 veraltet) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Ganzzahl-Vergleichsfunktionen cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap und Typ-Operationen swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Gemeinsame Vokabulartypen pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

Typunterstützung

Basistypen
Ganzzahltypen mit fester Breite (C++11)
Gleitkommatypen mit fester Breite (C++23)
ptrdiff_t size_t max_align_t (C++11)     byte (C++17)	nullptr_t (C++11) offsetof NULL
Numerische Grenzwerte
numeric_limits
C-Schnittstelle für numerische Grenzwerte
Laufzeit-Typinformationen
type_info type_index (C++11)	bad_typeid bad_cast

 

Definiert in Header <cstddef>
#define offsetof(typ, glied) /* implementierungsabhängig */

Das Makro offsetof expandiert zu einem ganzzahligen konstanten Ausdruck vom Typ std::size_t, dessen Wert der Offset in Bytes vom Anfang eines Objekts vom angegebenen Typ zu seinem angegebenen Unterobjekt ist, einschließlich Füllbits, falls vorhanden.

Gegeben sei ein Objekt o vom Typ typ und statischer Speicherklasse, dann soll o.glied ein lvalue konstanten Ausdruck sein, der sich auf ein Unterobjekt von o bezieht. Andernfalls ist das Verhalten undefiniert. Insbesondere, wenn glied ein statisches Datenelement, ein Bitfeld oder eine Memberfunktion ist, ist das Verhalten undefiniert.

Wenn typ kein PODType(bis C++11)Typ mit Standardlayout(seit C++11) ist, ist das Ergebnis von offsetof undefiniert(bis C++17)ist die Verwendung des offsetof Makros bedingt unterstützt(seit C++17).

Der Ausdruck offsetof(typ, glied) ist niemals typunabhängig und ist nur dann wertabhängig, wenn typ abhängig ist.

Ausnahmen

offsetof löst keine Ausnahmen aus.

Der Ausdruck noexcept(offsetof(typ, glied)) evaluiert immer zu true.

(seit C++11)

Hinweise

Der Offset des ersten Glieds eines Typs mit Standardlayout ist immer Null (die Empty-Base Optimization ist obligatorisch).

(seit C++11)

offsetof kann nicht in Standard-C++ implementiert werden und erfordert Compilerunterstützung: GCC, LLVM.

glied ist nicht auf ein direktes Glied beschränkt. Es kann ein Unterobjekt eines gegebenen Glieds bezeichnen, z. B. ein Element eines Array-Glieds. Dies ist durch C DR 496 spezifiziert.

In C23 ist festgelegt, dass die Definition eines neuen Typs, der ein nicht in Klammern gesetztes Komma in offsetof enthält, undefiniertes Verhalten darstellt, und eine solche Verwendung wird in C++-Modi im Allgemeinen nicht von Implementierungen unterstützt: offsetof(struct Foo { int a, b; }, a) wird von allen bekannten Implementierungen abgelehnt.

Beispiel

Führen Sie diesen Code aus

#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';
}

Mögliche Ausgabe

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

Fehlerberichte

Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

DR	angewendet auf	Verhalten wie veröffentlicht	Korrigiertes Verhalten
CWG 273	C++98	offsetof funktioniert möglicherweise nicht, wenn der unäre operator& überladen ist	muss korrekt funktionieren, auch wenn operator& überladen ist
LWG 306	C++98	das Verhalten war nicht spezifiziert, wenn typ kein PODType war	das Ergebnis ist in diesem Fall undefiniert
LWG 449	C++98	andere Anforderungen an offsetof wurden durch die Auflösung von LWG issue 306 entfernt	wieder hinzugefügt

Siehe auch

size_t	nicht vorzeichenbehafteter Ganzzahltyp, der vom sizeof-Operator zurückgegeben wird (typedef)
is_standard_layout (C++11)	prüft, ob ein Typ ein Standardlayout-Typ ist (Klassenvorlage)
C-Dokumentation für offsetof