sliceable

Module nu.forms.collections.abc.sliceable.

Sliceable capability.

SliceableForm: values that support slicing.

Name	Call	Meaning
SliceableForm	`SliceableForm()`	Base for values that support slicing.

SliceableForm

Base for values that support slicing.

SliceableForm()

Path nu.forms.collections.abc.SliceableForm.

Example

nu.run(nu.List([1, 2, 3, 4, 5]).slice(1, 4))[0]

[2, 3, 4]

Methods

Slice of self from start to stop, stepping by step.

Builds ResultT.

Arguments

Name	Type	Default	Meaning
`start`	`IntArg \| None`		the index to start at, inclusive. None starts from the beginning.
`stop`	`IntArg \| None`		the index to stop at, exclusive. None runs to the end.
`step`	`IntArg \| None`	`None`	the stride between elements. None means every element.

Yields

The sliced value, wrapped by the subclass. INVALID when self is a sentinel.

Notes

Bounds are clamped like Python slicing: an out-of-range start or stop never raises.

Examples

nu.run(nu.List([1, 2, 3, 4, 5]).slice(1, 4))[0]

[2, 3, 4]

nu.run(nu.List([1, 2, 3, 4, 5]).slice(0, 5, 2))[0]

[1, 3, 5]

Inherited methods

From nu.lang.forms.Form:

Call	Builds	Meaning
`.is_empty()`	`Bool`	True if this Form yields the EMPTY sentinel.
`.is_invalid()`	`Bool`	True if this Form yields the INVALID sentinel.
`.is_sentinel()`	`Bool`	True if this Form yields either sentinel (EMPTY or INVALID).
`.not_empty()`	`Bool`	True if this Form does not yield EMPTY.
`.not_invalid()`	`Bool`	True if this Form does not yield INVALID.

From builtins.object: