CKTIS / C++
offsetof — décalage d’un membre dans un objet
La macro offsetof de <cstddef> détermine le décalage en octets d’un membre depuis le début d’un objet. Elle permet de vérifier la disposition en mémoire, mais son utilisation portable exige un type à disposition standard.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <cstddef>
offsetof(type, member-designator)offsetof(type, member-designator) de <cstddef> produit une expression constante entière de type std::size_t : le décalage en octets du membre indiqué depuis le début d’un objet. Ses arguments sont un type et un désignateur de membre, pas une instance d’objet. C’est une macro ; écrivez offsetof, et non std::offsetof.
Pour une utilisation portable, choisissez un type à disposition standard. La prise en charge des autres types de classe est conditionnelle : une implémentation n’est pas tenue de la fournir. L’appliquer à un membre de données statique ou à une fonction membre entraîne un comportement indéfini. Ne l’appliquez pas aux champs de bits. Un appel valide ne lance pas d’exceptions.
L’alignement peut introduire des octets de remplissage entre les membres. Ne supposez donc pas qu’un décalage est égal à la somme des tailles des membres précédents, ni qu’il a la même valeur sur toutes les plateformes. offsetof à lui seul ne fournit pas de format de sérialisation portable.
L’exemple vérifie std::is_standard_layout_v<Record> et calcule offset à la compilation. Au lieu d’afficher un nombre dépendant de la plateforme, il teste une relation garantie : value se trouve après tag. La sortie attendue est true suivi d’un saut de ligne.
Exemples
#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';
}
Résultat
true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.