Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::swap — zamiana wartości

std::swap z nagłówka <utility> zamienia wartości dwóch obiektów i zwraca void. Poznaj wymagania podstawowego szablonu, przeciążenie dla tablic oraz sposób wywołania umożliwiający ADL w kodzie generycznym.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <utility>
std::swap(a, b);

// Generic code with argument-dependent lookup:
using std::swap;
swap(a, b);

std::swap(a, b) z nagłówka <utility> zamienia wartości obiektów wskazanych przez argumenty; zwraca void. Podstawowy szablon przyjmuje dwa argumenty przez T&, więc muszą one pasować do tego samego typu T.

Podstawowy szablon wymaga, aby T spełniał wymagania Cpp17MoveConstructible i Cpp17MoveAssignable. Jego specyfikacja wyjątków odpowiada noexcept(is_nothrow_move_constructible_v<T> && is_nothrow_move_assignable_v<T>); nie zakładaj więc, że każda zamiana jest bezwyjątkowa.

Osobne przeciążenie obsługuje wbudowane tablice tego samego typu elementów i długości, zamieniając odpowiadające sobie elementy. Elementy muszą być wzajemnie zamienialne.

W kodzie generycznym używaj using std::swap; swap(a, b);. Taki zapis dopuszcza zarówno standardowe szablony, jak i funkcję swap znalezioną przez ADL, czyli wyszukiwanie zależne od argumentów. Kwalifikowane wywołanie std::swap(a, b) nie uruchamia ADL.

Zakres wpisu to C++23. Podany projekt standardu jest dokumentem rozwijanym, a nie zamrożoną publikacją C++23; wpis nie poświadcza środowiska produkcyjnego.

Przykłady

#include <iostream>
#include <utility>

int main() {
    int a = 3;
    int b = 8;
    std::swap(a, b);
    std::cout << a << ' ' << b << '\n';
}

Wynik

8 3

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła