container (version 1.0.0)

at2: Extract Single Elements Safely

Description

Extracts the value of a Container at the given index. If the index is invalid, an error is signaled. If given as a string, the element matching the name is returned. If there are two or more identical names, the value of the first match (i.e. leftmost element) is returned. Extract value at index. If index is invalid or not found, an error is signaled. If given as a string, the element matching the name is returned. If there are two or more identical names, the value of the first match (i.e. leftmost element) is returned.

Usage

at2(x, ...)
# S3 method for Container
at2(x, index, ...)
# S3 method for dict.table
at2(x, index, ...)

Arguments

x

an R object of the respective class.

...

other arguments passed to or from methods.

index

character name or numeric position of the sought value.

Value

For Container, returns the value at the given index.

For dict.table, returns the column at the given index or signals an error if not found.

See Also

peek_at2() for less strict extraction

Examples

# NOT RUN {
# Container
co = container(a = 1, 2, b = 3, 4)
at2(co, 1)
at2(co, "a")
at2(co, 2)
# }
# NOT RUN {
at2(co, "x")     # index 'x' not found
at2(co, 5)       # index 5 exceeds length of Container
# }
# NOT RUN {
# Dict
d = dict(a = 1, b = 3)
at2(d, 1)
at2(d, "a")
at2(d, 2)
# }
# NOT RUN {
at2(d, "x")     # index 'x' not found
at2(d, 5)       # index 5 exceeds length of Dict
# }
# NOT RUN {
# dict.table
dit = dict.table(a = 1:3, b = 4:6)
at2(dit, 1)
at2(dit, "a")
at2(dit, 2)
# }
# NOT RUN {
at2(dit, "x")     # index 'x' not found
at2(dit, 5)       # index 5 exceeds length of dict.table
# }