# 4.2: DLList - A Doubly-Linked List

A DLList (doubly-linked list) is very similar to an SLList except that each node $$\mathtt{u}$$ in a DLList has references to both the node $$\texttt{u.next}$$ that follows it and the node $$\texttt{u.prev}$$ that precedes it.

    class Node {
T x;
Node prev, next;
}


When implementing an SLList, we saw that there were always several special cases to worry about. For example, removing the last element from an SLList or adding an element to an empty SLList requires care to ensure that $$\mathtt{head}$$ and $$\mathtt{tail}$$ are correctly updated. In a DLList, the number of these special cases increases considerably. Perhaps the cleanest way to take care of all these special cases in a DLList is to introduce a $$\mathtt{dummy}$$ node. This is a node that does not contain any data, but acts as a placeholder so that there are no special nodes; every node has both a $$\mathtt{next}$$ and a $$\mathtt{prev}$$, with $$\mathtt{dummy}$$ acting as the node that follows the last node in the list and that precedes the first node in the list. In this way, the nodes of the list are (doubly-)linked into a cycle, as illustrated in Figure $$\PageIndex{1}$$. Figure $$\PageIndex{1}$$: A DLList containing a,b,c,d,e.
    int n;
Node dummy;
DLList() {
dummy = new Node();
dummy.next = dummy;
dummy.prev = dummy;
n = 0;
}


Finding the node with a particular index in a DLList is easy; we can either start at the head of the list ($$\texttt{dummy.next}$$) and work forward, or start at the tail of the list ($$\texttt{dummy.prev}$$) and work backward. This allows us to reach the $$\mathtt{i}$$th node in $$O(1+\min\{\mathtt{i},\mathtt{n}-\mathtt{i}\})$$ time:

    Node getNode(int i) {
Node p = null;
if (i < n / 2) {
p = dummy.next;
for (int j = 0; j < i; j++)
p = p.next;
} else {
p = dummy;
for (int j = n; j > i; j--)
p = p.prev;
}
return p;
}


The $$\mathtt{get(i)}$$ and $$\mathtt{set(i,x)}$$ operations are now also easy. We first find the $$\mathtt{i}$$th node and then get or set its $$\mathtt{x}$$ value:

    T get(int i) {
if (i < 0 || i > n - 1) throw new IndexOutOfBoundsException();
return getNode(i).x;
}
T set(int i, T x) {
if (i < 0 || i > n - 1) throw new IndexOutOfBoundsException();
Node u = getNode(i);
T y = u.x;
u.x = x;
return y;
}


The running time of these operations is dominated by the time it takes to find the $$\mathtt{i}$$th node, and is therefore $$O(1+\min\{\mathtt{i},\mathtt{n}-\mathtt{i}\})$$.

## $$\PageIndex{1}$$ Adding and Removing

If we have a reference to a node $$\mathtt{w}$$ in a DLList and we want to insert a node $$\mathtt{u}$$ before $$\mathtt{w}$$, then this is just a matter of setting $$\texttt{u.next}=\mathtt{w}$$, $$\texttt{u.prev}=\texttt{w.prev}$$, and then adjusting $$\texttt{u.prev.next}$$ and $$\texttt{u.next.prev}$$. (See Figure $$\PageIndex{2}$$.) Thanks to the dummy node, there is no need to worry about $$\texttt{w.prev}$$ or $$\texttt{w.next}$$ not existing.

    Node addBefore(Node w, T x) {
Node u = new Node();
u.x = x;
u.prev = w.prev;
u.next = w;
u.next.prev = u;
u.prev.next = u;
n++;
return u;
} Figure $$\PageIndex{2}$$: Adding the node $$\mathtt{u}$$ before the node $$\mathtt{w}$$ in a DLList.

Now, the list operation $$\mathtt{add(i,x)}$$ is trivial to implement. We find the $$\mathtt{i}$$th node in the DLList and insert a new node $$\mathtt{u}$$ that contains $$\mathtt{x}$$ just before it.

    void add(int i, T x) {
if (i < 0 || i > n) throw new IndexOutOfBoundsException();
}


The only non-constant part of the running time of $$\mathtt{add(i,x)}$$ is the time it takes to find the $$\mathtt{i}$$th node (using $$\mathtt{getNode(i)}$$). Thus, $$\mathtt{add(i,x)}$$ runs in $$O(1+\min\{\mathtt{i}, \mathtt{n}-\mathtt{i}\})$$ time.

Removing a node $$\mathtt{w}$$ from a DLList is easy. We only need to adjust pointers at $$\texttt{w.next}$$ and $$\texttt{w.prev}$$ so that they skip over $$\mathtt{w}$$. Again, the use of the dummy node eliminates the need to consider any special cases:

    void remove(Node w) {
w.prev.next = w.next;
w.next.prev = w.prev;
n--;
}


Now the $$\mathtt{remove(i)}$$ operation is trivial. We find the node with index $$\mathtt{i}$$ and remove it:

    T remove(int i) {
if (i < 0 || i > n - 1) throw new IndexOutOfBoundsException();
Node w = getNode(i);
remove(w);
return w.x;
}


Again, the only expensive part of this operation is finding the $$\mathtt{i}$$th node using $$\mathtt{getNode(i)}$$, so $$\mathtt{remove(i)}$$ runs in $$O(1+\min\{\mathtt{i}, \mathtt{n}-\mathtt{i}\})$$ time.

## $$\PageIndex{2}$$ Summary

The following theorem summarizes the performance of a DLList:

Theorem $$\PageIndex{1}$$.

A DLList implements the List interface. In this implementation, the $$\mathtt{get(i)}$$, $$\mathtt{set(i,x)}$$, $$\mathtt{add(i,x)}$$ and $$\mathtt{remove(i)}$$ operations run in $$O(1+\min\{\mathtt{i},\mathtt{n}-\mathtt{i}\})$$ time per operation.

It is worth noting that, if we ignore the cost of the $$\mathtt{getNode(i)}$$ operation, then all operations on a DLList take constant time. Thus, the only expensive part of operations on a DLList is finding the relevant node. Once we have the relevant node, adding, removing, or accessing the data at that node takes only constant time.

This is in sharp contrast to array-based List implementations (see Open Data Structures, Chapter 2); in those implementations, the relevant array item can be found in constant time. However, addition or removal requires shifting elements in the array and, in general, takes non-constant time.

For this reason, linked list structures are well-suited to applications where references to list nodes can be obtained through external means. An example of this is the LinkedHashSet data structure found in the Java Collections Framework, in which a set of items is stored in a doubly-linked list and the nodes of the doubly-linked list are stored in a hash table (discussed in Chapter 7). When elements are removed from a LinkedHashSet, the hash table is used to find the relevant list node in constant time and then the list node is deleted (also in constant time).