La classe QPair est une classe template qui sert à stocker une paire d’éléments. Plus d'informations...

#include <QPair>

La classe QPair est une classe patron qui sert à stocker une paire d’éléments.

QPair<T1, T2> peut être utilisée dans vos applications si la classe std::pair de la STL n’est pas disponible. Elle stocke une valeur de type T1 et une valeur de type T2. Elle peut être utilisée en tant que valeur de retour d’une fonction devant renvoyer deux valeurs ou en tant que type de valeur d’un conteneur générique.

Voici un exemple d’une QPair stockant une QString et un double :

QPair<QString, double> pair;

Les composantes sont accessibles grâce aux attributs publics nommés first (premier élément) et second (second élément). Par exemple :

pair.first = "pi";
pair.second = 3.14159265358979323846;

Les types de données patron de QPair (T1 et T2) doivent être des types de données assignables. Vous ne pouvez pas, par exemple, stocker un QWidget en tant que valeur ; utilisez QWidget * à la place. Quelques fonctions membres ont encore d’autres exigences ; ces exigences sont précisées pour chaque fonction.

Voir aussi Conteneurs génériques.

typedef QPair::first_type

Le type du premier élément de la paire (T1).

Voir aussi first.

typedef QPair::second_type

Le type du second élément de la paire (T2).

Voir aussi second.

QPair::QPair()

Construit une paire vide. Les éléments first et second sont initialisés avec des valeurs de construction par défaut.

QPair::QPair(const T1 & value1, const T2 & value2)

Construit une paire et initialise l’élément first avec value1 et l’élément second avec value2.

Voir aussi qMakePair().

QPair<T1, T2> & QPair::operator= (const QPair<T1, T2> & other)

Assigne other à la paire.

T1 QPair::first

Le premier élément de la paire.

T2 QPair::second

Le second élément de la paire.

QPair<T1, T2> qMakePair ( const T1 & value1, const T2 & value2 )

Retourne un QPair contenant value1 et value2. Exemple :

QList<QPair<int, double> > liste;
liste.append(qMakePair(66, 3.14159));

Ceci est équivalent à QPair<T1, T2>(value1, value2), mais nécessite moins de code.

bool operator!= ( const QPair<T1, T2> & p1, const QPair<T1, T2> & p2 )

Renvoie true si p1 est différent de p2 ; sinon renvoie false. Deux paires ne sont pas égales si leurs éléments respectifs first ou second ne sont pas égaux.

Cette fonction nécessite une implémentation de operator==() pour T1 et T2.

bool operator< ( const QPair<T1, T2> & p1, const QPair<T1, T2> & p2 )

Renvoie true si p1 est inférieur à p2 ; sinon renvoie false. Cette comparaison est effectuée entre les attributs first de p1 et p2 ; s’ils sont égaux, les attributs second seront comparés pour trancher.

Cette fonction nécessite une implémentation de operator<() pour T1 et T2.

QDataStream & operator« ( QDataStream & out, const QPair<T1, T2> & pair )

Ecrit la paire pair dans le flux out.

Cette fonction nécessite une implémentation de operator«() pour T1 et T2.

Voir aussi Format des opérateurs de QDataStream.

bool operator⇐ ( const QPair<T1, T2> & p1, const QPair<T1, T2> & p2 )

Renvoie true si p1 est inférieur ou égal à p2 ; sinon renvoie false. La comparaison est effectuée entre les attributs first de p1 et p2 ; s’ils sont égaux, les attributs second seront comparés pour trancher.

Cette fonction nécessite une implémentation de operator<() pour T1 et T1.

bool operator== ( const QPair<T1, T2> & p1, const QPair<T1, T2> & p2 )

Renvoie true si p1 est égal à p2 ; sinon renvoie false. Deux paires sont égales si leurs attributs respectifs first et second sont égaux.

Cette fonction nécessite une implémentation de operator==() pour T1 et T2.

bool operator> ( const QPair<T1, T2> & p1, const QPair<T1, T2> & p2 )

Renvoie true si p1 est supérieur à p2 ; sinon renvoie false. La comparaison est effectuée entre les attributs first de p1 et p2 ; s’ils sont égaux, leur attribut second est comparé pour trancher.

Cette fonction nécessite une implémentation de operator<() pour T1 et T2.

bool operator>= ( const QPair<T1, T2> & p1, const QPair<T1, T2> & p2 )

Renvoie true si p1 est supérieur ou égal à p2 ; sinon renvoie false. La comparaison est effectuée entre les attributs first de p1 et p2 ; s’ils sont égaux, leur attribut second est comparé pour trancher.

Cette fonction nécessite une implémentation de operator<() pour T1 et T2.

QDataStream & operator» ( QDataStream & in, QPair<T1, T2> & pair )

Ecrit une paire dans pair à partir du flux in.

Cette fonction nécessite une implémentation de operator»() pour T1 et T2.

Voir aussi Format des opérateurs de QDataStream.

Merci à Olivier Strebler pour la traduction et à <!johnlamericain!> ainsi qu’à <!hornetbzz!> pour leur relecture !