peek_max: Peek Maximum-Priority Element

View source: R/40-priority_queue-queue-ops.R

peek_maxR Documentation

Peek Maximum-Priority Element

Description

Returns the element at the maximum priority without modifying the queue.

Usage

peek_max(x)

Arguments

x

A priority_queue.

Details

Ties are stable: when multiple elements share maximum priority, this returns the earliest element in queue order.

Value

Element at maximum priority, or NULL when x is empty.

Examples

x <- priority_queue("a", "b", "c", priorities = c(2, 3, 3))
peek_max(x)
peek_max(priority_queue())

Immutables documentation built on April 29, 2026, 1:06 a.m.