back to Overview

.sub()

Returns a new Minified list containing only the elements in the specified range.
Available in all modules.

Syntax Variants

list.sub(startIndex)
list.sub(startIndex, endIndex)
_.sub(list, startIndex)
_.sub(list, startIndex, endIndex)

Parameters

list
A list to use as input. Can be an array, a Minified list or any other array-like structure with length property.
startIndex
the 0-based position of the sub-list start. If negative, the list's length is added and the position is relative to the list's end.
endIndex (optional)
the 0-based position of the sub-list end. If negative, the list's length is added and the position is relative to the list's end. If omitted or null, all elements following the startIndex are included in the result.
(return value)
a new list containing only the items in the index range.

Description

Returns a new Minified list containing only the elements in the specified range. If there are no elements in the range, an empty list is returned. Negative indices are supported and will be added to the list's length, thus allowing you to specify ranges at the list's end.

If you only want to have a single element from the list, you can only use only().

Example

Takes only the second and third element: 

var secndAndThird = _(5, 6, 7, 8, 9).sub(2, 4);

Example

The same using an array: 

var secndAndThird = _.sub([5, 6, 7, 8, 9], 2, 4);

Example

Adds some text the 3rd to 5th list elements: 

$('#myList li').sub(3, 6).add('Hello');

Example

Clears all elements but the first: 

$('#myList li').sub(1).fill();

Example

Changes the class of the last list element: 

$('#myList li').sub(-1).set('+lastItem');

Comments

comments powered by Disqus

back to Overview

Functions