CKTIS / Java
`Queue.peek()` — přečtení prvku z čela fronty bez odebrání
Metoda `peek()` vrátí prvek z čela fronty, aniž by ho odebrala. Pokud je fronta prázdná, vrátí `null`.
Verze: Java SE 21
Syntaxe
E peek();
// Example call on a Queue<String>:
String head = queue.peek();Queue.peek() je instanční metoda rozhraní java.util.Queue<E>. Nepřijímá žádné argumenty a vrací prvek typu E z čela fronty, aniž by frontu změnila. Pořadí určuje implementace, takže na čele nemusí být prvek, který byl vložen jako první.
Pokud je fronta prázdná, peek() vrátí null. Metoda element() také frontu nemění, ale u prázdné fronty vyvolá výjimku NoSuchElementException. Metoda poll() odebere a vrátí prvek z čela fronty, nebo vrátí null, pokud je fronta prázdná.
Nevkládej do fronty null jako prvek. Pokud to implementace povoluje, výsledek null z peek() nerozliší prázdnou frontu od fronty s hodnotou null na čele. Příklad používá ArrayDeque, která prvky null nepovoluje.
Příklady
import java.util.ArrayDeque;
import java.util.Queue;
public class Main {
public static void main(String[] args) {
Queue<String> queue = new ArrayDeque<>();
queue.offer("apple");
queue.offer("banana");
System.out.println(queue.peek());
System.out.println(queue.poll());
System.out.println(queue.peek());
queue.poll();
System.out.println(queue.peek());
}
}Výsledek
apple apple banana null
První volání `peek()` vypíše `apple`, ale neodebere ho. Následující volání `poll()` proto také vypíše `apple`, ale zároveň ho odebere. Další volání `peek()` vypíše `banana`. Druhé volání `poll()` odebere `banana` bez výpisu a poslední volání `peek()` vypíše `null`.
Související lekce
- Java · Lekce 61 · Základní · Verze: 2