CKTIS / C++
std::swap — trocar valores
std::swap, de <utility>, troca os valores de dois objetos e devolve void. Conheça os requisitos do modelo primário, a sobrecarga para arrays e a forma de chamada que permite ADL em código genérico.
Versão: C++23; repository compiler flag, production runtime not attested
Sintaxe
#include <utility>
std::swap(a, b);
// Generic code with argument-dependent lookup:
using std::swap;
swap(a, b);std::swap(a, b), de <utility>, troca os valores dos objetos referenciados pelos argumentos; devolve void. O modelo primário recebe ambos os argumentos como T&, pelo que têm de ser do mesmo tipo T.
O modelo primário exige que T satisfaça os requisitos Cpp17MoveConstructible e Cpp17MoveAssignable. A sua especificação de exceções corresponde a noexcept(is_nothrow_move_constructible_v<T> && is_nothrow_move_assignable_v<T>); por isso, não parta do princípio de que todas as trocas são isentas de exceções.
Uma sobrecarga separada trata arrays incorporados com o mesmo tipo de elemento e o mesmo comprimento, trocando os elementos correspondentes. Os elementos têm de poder ser trocados entre si.
Em código genérico, use using std::swap; swap(a, b);. Esta forma permite tanto os modelos da biblioteca padrão como uma função swap encontrada através da pesquisa dependente dos argumentos (ADL). Uma chamada qualificada a std::swap(a, b) não executa ADL.
Esta entrada refere-se a C++23. O projeto de norma fornecido é um documento em evolução, não uma publicação C++23 definitiva; esta entrada não atesta um ambiente de produção.
Exemplos
#include <iostream>
#include <utility>
int main() {
int a = 3;
int b = 8;
std::swap(a, b);
std::cout << a << ' ' << b << '\n';
}
Resultado
8 3
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.