std:: tie
|
Definido en el encabezado
<tuple>
|
||
|
template
<
class
...
Types
>
std:: tuple < Types & ... > tie ( Types & ... args ) noexcept ; |
(desde C++11)
(constexpr desde C++14) |
|
Crea una tupla de referencias de lvalue a sus argumentos o instancias de std::ignore .
Contenidos |
Parámetros
| args | - | cero o más argumentos lvalue para construir la tupla. |
Valor de retorno
Un objeto std::tuple que contiene referencias a lvalue.
Implementación posible
template <typename... Args> constexpr // desde C++14 std::tuple<Args&...> tie(Args&... args) noexcept { return {args...}; } |
Notas
std::tie
puede utilizarse para desempaquetar un
std::pair
porque
std::tuple
tiene una
asignación de conversión
desde pares:
bool result; std::tie(std::ignore, result) = set.insert(value);
Ejemplo
1)
std::tie
puede utilizarse para introducir comparación lexicográfica en una estructura o para desempaquetar una tupla;
2)
std::tie
puede funcionar con
structured bindings
:
#include <cassert> #include <iostream> #include <set> #include <string> #include <tuple> struct S { int n; std::string s; float d; friend bool operator<(const S& lhs, const S& rhs) noexcept { // compara lhs.n con rhs.n, // luego lhs.s con rhs.s, // luego lhs.d con rhs.d // en ese orden, se retorna el primer resultado no igual // o false si todos los elementos son iguales return std::tie(lhs.n, lhs.s, lhs.d) < std::tie(rhs.n, rhs.s, rhs.d); } }; int main() { // Demostración de comparación lexicográfica: std::set<S> set_of_s; S value{42, "Test", 3.14}; std::set<S>::iterator iter; bool is_inserted; // Desempaquetar un par: std::tie(iter, is_inserted) = set_of_s.insert(value); assert(is_inserted); // std::tie y structured bindings: auto position = [](int w) { return std::tuple(1 * w, 2 * w); }; auto [x, y] = position(1); assert(x == 1 && y == 2); std::tie(x, y) = position(2); // reutilizar x, y con tie assert(x == 2 && y == 4); // Se permiten conversiones implícitas: std::tuple<char, short> coordinates(6, 9); std::tie(x, y) = coordinates; assert(x == 6 && y == 9); // Omitir un elemento: std::string z; std::tie(x, std::ignore, z) = std::tuple(1, 2.0, "Test"); assert(x == 1 && z == "Test"); }
Véase también
| Structured binding (C++17) | enlaza los nombres especificados a subobjetos o elementos de tupla del inicializador |
|
(C++11)
|
crea un objeto
tuple
del tipo definido por los tipos de argumento
(plantilla de función) |
|
(C++11)
|
crea un
tuple
de
referencias de reenvío
(plantilla de función) |
|
(C++11)
|
crea un
tuple
concatenando cualquier número de tuplas
(plantilla de función) |
|
(C++11)
|
marcador de posición para omitir un elemento al desempaquetar un
tuple
usando
tie
(constante) |