std::size, std::ssize
| Definido en el encabezado <array>
|
||
| Definido en el encabezado <deque>
|
||
| Definido en el encabezado <flat_map>
|
(since C++23) |
|
| Definido en el encabezado <flat_set>
|
(since C++23) |
|
| Definido en el encabezado <forward_list>
|
||
| Definido en el encabezado <inplace_vector>
|
(since C++26) |
|
| Definido en el encabezado <iterator>
|
||
| Definido en el encabezado <list>
|
||
| Definido en el encabezado <map>
|
||
| Definido en el encabezado <optional>
|
(since C++26) |
|
| Definido en el encabezado <regex>
|
||
| Definido en el encabezado <set>
|
||
| Definido en el encabezado <span>
|
(since C++20) |
|
| Definido en el encabezado <stacktrace>
|
(since C++23) |
|
| Definido en el encabezado <string>
|
||
| Definido en el encabezado <string_view>
|
||
| Definido en el encabezado <unordered_map>
|
||
| Definido en el encabezado <unordered_set>
|
||
| Definido en el encabezado <valarray>
|
||
| Definido en el encabezado <vector>
|
||
template< class C >
constexpr auto size( const C& c ) noexcept(noexcept(c.size()))
-> decltype(c.size());
|
(1) | (since C++17) |
template< class C >
constexpr auto ssize( const C& c ) noexcept(noexcept(c.size()))
-> std::common_type_t<std::ptrdiff_t,
std::make_signed_t<decltype(c.size())>>;
|
(2) | (since C++20) |
template< class T, std::size_t N >
constexpr std::size_t size( const T (&array)[N] ) noexcept;
|
(3) | (since C++17) |
template< class T, std::ptrdiff_t N >
constexpr std::ptrdiff_t ssize( const T (&array)[N] ) noexcept;
|
(4) | (since C++20) |
Devuelve el tamaño del rango dado.
c.size(), convertido al tipo de retorno si es necesario.N.Parámetros
| c | - |
un contenedor o vista con una función miembro
size
|
| array | - | un array de tipo arbitrario |
Valor de retorno
std:: make_signed_t < decltype ( c. size ( ) ) >>> ( c. size ( ) )
Excepciones
Sobrecargas
Se pueden proporcionar sobrecargas personalizadas de
size
para clases y enumeraciones que no exponen una función miembro
size()
adecuada, pero que pueden ser detectadas.
|
Las sobrecargas de
|
(desde C++20) |
Implementación posible
| tamaño (1) |
|---|
template<class C> constexpr auto size(const C& c) -> decltype(c.size()) { return c.size(); } |
| tamaño con signo (2) |
template<class C> constexpr auto ssize(const C& c) -> std::common_type_t<std::ptrdiff_t, std::make_signed_t<decltype(c.size())>> { using R = std::common_type_t<std::ptrdiff_t, std::make_signed_t<decltype(c.size())>>; return static_cast<R>(c.size()); } |
| tamaño (3) |
template<class T, std::size_t N> constexpr std::size_t size(const T (&array)[N]) noexcept { return N; } |
| tamaño con signo (4) |
template<class T, std::ptrdiff_t N> constexpr std::ptrdiff_t ssize(const T (&array)[N]) noexcept { return N; } |
Notas
| Macro de prueba de características | Valor | Std | Característica |
|---|---|---|---|
__cpp_lib_nonmember_container_access
|
201411L
|
(C++17) |
std::size()
,
std::data
y
std::empty
|
__cpp_lib_ssize
|
201902L
|
(C++20) |
std::ssize()
(
2,4
)
y
std::span::size()
sin signo
|
Ejemplo
#include <cassert> #include <cstring> #include <iostream> #include <vector> int main() { // Funciona con contenedores std::vector<int> v{3, 1, 4}; assert(std::size(v) == 3); // Y también funciona con arrays incorporados int a[]{-5, 10, 15}; // Retorna el número de elementos (no bytes) a diferencia de sizeof assert(std::size(a) == 3); std::cout << "size of a[]: " << sizeof a << '\n'; // 12, si sizeof(int) == 4 // Proporciona una forma segura (comparada con sizeof) de obtener el tamaño del búfer de cadena const char str[] = "12345"; // Estos funcionan correctamente y dan el resultado adecuado assert(std::size(str) == 6); assert(sizeof(str) == 6); // Pero el uso de sizeof aquí es una fuente común de errores const char* str_decayed = "12345"; // std::cout << std::size(str_decayed) << '\n'; // Útilmente falla al compilar std::cout << sizeof(str_decayed) << '\n'; // ¡Imprime el tamaño del puntero! // Desde C++20 está disponible el tamaño con signo (std::ssize) auto i = std::ssize(v); for (--i; i != -1; --i) std::cout << v[i] << (i ? ' ' : '\n'); assert(i == -1); // Nótese que el literal de cadena incluye el carácter nulo final, el cual // formará parte del array de caracteres construido. Esto hace que std::size // se comporte de forma diferente a std::strlen y std::string::size: constexpr char symbols[] = "0123456789"; static_assert(std::size(symbols) == 11); static_assert(std::string(symbols).size() == 10); assert(std::strlen(symbols) == 10); }
Salida posible:
size of a[]: 12 8 4 1 3
Informe de defectos
Los siguientes informes de defectos que modifican el comportamiento se aplicaron retroactivamente a estándares C++ publicados anteriormente.
| DR | Aplicado a | Comportamiento según lo publicado | Comportamiento correcto |
|---|---|---|---|
| P3016R6 | C++17 C++20 |
1) std::size no era necesario propagar la especificación de excepción2) std::ssize no era necesario propagar la especificación de excepción
|
requerido |
Véase también
|
tipo entero con signo devuelto al restar dos punteros
(typedef) |
|
|
tipo entero sin signo devuelto por el operador
sizeof
(typedef) |
|
|
(C++20)
|
devuelve un entero igual al tamaño de un rango
(customization point object) |
|
(C++20)
|
devuelve un entero con signo igual al tamaño de un rango
(customization point object) |