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

CKTIS / Java

Collections.swap — trocar dois elementos de uma lista

`Collections.swap` troca os elementos em dois índices da mesma lista. Não cria uma nova lista e requer que a lista suporte a operação `set`.

Versão: Java SE 21

Sintaxe

public static void swap(List<?> list, int i, int j)

Collections.swap(list, i, j) é um método estático de java.util.Collections, disponível desde o Java 1.4. Aceita List<?>, pelo que o código que o invoca não precisa de conhecer o tipo dos elementos. Seleciona-os pelo índice, não pelo valor. Altera a mesma lista sem mudar o seu tamanho, não cria uma nova lista e não devolve nada (void).

Os índices começam em 0. Ambos têm de ser maiores ou iguais a zero e menores do que list.size(). A documentação da API indica IndexOutOfBoundsException para um índice fora desse intervalo. No entanto, se a lista não suportar set, a chamada pode lançar UnsupportedOperationException em vez dessa exceção. Passar null em vez da lista provoca uma NullPointerException.

A troca requer List.set, não add nem remove. Por isso, funciona com uma lista de tamanho fixo obtida com Arrays.asList. Já uma lista não modificável obtida com List.of lança UnsupportedOperationException quando se tenta trocar os elementos em duas posições válidas e distintas. Dois índices válidos e iguais deixam a ordem intacta, mas uma lista que não suporte set pode, ainda assim, lançar UnsupportedOperationException.

Para trocar o primeiro e o último elemento, usa os índices 0 e list.size() - 1. Não faças a chamada se a lista tiver menos de dois elementos: uma lista vazia não tem índices válidos e uma lista com um só elemento não precisa de alterações. O método auxiliar altera a lista recebida sem a copiar.

Exemplos

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;

public class SwapDemo {
    public static void main(String[] args) {
        List<String> items = new ArrayList<>(List.of("A", "B", "C"));
        List<String> sameList = items;

        System.out.println(items);
        swapEnds(items);
        System.out.println(sameList);
    }

    private static void swapEnds(List<?> list) {
        if (list.size() >= 2) {
            Collections.swap(list, 0, list.size() - 1);
        }
    }
}

Resultado

[A, B, C]
[C, B, A]

`main` prepara uma `ArrayList` modificável. `sameList` refere-se à mesma lista que `items`, pelo que a segunda linha mostra `[C, B, A]` através da referência guardada antes da chamada.

Lições relacionadas

  • Java · Lição 12 · Avançado · Versão: 2

Fontes