Results.Collection: Collection utilities

try_first(s::AbstractString, n::Integer)::Option{AbstractString}

Try to get the first n chars from a string.

try_first(c)::Option

Try to get the first element from a collection. Uses Base.firstindex under the hood.

Try to get a value from an array or collection.

try_get(s::AbstractString, i::Integer)::Option{AbstractChar}

Try to retrieve index index from a string. Uses Base.checkbounds and Base.isvalid under the hood.

try_get(collection, index...)::Option

Fallback method for try_get. Relies on exception-handling, so it is slower than the specialized methods.

try_get(t::NamedTuple, k::Union{Integer, Symbol})::Option

Try to retrieve member k from a Base.NamedTuple.

try_get(a::AbstractArray{T}, index::Integer...)::Option{T}

Try to retrieve index index from an array. Uses Base.isassigned under the hood.

try_get(d:AbstractDict{>:K, V}, k::K)::Option{V}

Try to retrive key k from a dictionary.

try_last(c)::Option

Try to get the last element from a collection.

try_peek(iter; state=missing)::Option

Try to get the next value from an iterator. If state is not missing, use it in the call to iterate.

Try to pop a value from a collection.

try_pop!(iter::Iterators.Stateful)::Option

Try to pop a value from a Stateful iterator.

try_pop!(d::AbstractDict{>:K, V}, key::K)::Option{Pair{K, V}}

Try to pop a key-value pair from a dictionary.

try_pop!(a::AbstractVector)::Option{T}

Try to pop a value from a vector.

try_pop!(d::AbstractDict{>:K, V}, key::K)::Option{V}

Try to pop the value corresponding to key key from a dictionary.