collection

Module nu.forms.collections.abc.collection.

Collection capability.

CollectionForm = Sized + Iterable + Container.

Follows Python's collections.abc.Collection pattern.

Name	Call	Meaning
CollectionForm	`CollectionForm()`	Base for collection values, like collections.abc.Collection.

CollectionForm

Base for collection values, like collections.abc.Collection.

CollectionForm()

Path nu.forms.collections.abc.CollectionForm.

Combines len() from SizedForm, contains() from ContainerForm, and the result-wrapping infrastructure from IterableForm.

Example

nu.run(nu.List([1, 2, 3]).len())[0]

Methods

Materialise the full subtree rooted at self.

Builds object.

Yields

The materialised Python value. EMPTY when self is EMPTY.

Notes

Recursively pulls the whole subtree out of the fabric into a plain Python value (dict / list / nested mix), unlike a plain read which only yields the value at self's own address.
Needs self bound in a live fabric; it isn't a scalar expression nu.run can evaluate on its own.

Example

nu.List([1, 2, 3]).extract()

Inherited methods

From nu.forms.collections.abc.sized.SizedForm:

Call	Builds	Meaning
`.len()`	`Int`	Length of self.

From nu.forms.collections.abc.iterable.IterableForm:

Call	Builds	Meaning
`.iter()`	`Iterator[ElementT]`	Open self into a lazy iterator stream over its elements.

From nu.forms.collections.abc.container.ContainerForm:

Call	Builds	Meaning
`.contains(item)`	`Bool`	Whether item is a member of self.

From nu.lang.forms.Form:

Call	Builds	Meaning
`a == b`	`Bool`	Self equal to other by value: an `Eq` term, never a Python bool.
`a != b`	`Bool`	Self not equal to other by value: a `Ne` term, never a Python bool.
`.is_empty()`	`Bool`	True if this Form yields the EMPTY sentinel.
`.not_empty()`	`Bool`	True if this Form does not yield EMPTY.
`.fallback(*alternatives)`	`Self`	The first of this value and `alternatives` that is not EMPTY.

From builtins.object: