35.5 Basic operations on chains

The following syntactic bindings are exported by the library (vicare containers chains). The bindings whose name is prefixed with $ are unsafe operations: they do not validate their arguments before accessing them.

Function: chain-copy-forwards chain

Function: $chain-copy-forwards chain

Build and return a new chain holding all the objects from chain in the same order. The iteration starts at the link given as argument, then it proceeds in the forwards direction.

Function: chain-reverse-forwards chain

Function: $chain-reverse-forwards chain

Build and return a new chain holding all the objects from chain in reverse order. The iteration starts at the link given as argument, then it proceeds in the forwards direction.

Function: chain-append-forwards chain …

Function: $chain-append-forwards chain …

Build and return a new chain holding all the objects from the chain arguments left–to–right order. The iteration starts at the link given as argument, then it proceeds in the forwards direction.