aboutsummaryrefslogtreecommitdiffstats
path: root/src/datastructures/linkedlists/SentinelDoublyLinkedList.java
blob: bb1f1d4d302740ad79a41b7e5b49f1010c7e5494 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
/**
 * Copyright © 2014  Mattias Andrée (maandree@member.fsf.org)
 * 
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Affero General Public License for more details.
 * 
 * You should have received a copy of the GNU Affero General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */
package datastructures.linkedlists;


/**
 * Sentinel doubly linked list class. A linked
 * list is a list constructed from nodes, which
 * hold stored values, with references to each
 * other, this is usally an ineffective data
 * structure, especially on high-level object
 * orientated languages. A doubly linked list
 * stores nodes with references to the both the
 * following node previous node. A sentinel
 * linked list increses performance and reduces
 * complexity by tracking the edges implicitly
 * rather than explicitly; instead of having
 * reference to the first and last node, a
 * sentinel linked list have an extra node,
 * {@link #edge}, is placed at both the end and
 * the beginning of the linked list — the list
 * acts as linear but is constructed as circular
 * — and rather than checking that the next node
 * or previous node is not {@code null} you check
 * that it is not {@link #edge}. This implemention
 * only implements methods that do not require
 * iterating over all nodes for find a specific;
 * all other methods' — those that are implemented
 * — time complexity is Θ(1).
 * 
 * @param  <T>  The value stored in the structure
 */
£>export name=SentinelDoublyLinkedList array=0 with_sentinel=1 with_head=0 with_tail=0 with_prev=1
£>$GPP -s £ < src/datastructures/linkedlists/template | sed -e '/^[/ ]\*/d' -e '/^$/d'