<QtTypeTraits> - Qt Type Traits

Funcionalidad para rasgos de tipo y transformaciones. Más...

Header: #include <QtTypeTraits>
Since: Qt 6.5

Funciones

T qExchange(T &obj, U &&newValue)
(since 6.2) std::underlying_type_t<Enum> qToUnderlying(Enum e)

Macros

(since 6.8) QT_NO_QASCONST
(since 6.6) QT_NO_QEXCHANGE

Descripción detallada

Documentación de funciones

[constexpr noexcept(...)] template <typename T, typename U = T> T qExchange(T &obj, U &&newValue)

Sustituye el valor de ` obj ` por ` newValue ` y devuelve el valor anterior de ` obj`.

Esta es la implementación de Qt de std::exchange(). Se diferencia de std::exchange() únicamente en que ya era constexpr antes de C++20 y noexcept antes de C++23.

Recomendamos encarecidamente utilizar std::exchange() cuando no se necesiten las variantes de C++20 o C++23. Se puede desactivar qExchange() definiendo la macro « QT_NO_QEXCHANGE ».

A continuación se explica cómo utilizar qExchange() para implementar constructores de movimiento:

MyClass(MyClass &&other)
  : m_pointer{qExchange(other.m_pointer, nullptr)},
    m_int{qExchange(other.m_int, 0)},
    m_vector{std::move(other.m_vector)},
    ...

Para los miembros de tipo clase, podemos utilizar `std::move()`, ya que su constructor de traslado hará lo correcto. Sin embargo, para los tipos escalares, como los punteros sin tipo o los tipos enteros, el traslado es igual que la copia, lo cual, especialmente en el caso de los punteros, no es lo que esperamos. Por lo tanto, no podemos utilizar std::move() para dichos tipos, pero sí podemos usar std::exchange()/qExchange() para asegurarnos de que el miembro del objeto de origen ya se haya restablecido en el momento en que lleguemos a la inicialización de nuestro siguiente miembro de datos, lo cual puede resultar útil si el constructor termina con una excepción.

A continuación se muestra cómo utilizar qExchange() para escribir un bucle que consuma la colección sobre la que itera:

for (auto &e : qExchange(collection, {})
    doSomethingWith(e);

Lo cual equivale al siguiente código, mucho más prolijo:

{
    auto tmp = std::move(collection);
    collection = {};                    // or collection.clear()
    for (auto &e : tmp)
        doSomethingWith(e);
}                                       // destroys 'tmp'

Esto es totalmente seguro, ya que el bucle «for» mantiene activo el resultado de qExchange() mientras el bucle se ejecuta, lo que evita tener que declarar una variable temporal. Sin embargo, hay que tener en cuenta que qExchange() devuelve un objeto no constante, por lo que los contenedores de Qt pueden desvincularse.

Nota: Esta función es «noexcept» cuando ` std::conjunction_v<std::is_nothrow_move_constructible<T>, std::is_nothrow_assignable<T &, U>> ` es ` true`.

[constexpr noexcept, since 6.2] template <typename Enum> std::underlying_type_t<Enum> qToUnderlying(Enum e)

Convierte el enumerador « e » al valor equivalente expresado en el tipo subyacente de su enumeración.

Esta función se introdujo en Qt 6.2.

Documentación de macros

[since 6.8] QT_NO_QASCONST

Al definir esta macro, se desactiva la función qAsConst().

Esta macro se introdujo en Qt 6.8.

Véase también qAsConst.

[since 6.6] QT_NO_QEXCHANGE

Al definir esta macro, se desactiva la función ` qExchange()`.

Esta macro se introdujo en Qt 6.6.

Véase también qExchange.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.