CKTIS / Java
Collections.swap — zamiana dwóch elementów na liście
`Collections.swap` zamienia miejscami elementy o dwóch podanych indeksach na tej samej liście. Nie tworzy nowej listy i wymaga obsługi operacji `set`.
Wersja: Java SE 21
Składnia
public static void swap(List<?> list, int i, int j)Collections.swap(list, i, j) to statyczna metoda klasy java.util.Collections, dostępna od Javy 1.4. Przyjmuje List<?>, więc kod wywołujący nie musi znać typu elementów. Metoda wybiera elementy według indeksów, a nie wartości. Zmienia tę samą listę, nie zmienia jej rozmiaru, nie tworzy nowej listy i niczego nie zwraca (void).
Indeksy zaczynają się od 0. Oba muszą być nieujemne i mniejsze niż list.size(). Dokumentacja API przewiduje IndexOutOfBoundsException dla indeksu spoza tego zakresu. Jeśli jednak lista nie obsługuje set, wywołanie może zamiast tego zgłosić UnsupportedOperationException. Przekazanie null zamiast listy powoduje NullPointerException.
Do zamiany potrzebna jest obsługa List.set, a nie add ani remove. Dlatego lista o stałym rozmiarze z Arrays.asList nadaje się do zamiany, a niemodyfikowalna lista z List.of zgłosi UnsupportedOperationException przy próbie zamiany elementów o dwóch różnych, prawidłowych indeksach. Dwa równe, prawidłowe indeksy pozostawiają kolejność bez zmian, ale na liście bez obsługi set takie wywołanie nadal może zgłosić UnsupportedOperationException.
Aby zamienić pierwszy i ostatni element, użyj indeksów 0 i list.size() - 1. Jeśli lista ma mniej niż dwa elementy, pomiń wywołanie: pusta lista nie ma prawidłowego indeksu, a jednoelementowa nie wymaga zmiany. Metoda pomocnicza zmienia przekazaną listę bez tworzenia kopii.
Przykłady
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);
}
}
}
Wynik
[A, B, C] [C, B, A]
`main` przygotowuje modyfikowalną listę `ArrayList`. `sameList` wskazuje na tę samą listę co `items`, więc drugi wydruk pokazuje `[C, B, A]` przez wcześniej zapisaną referencję.
Powiązane lekcje
- Java · Lekcja 12 · Zaawansowany · Wersja: 2