std::size_t

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов(C++20)

Библиотека метапрограммирования(C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов(C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения(C++11)

Атомарные операции(C++11)

Библиотека поддержки конкуренции(C++11)

Библиотека файловой системы(C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека метапрограммирования

Свойства типов
Категории типов is_void (C++11) is_null_pointer (C++14)   is_array (C++11) is_pointer (C++11) is_enum (C++11) is_union (C++11) is_class (C++11) is_function (C++11) is_object (C++11) is_scalar (C++11) is_compound (C++11) is_integral (C++11) is_floating_point (C++11)   is_fundamental (C++11) is_arithmetic (C++11) is_reference (C++11) is_lvalue_reference (C++11) is_rvalue_reference (C++11) is_member_pointer (C++11) is_member_object_pointer (C++11) is_member_function_pointer (C++11) Свойства типов is_const (C++11) is_volatile (C++11) is_empty (C++11) is_polymorphic (C++11) is_final (C++14) is_abstract (C++11) is_aggregate (C++17) is_implicit_lifetime (C++23) is_trivial (C++11) is_trivially_copyable (C++11) is_standard_layout (C++11) is_literal_type (C++11)(до C++20*) is_pod (C++11)(устарело в C++20) is_signed (C++11) is_unsigned (C++11) is_bounded_array (C++20) is_unbounded_array (C++20) is_scoped_enum (C++23) has_unique_object_representations (C++17) Константы свойств типа integral_constantbool_constanttrue_typefalse_type (C++11)(C++17)(C++11)(C++11) Метафункции conjunction (C++17) disjunction (C++17) negation (C++17)	Поддерживаемые операции is_constructibleis_trivially_constructibleis_nothrow_constructible (C++11)(C++11)(C++11) is_default_constructibleis_trivially_default_constructibleis_nothrow_default_constructible (C++11)(C++11)(C++11) is_copy_constructibleis_trivially_copy_constructibleis_nothrow_copy_constructible (C++11)(C++11)(C++11) is_move_constructibleis_trivially_move_constructibleis_nothrow_move_constructible (C++11)(C++11)(C++11) is_assignableis_trivially_assignableis_nothrow_assignable (C++11)(C++11)(C++11) is_copy_assignableis_trivially_copy_assignableis_nothrow_copy_assignable (C++11)(C++11)(C++11) is_move_assignableis_trivially_move_assignableis_nothrow_move_assignable (C++11)(C++11)(C++11) is_destructibleis_trivially_destructibleis_nothrow_destructible (C++11)(C++11)(C++11) has_virtual_destructor (C++11) is_swappable_withis_swappableis_nothrow_swappable_withis_nothrow_swappable (C++17)(C++17)(C++17)(C++17) Запросы отношений и свойств is_same (C++11) is_base_of (C++11) is_convertibleis_nothrow_convertible (C++11)(C++20) is_layout_compatible (C++20) is_pointer_interconvertible_base_of (C++20) is_pointer_interconvertible_with_class (C++20)   is_corresponding_member (C++20) alignment_of (C++11) rank (C++11) extent (C++11) is_invocableis_invocable_ris_nothrow_invocableis_nothrow_invocable_r (C++17)(C++17)(C++17)(C++17) reference_constructs_from_temporary (C++23) reference_converts_from_temporary (C++23) Модификации типов remove_cvremove_constremove_volatile (C++11)(C++11)(C++11) add_cvadd_constadd_volatile (C++11)(C++11)(C++11) make_signed (C++11) make_unsigned (C++11) remove_reference (C++11) add_lvalue_referenceadd_rvalue_reference (C++11)(C++11) remove_pointer (C++11) add_pointer (C++11) remove_extent (C++11) remove_all_extents (C++11) Преобразования типов aligned_storage (C++11)(устарело в C++23) aligned_union (C++11)(устарело в C++23) decay (C++11) remove_cvref (C++20) enable_if (C++11) void_t (C++17) conditional (C++11) common_type (C++11) common_reference (C++20) underlying_type (C++11) result_ofinvoke_result (C++11)(до C++20*)(C++17) type_identity (C++20)
Рациональная арифметика времени компиляции
Целочисленные последовательности времени компиляции
integer_sequence (C++14)

 

Определено в заголовочном файле <cstddef>
Определено в заголовочном файле <cstdio>
Определено в заголовочном файле <cstdlib>
Определено в заголовочном файле <cstring>
Определено в заголовочном файле <ctime>
Определено в заголовочном файле <cuchar>		(начиная с C++17)
Определено в заголовочном файле <cwchar>
typedef/*определено реализацией*/ size_t;

std::size_t целочисленный тип без знака, являющийся результатом оператора sizeof, а также операторов sizeof... и alignof(начиная с C++11).

Разрядность std::size_t не меньше 16.

(начиная с C++11)

Примечания

size_t может хранить максимальный размер теоретически возможного объекта любого типа (включая массивы). Тип, размер которого не может быть представлен std::size_t, имеет неправильный формат. На большинстве платформ (за исключением систем с адресацией по сегментам) size_t может безопасно хранить значение любого указателя, кроме указателей на элементы классов, таким образом, являясь синонимом std::uintptr_t.

std::size_t обычно используется для индексации массивов и счётчиков циклов. Программы, которые используют другие типы, например unsignedint, для индексации массивов, могут неправильно работать на, например, 64-битных системах, когда индекс превзойдет UINT_MAX или если он основан на 32-битной модульной арифметике.

При индексации C++ контейнеров, таких как std::string, std::vector, и т.д. для индекса используется соответствующий тип, объявленный через typedef size_type в типе контейнера. Обычно этот тип определён как синоним std::size_t.

Суффикс целочисленного литерала для std::size_t представляет собой любую комбинацию z или Z с u или U (например, zu, zU, Zu, ZU, uz, uZ, Uz или UZ).

(начиная с C++23)

Пример

Запустить этот код

#include <cstddef>#include <iostream>#include <array>   int main(){std::array<std::size_t, 10> a;   // Пример с литералом C++23 size_tfor(auto i = 0uz; i != a.size();++i)std::cout<<(a[i]= i)<<' ';std::cout<<'\n';   // Пример декрементирующего циклаfor(std::size_t i = a.size(); i--;)std::cout<< a[i]<<' ';   // Обратите внимание на наивный цикл декрементации:// for (std::size_t i = a.size() - 1; i >= 0; --i) ...// это бесконечный цикл, потому что числа без знака всегда неотрицательны}

Вывод:

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

Ссылки

• C++23 стандарт (ISO/IEC 14882:2023):

• 6.8.4 Составные типы [basic.compound](стр. 79-80)

• 7.6.2.5 Sizeof [expr.sizeof](стр. 136)

• 7.6.2.6 Alignof [expr.alignof](стр. 136)

• 17.2.4 Размеры, выравнивание и смещения [support.types.layout](стр. 504-505)

• C++20 стандарт (ISO/IEC 14882:2020):

• 6.8.3 Составные типы [basic.compound](стр. 75-76)

• 7.6.2.5 Sizeof [expr.sizeof](стр. 129-130)

• 7.6.2.6 Alignof [expr.alignof](стр. 130)

• 17.2.4 Размеры, выравнивание и смещения [support.types.layout](стр. 507-508)

• C++17 стандарт (ISO/IEC 14882:2017):

• 6.9.2 Составные типы [basic.compound](стр. 81-82)

• 8.3.3 Sizeof [expr.sizeof](стр. 121-122)

• 8.3.6 Alignof [expr.alignof](стр. 129)

• 21.2.4 Размеры, выравнивание и смещения [support.types.layout](стр. 479)

• C++14 стандарт (ISO/IEC 14882:2014):

• 3.9.2 Составные типы [basic.compound](стр. 73-74)

• 5.3.3 Sizeof [expr.sizeof](стр. 109-110)

• 5.3.6 Alignof [expr.alignof](стр. 116)

• 18.2 Типы [support.types](стр. 443-444)

• C++11 стандарт (ISO/IEC 14882:2011):

• 5.3.3 Sizeof [expr.sizeof](стр. 111)

• 5.3.6 Alignof [expr.alignof](стр. 116)

• 18.2 Типы [support.types](стр. 454-455)

• C++03 стандарт (ISO/IEC 14882:2003):

• 5.3.3 Sizeof [expr.sizeof](стр. 79)

• C++98 стандарт (ISO/IEC 14882:1998):

• 5.3.3 Sizeof [expr.sizeof](стр. 77)

Смотрите также

ptrdiff_t	знаковый целочисленный тип, возвращаемый при вычитании двух указателей (определение типа)
offsetof	смещение в байтах от начала типа со стандартной компоновкой до указанного элемента (функция-макрос)
целые литералы	десятичное, восьмеричное или шестнадцатеричное число целых (C++11) типа Оригинал: decimal, octal, or hexadecimal numbers of integer type (C++11) Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
Документация C по size_t