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

CKTIS / C++

std::size_t — le type des tailles d’objets

std::size_t est un type entier non signé, défini par l’implémentation, qui peut représenter la taille de tout objet en octets. C’est le type de retour de sizeof et il est déclaré dans <cstddef>. Ne supposez pas une largeur particulière et ne l’utilisez pas pour représenter des valeurs négatives.

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

Syntaxe

#include <cstddef>
std::size_t count = 0;

std::size_t désigne un type entier non signé défini par l’implémentation, suffisamment grand pour contenir la taille de tout objet en octets. Incluez <cstddef> lorsque vous utilisez ce nom. Ce n’est pas un type de classe distinct ; ne supposez pas qu’il signifie toujours unsigned long ou qu’il fait 64 bits.

Les opérateurs sizeof et sizeof... renvoient std::size_t. sizeof indique une taille en octets, et non un nombre d’éléments. Pour un véritable tableau, sizeof(values) / sizeof(values[0]) donne son nombre d’éléments, car la taille d’un tableau correspond au nombre d’éléments multiplié par la taille d’un élément. Cette formule ne fonctionne pas pour un pointeur : appliquer sizeof à un pointeur mesure le pointeur lui-même.

Utilisez std::size_t pour les tailles non négatives et les indices appropriés, et non pour des valeurs représentant une différence négative. Convertir -1 en std::size_t produit la plus grande valeur de ce type, pas un marqueur d’erreur négatif. Vérifiez la plage des données signées avant de les convertir ; le mélange de types signés et non signés demande de l’attention.

L’exemple calcule le nombre d’éléments d’un tableau, puis les additionne en utilisant un indice de type std::size_t. Son résultat ne dépend pas du nombre d’octets occupés par un int. La source fournie est un projet de norme en évolution, et non une édition C++23 figée ; l’exemple est destiné à une vérification locale en mode C++23.

Exemples

#include <cstddef>
#include <iostream>

int main() {
    constexpr int values[] = {4, 7, 9};
    constexpr std::size_t count = sizeof(values) / sizeof(values[0]);
    static_assert(count == 3);

    int total = 0;
    for (std::size_t i = 0; i < count; ++i) {
        total += values[i];
    }

    std::cout << "count=" << static_cast<unsigned int>(count) << ", total=" << total << '\n';
}

Résultat

count=3, total=20

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