std::tuple

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de servicios

Apoyo del lenguaje Apoyo de tipos (tipos básicos, RTTI) Biblioteca de macros de prueba de característica(C++20) Servicios del programa Apoyo de corrutinas(C++20) Funciones variádicas is_constant_evaluated (C++20) is_within_lifetime (C++26) initializer_list (C++11) source_location (C++20) Comparación de tres vías three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Servicios generales Objetos función Manipulación de bits(C++20) bitset hash (C++11) Operadores relacionales(en desuso en C++20) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Funciones de comparación de enteros cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Intercambio y operaciones de tipos swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Tipos vocabulario comunes pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::tuple

Funciones miembro

tuple::tuple

tuple::operator=

tuple::swap

Funciones no miembro

make_tuple

tie

forward_as_tuple

tuple_cat

operator==operator!=operator<operator<=operator>operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)

std::swap

get

Guías de deducción(C++17)

Clases asistentes

tuple_size

tuple_element

uses_allocator

ignore

 

Definido en el archivo de encabezado <tuple>
template<class... Types> class tuple;		(desde C++11)

La plantilla de clase std::tuple es una colección de tamaño fijo de valores heterogéneos. Es una generalización de std::pair.

Si (std::is_trivially_destructible_v<Types>&& ...) es true, el destructor de tuple es trivial.

(desde C++17)

Parámetros de plantilla

Types...

-

Los tipos de elementos que la tupla almacena. Se soporta una lista vacía.

Funciones miembro

(constructor)	Construye una nueva tupla (función miembro pública)
operator=	Asigna el contenido de una tupla a otra. (función miembro pública)
swap	Intercambia el contenido de dos tuplas. (función miembro pública)

Funciones no miembro

make_tuple	Crea un objeto de tupla del tipo definido por los tipos de argumentos. (plantilla de función)
tie	Crea una tupla de referencias lvalue o desempaca una tupla en objetos individuales. (plantilla de función)
forward_as_tuple	Crea una tupla de referencias r-valor. (plantilla de función)
tuple_cat	Crea una tupla mediante la concatenación de cualquier número de tuplas. (plantilla de función)
std::get(std::tuple)	La tupla accede al elemento especificado. (plantilla de función)
operator==operator!=operator<operator<=operator>operator>=	Compara lexicográficamente los valores de la tupla (plantilla de función)
std::swap(std::tuple) (C++11)	Especializa el algoritmo std::swap. (plantilla de función)

Clases asistentes

tuple_size	Obtiene el tamaño de una tupla en tiempo de compilación. (especialización de plantilla de clase)
tuple_element	Obtiene el tipo del elemento especificado. (especialización de plantilla de clase)
std::uses_allocator<std::tuple> (C++11)	Especializa el rasgo de tipo std::uses_allocator. (especialización de plantilla de clase)
ignore	Marcador de posición para saltarse un elemento cuando se desempaca una tupla utilizando tie. (constante)

Notas

Hasta N4387 (aplicado como un informe de defecto de C++11), una función no podía devolver una tupla usando inicialización de lista de copia:

std::tuple<int, int> foo_tuple(){return{1, -1};// ERROR hasta N4387return std::tuple<int, int>{1, -1};// siempre funcionareturnstd::make_tuple(1, -1);// siempre funciona}

Ejemplo

Ejecuta este código

#include <tuple>#include <iostream>#include <string>#include <stdexcept>   std::tuple<double, char, std::string> captar_estudiante(int id){if(id ==0)returnstd::make_tuple(3.8, 'A', "Alicia Alderete");if(id ==1)returnstd::make_tuple(2.9, 'C', "Benito Barajas");if(id ==2)returnstd::make_tuple(1.7, 'D', "Carlos Cabello");throwstd::invalid_argument("id");}   int main(){auto estudiante0 = captar_estudiante(0);std::cout<<"ID: 0, "<<"PROM: "<<std::get<0>(estudiante0)<<", "<<"calif: "<<std::get<1>(estudiante0)<<", "<<"nombre: "<<std::get<2>(estudiante0)<<'\n';   double prom1;char calif1;std::string name1;std::tie(prom1, calif1, nombre1)= captar_estudiante(1);std::cout<<"ID: 1, "<<"PROM: "<< prom1 <<", "<<"calif: "<< calif1 <<", "<<"name: "<< nombre1 <<'\n';   // C++17: vínculo estructuradoauto[ prom2, calif2, nombre2 ]= captar_estudiante(2);std::cout<<"ID: 2, "<<"PROM: "<< nombre <<", "<<"calif: "<< calif2 <<", "<<"nombre: "<< nombre2 <<'\n';}

Salida:

ID: 0, PROM: 3.8, calif: A, nombre: Alicia Alderete ID: 1, PROM: 2.9, calif: C, nombre: Benito Barajas ID: 2, PROM: 1.7, calif: D, nombre: Carlos Cabello

Referencias

• El estándar C++17 (ISO/IEC 14882:2017):

• 23.5 Tuples [tuple]

• El estándar C++14 (ISO/IEC 14882:2014):

• 20.4 Tuples [tuple]

• El estándar C++11 (ISO/IEC 14882:2011):

• 20.4 Tuples [tuple]