WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::size_t — der Typ für Objektgrößen

std::size_t ist ein implementierungsdefinierter vorzeichenloser Ganzzahltyp, der die Größe jedes Objekts in Bytes darstellen kann. Er ist der Ergebnistyp von sizeof und wird in <cstddef> deklariert. Gehen Sie weder von einer bestimmten Breite aus noch verwenden Sie ihn für negative Werte.

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

Syntax

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

std::size_t bezeichnet einen implementierungsdefinierten vorzeichenlosen Ganzzahltyp, der groß genug ist, um die Größe jedes Objekts in Bytes aufzunehmen. Binden Sie <cstddef> ein, wenn Sie diesen Namen verwenden. Es handelt sich nicht um einen eigenen Klassentyp; nehmen Sie nicht an, dass er immer unsigned long bedeutet oder 64 Bit breit ist.

Die Operatoren sizeof und sizeof... liefern std::size_t. sizeof gibt eine Größe in Bytes an, nicht die Anzahl der Elemente. Für ein echtes Array ergibt sizeof(values) / sizeof(values[0]) die Elementanzahl, da die Arraygröße dem Produkt aus Elementanzahl und Größe eines Elements entspricht. Bei einem Zeiger funktioniert diese Formel nicht: sizeof auf einen Zeiger misst den Zeiger selbst.

Verwenden Sie std::size_t für nichtnegative Größen und geeignete Indizes, nicht für Werte, die eine negative Differenz darstellen. Die Umwandlung von -1 in std::size_t ergibt den größten Wert dieses Typs und keinen negativen Fehlerwert. Prüfen Sie vor der Umwandlung den Wertebereich vorzeichenbehafteter Eingaben; beim Mischen vorzeichenbehafteter und vorzeichenloser Typen ist Vorsicht nötig.

Das Beispiel berechnet die Elementanzahl eines Arrays und summiert anschließend seine Elemente mit einem Index vom Typ std::size_t. Die Ausgabe hängt nicht davon ab, wie viele Bytes ein int belegt. Die bereitgestellte Quelle ist ein fortlaufend weiterentwickelter Standardentwurf und keine eingefrorene C++23-Ausgabe; das Beispiel ist zur lokalen Überprüfung im C++23-Modus vorgesehen.

Beispiele

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

Ergebnis

count=3, total=20

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen