Структура QPair

Класс QPair — это шаблонный класс, хранящий пару элементов. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этой структуре являются реентерабельными.

Публичные типы

Публичные функции

Публичные переменные

Связанные нечлены

Подробное описание

QPair<T1, T2> можно использовать в вашем приложении, если тип STL pair недоступен. Он хранит одно значение типа T1 и одно значение типа T2. Его можно использовать в качестве значения возврата функции, которой нужно вернуть два значения, или в качестве типа значения обобщенного контейнера.

Вот пример QPair, хранящий одну строку QString и одно значение double:

QPair<QString, double> pair;

Компоненты доступны как публичные данные-члены, называемые first и second. Например:

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

Однако, практически всегда предпочтительнее определить небольшую структуру для хранения результата функции с несколькими значениями возврата. Структура тривиально обобщается на более чем два значения и позволяет использовать более описательные имена членов, чем first и second:

struct Variable {
    QString name;
    double value;
};
Variable v;
v.name = "pi";
v.value = M_PI;

Появление в C++11 автоматического вывода типа переменной (auto) смещает акцент с имени типа на имя функций и членов. Таким образом, QPair, подобно std::pair и std::tuple, в основном полезен в обобщенном (шаблонном) коде, где определение выделенного типа невозможно.

Шаблонные типы данных QPair (T1 и T2) должны быть типами данных, допускающими присваивание. Например, вы не можете хранить QWidget в качестве значения; вместо этого храните указатель на QWidget *. Некоторые функции имеют дополнительные требования; эти требования документированы для каждой функции.

См. также Классы контейнеров.

Документация типов-членов

typedef QPair::first_type

Тип первого элемента пары (T1).

См. также first.

typedef QPair::second_type

Тип второго элемента пары (T2).

См. также second.

Документация функций-членов

template <typename TT1, typename TT2> QPair::QPair(QPair<TT1, TT2> &&p)

Перемещающее конструирование экземпляра QPair, делая его указывающим на тот же объект, что и p.

Эта функция была добавлена в Qt 5.2.

template <typename TT1, typename TT2> QPair::QPair(const QPair<TT1, TT2> &p)

Конструирует пару из другой пары p, типов TT1 и TT2. Этот конструктор завершится ошибкой, если first не может быть инициализирован из p.first или если second не может быть инициализирован из p.second.

Эта функция была добавлена в Qt 5.2.

См. также qMakePair().

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

Конструирует пару и инициализирует first элемент значением value1, а second элемент значением value2.

См. также qMakePair().

QPair::QPair()

Конструирует пустую пару. first и second элементы инициализируются значениями по умолчанию.

void QPair::swap(QPair<T1, T2> &other)

Меняет местами эту пару с other.

Эквивалентно

qSwap(this->first, other.first);
qSwap(this->second, other.second);

Перегрузки swap также находятся в пространстве имен std, а также через поиск по зависимости от аргументов (ADL) в пространстве имен T.

Эта функция была добавлена в Qt 5.5.

template <typename TT1, typename TT2> QPair<T1, T2> &QPair::operator=(const QPair<TT1, TT2> &p)

Копирует пару p в эту пару.

Эта функция была добавлена в Qt 5.2.

См. также qMakePair().

template <typename TT1, typename TT2> QPair<T1, T2> &QPair::operator=(QPair<TT1, TT2> &&p)

Перемещающее присваивание пары p в этот экземпляр пары.

Эта функция была добавлена в Qt 5.2.

QList<QPair<int, double> > list;
list.append(qMakePair(66, M_PI));