std:: tie
|
Défini dans l'en-tête
<tuple>
|
||
|
template
<
class
...
Types
>
std:: tuple < Types & ... > tie ( Types & ... args ) noexcept ; |
(depuis C++11)
(constexpr depuis C++14) |
|
Crée un tuple de références de lvalue vers ses arguments ou des instances de std::ignore .
Table des matières |
Paramètres
| args | - | zéro ou plusieurs arguments lvalue pour construire le tuple. |
Valeur de retour
Un objet std::tuple contenant des références lvalue.
Implémentation possible
template <typename... Args> constexpr // depuis C++14 std::tuple<Args&...> tie(Args&... args) noexcept { return {args...}; } |
Notes
std::tie
peut être utilisé pour déballer une
std::pair
car
std::tuple
possède une
affectation de conversion
depuis les paires :
bool result; std::tie(std::ignore, result) = set.insert(value);
Exemple
1)
std::tie
peut être utilisé pour introduire une comparaison lexicographique dans une structure ou pour déballer un tuple ;
2)
std::tie
peut fonctionner avec
les liaisons structurées
:
#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 { // compares lhs.n to rhs.n, // then lhs.s to rhs.s, // then lhs.d to rhs.d // in that order, first non-equal result is returned // or false if all elements are equal return std::tie(lhs.n, lhs.s, lhs.d) < std::tie(rhs.n, rhs.s, rhs.d); } }; int main() { // Lexicographical comparison demo: std::set<S> set_of_s; S value{42, "Test", 3.14}; std::set<S>::iterator iter; bool is_inserted; // Unpack a pair: std::tie(iter, is_inserted) = set_of_s.insert(value); assert(is_inserted); // std::tie and 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); // reuse x, y with tie assert(x == 2 && y == 4); // Implicit conversions are permitted: std::tuple<char, short> coordinates(6, 9); std::tie(x, y) = coordinates; assert(x == 6 && y == 9); // Skip an element: std::string z; std::tie(x, std::ignore, z) = std::tuple(1, 2.0, "Test"); assert(x == 1 && z == "Test"); }
Voir aussi
| Liaison structurée (C++17) | lie les noms spécifiés aux sous-objets ou éléments de tuple de l'initialiseur |
|
(C++11)
|
crée un objet
tuple
du type défini par les types d'arguments
(modèle de fonction) |
|
(C++11)
|
crée un
tuple
de
références de transfert
(modèle de fonction) |
|
(C++11)
|
crée un
tuple
en concaténant n'importe quel nombre de tuples
(modèle de fonction) |
|
(C++11)
|
espace réservé pour ignorer un élément lors du déballage d'un
tuple
en utilisant
tie
(constante) |