Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C++

alignof — exigence d’alignement d’un type

L’opérateur alignof interroge à la compilation l’exigence d’alignement d’un type, en octets. Il renvoie une valeur de type std::size_t, et non la taille de l’objet. Pour un tableau, il indique l’alignement de ses éléments ; pour un type référence, celui du type référencé.

Version : C++23; repository compiler flag, production runtime not attested

Syntaxe

alignof(type-id)

alignof(T) indique l’exigence d’alignement de T en tant que type d’objet complet. L’alignement limite les adresses auxquelles les objets peuvent être placés ; une valeur plus grande correspond à une exigence plus stricte. Les valeurs concrètes dépendent de l’implémentation : ne supposez pas que alignof(int) vaut toujours 4.

L’opérande doit désigner un type d’objet complet, un tableau de tels éléments ou une référence à l’un de ces types. void, les types fonction et les classes incomplètes ne sont pas autorisés. Les parenthèses sont obligatoires. Le C++ standard attend ici un type, et non une expression : pour une variable x, utilisez alignof(decltype(x)), pas alignof(x).

Le résultat est une prvalue de type std::size_t et une expression constante entière ; il convient donc à constexpr et static_assert. Pour un tableau, le résultat est l’alignement de l’élément ; pour une référence, c’est celui du type référencé. L’opérateur lui-même ne nécessite aucun en-tête ; <cstddef> déclare le nom std::size_t.

Ne confondez pas la requête alignof(T) avec sizeof(T), qui indique la taille, ni avec alignas(T), qui spécifie l’alignement d’une entité déclarée. alignof ne modifie pas l’alignement et ne vérifie pas une adresse particulière. L’exemple compare des relations garanties au lieu d’afficher des nombres dépendant de la plateforme. Les sources fournies sont un brouillon de travail mis à jour en continu, et non une édition figée de C++23.

Exemples

#include <cstddef>
#include <iostream>

int main() {
    constexpr std::size_t alignment = alignof(int);
    static_assert(alignof(int[4]) == alignment);
    static_assert(alignof(int&) == alignment);

    std::cout << std::boolalpha
              << (alignof(int[4]) == alignment) << '\n'
              << (alignof(int&) == alignment) << '\n';
}

Résultat

true
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.

Sources