valueof / peakle

A tiny abstraction around lists that makes them more walkable.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Peakle is a tiny abstraction around lists that makes them more walkable.

Peakle's constructor takes only one parameter, a list of values.

	var peakled = new Peakle([ 1, 2, 3 ]);

By default, the current position is always at the first element. If the
initial list is empty, then the current position is 'null'.

Properties:

	* length: returns a number of elements in the underlying list.
	* current: returns a value of the current element.

Methods:

	* next(): Moves to the next element and returns its value.
	* prev(): Moves to the previous element and returns its value.
	* peak(adv): Returns next element's value without moving its pointer.
	  This method accepts an optional numeric parameter. Use it if you
	  want to peak further.
	* move(index): Moves to the specified element.

All methods return 'null' if they can't return a value.

Example:

	var peakled = new Peakle([ 1, 2, 3 ]);

	peakled.current;  // 1
	peakled.peak();   // 2
	peakled.peak(2);  // 3

	peakled.next();   // 2
	peakled.peak();   // 3
	peakled.peak(2);  // null
	peakled.peak(-1); // 1

	peakled.prev();   // 1
	peakled.move(2);  // 3

About

A tiny abstraction around lists that makes them more walkable.

License:MIT License


Languages

Language:JavaScript 100.0%