CKTIS / Java
Collections.swap — prohození dvou prvků v seznamu
`Collections.swap` prohodí prvky na dvou zadaných indexech v témže seznamu. Nevytváří nový seznam a vyžaduje podporu operace `set`.
Verze: Java SE 21
Syntaxe
public static void swap(List<?> list, int i, int j)Collections.swap(list, i, j) je statická metoda třídy java.util.Collections, dostupná od Javy 1.4. Přijímá List<?>, takže volající kód nemusí znát typ prvků. Prvky vybírá podle indexu, nikoli podle hodnoty. Mění tentýž seznam beze změny jeho velikosti, nevytváří nový seznam a nic nevrací (void).
Indexy začínají na 0. Oba musí být nezáporné a menší než list.size(). Dokumentace API pro index mimo tento rozsah uvádí výjimku IndexOutOfBoundsException. Pokud ale seznam nepodporuje set, může volání místo ní vyvolat výjimku UnsupportedOperationException. Předání hodnoty null místo seznamu způsobí výjimku NullPointerException.
Prohození vyžaduje podporu List.set, nikoli add ani remove. Funguje tedy se seznamem pevné velikosti z Arrays.asList. Neměnitelný seznam z List.of při pokusu o prohození prvků na dvou různých platných pozicích vyvolá výjimku UnsupportedOperationException. Dva stejné platné indexy ponechají pořadí beze změny, ale seznam bez podpory set může i tehdy vyvolat výjimku UnsupportedOperationException.
Chceš-li prohodit první a poslední prvek, použij indexy 0 a list.size() - 1. U seznamu s méně než dvěma prvky volání vynech: prázdný seznam nemá platný index a jednoprvkový seznam změnu nepotřebuje. Pomocná metoda mění předaný seznam, aniž by ho kopírovala.
Příklady
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);
}
}
}
Výsledek
[A, B, C] [C, B, A]
`main` připraví měnitelný seznam `ArrayList`. `sameList` odkazuje na tentýž seznam jako `items`, takže druhý výpis ukáže `[C, B, A]` přes referenci uloženou před voláním.
Související lekce
- Java · Lekce 12 · Pokročilá · Verze: 2