Doubly-Linked List

Purpose

As long as data isn't structured the doubly-linked list is among the most flexible for working with data sets.

In the overwhelming majority of cases, this is the container you want to be working with.

Notable Features

Non-Deallocative Traversal

Traversal between nodes of any list type does not remove the previous node, so they behave more like arrays.

Unlike the Singly-Linked List traversal is possible in either direction.

Insertion

Unlike the Stack or Queue, or the Array, nodes can be inserted inside the list without requiring a new list.

Queries

Some queries are possible upon this generalized list, and are made available here. Whether a list contains a value, all instances of a certain value, former N values, hinder N values, and so on. All of these queries either return a boolean or another list which can be queried.

Considerations

Use of an iterator is slower than traversal through Node.Afore and Node.Ahind, due to the implementation. This is because the list operations largely operate on nodes themselves, not on a cursor, so the cursor heavy iterator has additional overhead. Being simpler, iterators are good for prototyping or when performance doesn't matter, but manual traversal is advised.

As a compromise between iteration and traversal, an each function exists, which traverses through the list for you, constructing an array of the same ordering as the list, which can then be iterated through. The performance overhead is generally less than iteration, while otherwise working the same as iteration (all arrays work in iteration loops).