Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes