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.