- Qt 6.6
- Qt Core
- <QtSwap> Proxy Page
- Qt 6.6.3 Reference Documentation

# <QtSwap> Proxy Page

## Functions

void | qSwap(T &lhs, T &rhs)

## Function Documentation

### `[constexpr noexcept(...)]` template <typename T> void qSwap(T &lhs, T &rhs)

Exchanges the values of variables lhs and rhs, taking type-specific `swap()` overloads into account.

This function is Qt's version of `boost::swap()`, and is equivalent to

     using std::swap;   // bring std::swap into scope (for built-in types)
     swap(lhs, rhs);    // unqualified call (picks up type-specific overloads
                        // via Argument-Dependent Lookup, or falls back to std::swap)

Use this function primarily in generic code, where you would traditionally have written the above two lines, because you don't know anything about `T`.

If you already know what `T` is, then use one of the following options, in order of preference:

- `lhs.swap(rhs);` if such a member-swap exists
- `std::swap(lhs, rhs);` if no type-specific `swap()` exists

See `boost::swap()` on boost.org for more details.

See also `std::swap` on cppreference.com, `Swappable` on cppreference.com.

Note: This function does not throw any exception when "noexcept(QtPrivate::SwapExceptionTester::checkSwap(value1))" is true.