pop_containing: Pop First Containing Interval

In Immutables: Fast and Functional Data Structures

Pop First Containing Interval

Description

Pop First Containing Interval

Usage

pop_containing(x, start, end, bounds = NULL)

Arguments

x	An interval_index.
start	Query interval start.
end	Query interval end.
bounds	Optional boundary override. One of "[)", "[]", "()", "(]".

Details

Removes the first match in canonical interval order. On miss, returns a non-throwing miss object with remaining = x. Use pop_all_containing() to remove all matches.

Value

A list with element, start, end, and remaining. On miss: element, start, and end are NULL.

Examples

ix <- interval_index("a", "b", "c", start = c(1, 2, 4), end = c(6, 3, 7))
pop_containing(ix, 2, 4)

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