DList (core 4.6 API)

java.lang.Object
- fj.data.DList<A>

```
public final class DList<A>
extends java.lang.Object
```
Difference List. It converts left associative appends into right associative ones to improve performance.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`DList<A>`	`append(DList<A> other)` Appends two DLists together to produce a new DList.
`static <A> DList<A>`	`arrayDList(A... as)` Creates a DList from an array
`DList<A>`	`cons(A a)` Prepends a single element on the DList to produce a new DList.
`static <A> DList<A>`	`dlist(F<List<A>,Trampoline<List<A>>> f)` Creates a DList from the function For alternatives functions to create a DList:
`static <A> DList<A>`	`iterableDList(java.lang.Iterable<A> it)` Creates a DList from an Iterable
`static <A> DList<A>`	`iteratorDList(java.util.Iterator<A> it)` Creates a DList from an Iterator
`static <A> DList<A>`	`listDList(List<A> a)` Creates a DList from a List
`static <A> DList<A>`	`nil()` A empty DList.
`List<A>`	`run()` Concatenates all the internal Lists together that are held in the DList's lambda's state to produce a List.
`static <A> DList<A>`	`single(A a)` Produces a DList with one element.
`DList<A>`	`snoc(A a)` Appends a single element on the end of the DList to produce a new DList.
`java.util.List<A>`	`toJavaList()` Converts the DList to a standard java.util.List.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - dlist
```
public static <A> DList<A> dlist(F<List<A>,Trampoline<List<A>>> f)
```
    Creates a DList from the function For alternatives functions to create a DList:
    
    See Also:
    
    iterableDList(java.lang.Iterable<A>), iteratorDList(java.util.Iterator<A>), arrayDList(A...)
  - listDList
```
public static <A> DList<A> listDList(List<A> a)
```
    Creates a DList from a List
  - iterableDList
```
public static <A> DList<A> iterableDList(java.lang.Iterable<A> it)
```
    Creates a DList from an Iterable
  - iteratorDList
```
public static <A> DList<A> iteratorDList(java.util.Iterator<A> it)
```
    Creates a DList from an Iterator
  - arrayDList
```
@SafeVarargs
public static <A> DList<A> arrayDList(A... as)
```
    Creates a DList from an array
  - run
```
public List<A> run()
```
    Concatenates all the internal Lists together that are held in the DList's lambda's state to produce a List. This is what converts the appending operation from left associative to right associative, giving DList it's speed.
    
    Returns:
    
    the final List
  - toJavaList
```
public java.util.List<A> toJavaList()
```
    Converts the DList to a standard java.util.List.
  - nil
```
public static <A> DList<A> nil()
```
    A empty DList.
    
    Type Parameters:
    
    A -
    
    Returns:
    
    a empty DList.
  - single
```
public static <A> DList<A> single(A a)
```
    Produces a DList with one element.
    
    Type Parameters:
    
    A -
    
    Parameters:
    
    a - the element in the DList.
    
    Returns:
    
    a DList with one element.
  - cons
```
public DList<A> cons(A a)
```
    Prepends a single element on the DList to produce a new DList.
    
    Parameters:
    
    a - the element to append.
    
    Returns:
    
    the new DList.
  - snoc
```
public DList<A> snoc(A a)
```
    Appends a single element on the end of the DList to produce a new DList.
    
    Parameters:
    
    a - the element to append.
    
    Returns:
    
    the new DList.
  - append
```
public DList<A> append(DList<A> other)
```
    Appends two DLists together to produce a new DList.
    
    Parameters:
    
    other - the other DList to append on the end of this one.
    
    Returns:
    
    the new DList.

Class DList<A>

Method Summary

Methods inherited from class java.lang.Object

Method Detail

dlist

listDList

iterableDList

iteratorDList

arrayDList

run

toJavaList

nil

single

cons

snoc

append