std::size, std::ssize - cppreference.com
De cppreference.com
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
| Definido en el archivo de encabezado |
||
|
(1) | (desde C++17) |
|
(2) | (desde C++20) |
|
(3) | (desde C++17) |
|
(4) | (desde C++20) |
Devuelve el tamaño de un rango dado.
1, 2) Devuelve c.size(), convertido al tipo de retorno si es necesario.
3, 4) Devuelve N.
Parámetros
| c | - | Un contenedor o vista con una función miembro size.
|
| array | - | Un array de tipo arbitrario. |
Valor de retorno
1) c.size(),
2) static_cast<std::common_type_t<std::ptrdiff_t,std::make_signed_t<decltype(c.size())>>>(c.size()).
3,4) N.
Excepciones
1,2) Puede lanzar excepciones definidas por la implementación.
Sobrecargas
Se pueden proporcionar sobrecargas personalizadas de size para clases y enumeraciones que no exponen una función miembro size() adecuada, pero que se pueden detectar.
|
Las sobrecargas de |
(desde C++20) |
Posible implementación
| size (1) |
|---|
template<class C> constexpr auto size(const C& c) -> decltype(c.size()) { return c.size(); } |
| ssize (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()); } |
| size (3) |
template<class T, std::size_t N> constexpr std::size_t size(const T (&array)[N]) noexcept { return N; } |
| ssize (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ística | Valor | Estándar | Comentario |
|---|---|---|---|
__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 integrados int a[]{-5, 10, 15}; // Devuelve el número de elementos (no bytes) en lugar de sizeof assert(std::size(a) == 3); std::cout << "tamaño de a[]: " << sizeof a << '\n'; // 12, if sizeof(int) == 4 // Proporciona una forma segura (en comparación con sizeof) // de obtener el tamaño del búfer de cadena const char str[] = "12345"; // Estos están bien y dan el resultado correcto. 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 no se compila std::cout << sizeof(str_decayed) << '\n'; // ¡Imprime el tamaño del puntero! // Desde C++20 el tamaño con signo (std::ssize) está disponible auto i = std::ssize(v); for (--i; i != -1; --i) std::cout << v[i] << (i ? ' ' : '\n'); assert(i == -1); // Ten en cuenta que el literal de cadena incluye el carácter nulo final, que // será parte del array de caracteres construida. Esto hace que std::size // se comporte de manera 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); }
Posible salida:
tamaño de a[]: 12 8 4 1 3
Véase también
| Tipo entero con signo devuelto al restar dos punteros. (typedef) [editar] | |
| Tipo entero sin signo devuelto por el operador sizeof. (typedef) [editar] | |
| Obtiene el tamaño de un rango cuyo tamaño puede calcularse en tiempo constante. (objeto punto de personalización) [editar] | |
| Obtiene el tamaño de un rango cuyo tamaño puede calcularse en tiempo constante y lo convierte a un entero con signo. (objeto punto de personalización) [editar] |