Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::swap — scambiare valori

std::swap, definito in <utility>, scambia i valori di due oggetti e restituisce void. Scopri i requisiti del modello primario, l’overload per gli array e la forma di chiamata che consente l’ADL nel codice generico.

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

Sintassi

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

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

std::swap(a, b) di <utility> scambia i valori degli oggetti a cui fanno riferimento gli argomenti; restituisce void. Il modello primario riceve entrambi gli argomenti come T&, quindi devono essere dello stesso tipo T.

Il modello primario richiede che T soddisfi i requisiti Cpp17MoveConstructible e Cpp17MoveAssignable. La sua specifica delle eccezioni corrisponde a noexcept(is_nothrow_move_constructible_v<T> && is_nothrow_move_assignable_v<T>); non dare quindi per scontato che ogni scambio sia privo di eccezioni.

Un overload distinto gestisce gli array incorporati con lo stesso tipo di elemento e la stessa lunghezza, scambiando gli elementi corrispondenti. Gli elementi devono poter essere scambiati tra loro.

Nel codice generico, usa using std::swap; swap(a, b);. In questo modo sono ammesse sia le versioni standard sia una funzione swap trovata tramite ricerca dipendente dagli argomenti (ADL). Una chiamata qualificata a std::swap(a, b) non esegue l’ADL.

Questa voce è riferita a C++23. La bozza di standard fornita è un documento in evoluzione, non una pubblicazione C++23 definitiva; questa voce non certifica un ambiente di produzione.

Esempi

#include <iostream>
#include <utility>

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

Risultato

8 3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti