Skip to content
/ peakle Public

A tiny abstraction around lists that makes them more walkable.

License

Notifications You must be signed in to change notification settings

valueof/peakle

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published