cpp_list {cppcontainers} | R Documentation |
Create list
Description
Create a list, i.e. a doubly-linked list.
Usage
cpp_list(x)
Arguments
x |
An integer, numeric, character, or logical vector. |
Details
Doubly-linked means that list elements store a reference both to the previous element and to the following element. This container type, thus, requires more RAM than a singly-linked list does, but can be iterated in both directions.
C++ list methods implemented in this package are assign, back, clear, emplace, emplace_back, emplace_front, empty, erase, front, insert, max_size, merge, pop_back, pop_front, push_back, push_front, remove., resize, reverse, size, sort, splice, and unique. The package also adds the == operator and various helper functions (print, to_r, type).
All object-creating methods in this package begin with cpp_
to avoid clashes with functions from other packages, such as utils::stack
and
base::vector
.
Value
Returns a CppList object referencing a list in C++.
See Also
cpp_vector, cpp_deque, cpp_forward_list.
Examples
l <- cpp_list(4:6)
l
# 4 5 6
push_back(l, 1L)
l
# 4 5 6 1
push_front(l, 2L)
l
# 2 4 5 6 1