list

Create a list with specific items

Usage

Given a start, end, value, and step size returns a list with values from start to end by step size.

The interface is identical to range.

A hat tip to Python’s range functionality

import * as 
import _
_ from 'radashi'

import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(3) // [0, 1, 2, 3]
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(1, 3) // [1, 2, 3]
import _
_.
list<string>(startOrLength: number, end?: number, valueOrMapper?: string | ((i: number) => string) | undefined, step?: number): string[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(0, 3, 'y') // [y, y, y, y]
import _
_.
list<string>(startOrLength: number, end?: number, valueOrMapper?: string | ((i: number) => string) | undefined, step?: number): string[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(0, 3, () => 'y') // [y, y, y, y]
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(0, 3, 
i: number
i => 
i: number
i) // [0, 1, 2, 3]
import _
_.
list<string>(startOrLength: number, end?: number, valueOrMapper?: string | ((i: number) => string) | undefined, step?: number): string[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(0, 3, 
i: number
i => `y${
i: number
i}`) // [y0, y1, y2, y3]
import _
_.
list<{}>(startOrLength: number, end?: number, valueOrMapper?: {} | ((i: number) => {}) | undefined, step?: number): {}[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(0, 3, {}) // [{}, {}, {}, {}]
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(0, 6, 
i: number
i => 
i: number
i, 2) // [0, 2, 4, 6]

Signatures

list(size)

When givin a single argument, it’s treated as the size. Returns a list with values from 0 to size.

const 
const simpleList: number[]
simpleList = 
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(3) // [0, 1, 2, 3]

list(start, end)

When given two arguments, they’re treated as the start and end. Returns a list with values from start to end

const 
const rangeList: number[]
rangeList = 
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(2, 6) // [2, 3, 4, 5, 6]

list(start, end, value)

When given a third argument it’s treated as the value to be used in the list. If the value is a function it will be called, with an index argument, to create every value.

const 
const staticObjectList: {}[]
staticObjectList = 
import _
_.
list<{}>(startOrLength: number, end?: number, valueOrMapper?: {} | ((i: number) => {}) | undefined, step?: number): {}[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(2, 4, {}) // [{}, {}, {}]
const 
const staticValueList: null[]
staticValueList = 
import _
_.
list<null>(startOrLength: number, end?: number, valueOrMapper?: ((i: number) => null) | null | undefined, step?: number): null[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(2, 4, null) // [null, null, null]
const 
const functionList: number[]
functionList = 
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(2, 4, 
i: number
i => 
i: number
i) // [2, 3, 4]

list(start, end, value, step)

When given a fourth argument it’s treated as the step size to skip when generating values from start to end.

const 
const steppedList: number[]
steppedList = 
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(2, 4, 
i: number
i => 
i: number
i, 2) // [2, 4]
const 
const biggerSteppedList: number[]
biggerSteppedList = 
import _
_.
list<number>(startOrLength: number, end?: number, valueOrMapper?: number | ((i: number) => number) | undefined, step?: number): number[]
export list
Creates a list of given start, end, value, and step parameters.
@see ― https://radashi.js.org/reference/array/list
@example 
list(3)                  // 0, 1, 2, 3
list(0, 3)               // 0, 1, 2, 3
list(0, 3, 'y')          // y, y, y, y
list(0, 3, () => 'y')    // y, y, y, y
list(0, 3, i => i)       // 0, 1, 2, 3
list(0, 3, i => `y${i}`) // y0, y1, y2, y3
list(0, 3, obj)          // obj, obj, obj, obj
list(0, 6, i => i, 2)    // 0, 2, 4, 6
@version ― 12.1.0
list(25, 100, 
i: number
i => 
i: number
i, 25) // [25, 50, 75, 100]