std::ranges::empty
De es.cppreference.net
| Definido en el encabezado <ranges>
|
||
| Definido en el encabezado <iterator>
|
||
inline namespace /*unspecified*/ {
inline constexpr auto empty = /*unspecified*/;
}
|
(desde C++20) (objeto de punto de personalización) |
|
| Firma de llamada |
||
template< class T >
requires /* see below */
constexpr bool empty( T&& t );
|
(desde C++20) | |
Determina si t tiene algún elemento o no.
Una llamada a ranges::empty es expression-equivalent a:
bool(t.empty()), si esa expresión es válida.- De lo contrario,
(ranges::size(t) == 0), si esa expresión es válida. - De lo contrario,
bool(ranges::begin(t) == ranges::end(t)), si esa expresión es válida ydecltype(ranges::begin(t))modela std::forward_iterator.
En todos los demás casos, una llamada a ranges::empty está mal formada, lo que puede resultar en fallo de sustitución cuando ranges::empty(t) aparece en el contexto inmediato de una instanciación de plantilla.
Objetos de punto de personalización
El nombre
ranges::empty
denota un
objeto de punto de personalización
, que es un
objeto función
constante de un tipo de clase
literal
semiregular
. Consulte
CustomizationPointObject
para más detalles.
Ejemplo
Ejecutar este código
#include <iostream> #include <ranges> #include <vector> template<std::ranges::input_range R> void print(char id, R&& r) { if (std::ranges::empty(r)) { std::cout << '\t' << id << ") Vacío\n"; return; } std::cout << '\t' << id << ") Elementos:"; for (const auto& element : r) std::cout << ' ' << element; std::cout << '\n'; } int main() { { auto v = std::vector<int>{1, 2, 3}; std::cout << "(1) ranges::empty utiliza std::vector::empty:\n"; print('a', v); v.clear(); print('b', v); } { std::cout << "(2) ranges::empty utiliza ranges::size(initializer_list):\n"; auto il = {7, 8, 9}; print('a', il); print('b', std::initializer_list<int>{}); } { std::cout << "(2) ranges::empty en un array crudo utiliza ranges::size:\n"; int array[] = {4, 5, 6}; // array tiene un límite conocido print('a', array); } { struct Scanty : private std::vector<int> { using std::vector<int>::begin; using std::vector<int>::end; using std::vector<int>::push_back; // Nota: tanto empty() como size() están ocultos }; std::cout << "(3) llamando a ranges::empty en un objeto sin empty() o size():\n"; Scanty y; print('a', y); y.push_back(42); print('b', y); } }
Salida:
(1) ranges::empty utiliza std::vector::empty:
a) Elementos: 1 2 3
b) Vacío
(2) ranges::empty utiliza ranges::size(initializer_list):
a) Elementos: 7 8 9
b) Vacío
(2) ranges::empty en un array crudo utiliza ranges::size:
a) Elementos: 4 5 6
(3) llamando a ranges::empty en un objeto sin empty() o size():
a) Vacío
b) Elementos: 42
Véase también
|
(C++17)
|
comprueba si el contenedor está vacío
(plantilla de función) |