CKTIS / C++
std::size_t — typ rozmiarów obiektów
std::size_t to zdefiniowany przez implementację typ całkowity bez znaku, który może reprezentować rozmiar dowolnego obiektu w bajtach. Jest typem wyniku sizeof; deklarację udostępnia nagłówek <cstddef>. Nie należy zakładać konkretnej szerokości ani używać go do wartości ujemnych.
Wersja: C++23; repository compiler flag, production runtime not attested
Składnia
#include <cstddef>
std::size_t count = 0;std::size_t jest nazwą typu całkowitego bez znaku, zdefiniowanego przez implementację i wystarczająco dużego, aby pomieścić rozmiar dowolnego obiektu w bajtach. Dołącz <cstddef>, gdy używasz tej nazwy. Nie jest to odrębny typ klasowy; nie zakładaj, że zawsze oznacza unsigned long albo ma 64 bity.
Operatory sizeof i sizeof... zwracają std::size_t. sizeof podaje rozmiar w bajtach, a nie liczbę elementów. Dla rzeczywistej tablicy sizeof(values) / sizeof(values[0]) daje liczbę elementów, ponieważ rozmiar tablicy jest iloczynem liczby elementów i rozmiaru elementu. Ten wzór nie działa dla wskaźnika: sizeof wskaźnika mierzy sam wskaźnik.
Używaj std::size_t do nieujemnych rozmiarów i odpowiednich indeksów, nie do wartości oznaczających ujemną różnicę. Konwersja -1 do std::size_t daje największą wartość tego typu, a nie ujemny znacznik błędu. Przed konwersją danych ze znakiem sprawdzaj ich zakres; mieszanie typów ze znakiem i bez znaku wymaga uwagi.
Przykład oblicza liczbę elementów tablicy, a następnie sumuje je, używając indeksu typu std::size_t. Wynik nie zależy od liczby bajtów zajmowanych przez int. Podane źródło jest rozwijanym szkicem standardu, a nie zamrożonym wydaniem C++23; przykład jest przeznaczony do lokalnej weryfikacji w trybie C++23.
Przykłady
#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';
}
Wynik
count=3, total=20
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.