std::size_t

typedef /* implementation-defined */ size_t;

std::size_t ist der vorzeichenlose Ganzzahltyp des Ergebnisses der folgenden Operatoren:

• sizeof

Wenn ein Programm versucht, einen übermäßig großen Typ zu bilden (d.h. die Anzahl der Bytes in seiner Objektdarstellung den maximalen Wert überschreitet, der in std::size_t darstellbar ist), ist das Programm fehlerhaft.

Hinweise

std::size_t kann die maximale Größe eines theoretisch möglichen Objekts beliebigen Typs (einschließlich Arrays) speichern. Auf vielen Plattformen (eine Ausnahme sind Systeme mit segmentierter Adressierung) kann std::size_t sicher den Wert jedes Nicht-Member-Zeigers speichern, in welchem Fall es synonym mit std::uintptr_t ist.

std::size_t wird häufig für Array-Indizierung und Schleifenzählung verwendet. Programme, die andere Typen wie unsigned int für die Array-Indizierung verwenden, können beispielsweise auf 64-Bit-Systemen fehlschlagen, wenn der Index UINT_MAX überschreitet oder wenn er von 32-Bit-modularer Arithmetik abhängt.

Beim Indizieren von C++-Containern, wie std::string , std::vector , etc., ist der geeignete Typ der verschachtelte Typ size_type , der von solchen Containern bereitgestellt wird. Er ist üblicherweise als Synonym für std::size_t definiert.

Es ist nicht spezifiziert, ob die Deklaration von std::size_t in anderen Standardbibliothek-Headern verfügbar ist. Eine Implementierung kann vermeiden, diesen Namen einzuführen, selbst wenn der Standard die Verwendung von std::size_t vorschreibt.

Beispiel

#include <array>
#include <cstddef>
#include <iostream>
int main()
{
    std::array<std::size_t, 10> a;
    // Beispiel mit C++23 std::size_t Literal
    for (auto i = 0uz; i != a.size(); ++i)
        std::cout << (a[i] = i) << ' ';
    std::cout << '\n';
    // Beispiel einer absteigenden Schleife
    for (std::size_t i = a.size(); i--;)
        std::cout << a[i] << ' ';
    std::cout << '\n';
    // Beachten Sie, dass die naive absteigende Schleife:
    //  for (std::size_t i = a.size() - 1; i >= 0; --i) ...
    // eine Endlosschleife ist, weil vorzeichenlose Zahlen immer nicht-negativ sind
}

0 1 2 3 4 5 6 7 8 9
9 8 7 6 5 4 3 2 1 0

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

1. ↑ Die Definition von std::size_t war exakt dieselbe wie die Definition von size_t in C, welche "der Ergebnistyp von sizeof " ist. Es gibt keine zirkuläre Definition in C, da der Ergebnistyp von sizeof in C ein implementierungsdefinierter vorzeichenloser Ganzzahltyp ist.

Referenzen

Siehe auch