Luce packages
LuceLuce BaseLuciaOS

dymokomi/luce-browser-foundation

Source of release 0.6.1

0.6.1 / src / ak / enumerate.lucb

#==============================================================================================
#
#   enumerate - enumerate(range): (index, value) pairs
#
#   DESCRIPTION:
#       Port of AK/Enumerate.h (lines 1-59). luce-base spans enumerate themselves
#       (`for (index, value) in items.indexed()`); enumerate() over a Vector or any
#       IndexedContainer is an Enumerator whose iterator yields EnumeratorItem pairs of an
#       index and a pointer to the element, so `for item in enumerate(&v):` walks it.
#
#==============================================================================================

## Enumerator::Enumeration: the index of an element and the element.
pub struct EnumeratorItem[T]:
    pub var index: usize
    pub var value: T*

## Enumerator::Iterator: the index and the container being walked; also a luce-base iterator.
pub struct EnumeratorCursor[T, TContainer: IndexedContainer[T]]: luce.Iterable[EnumeratorItem[T], EnumeratorCursor[T, TContainer]], luce.Iterator[EnumeratorItem[T]]:
    pub var index: usize
    pub var container: TContainer*

    pub func iterator() -> EnumeratorCursor[T, TContainer]: return self

    pub func next() -> EnumeratorItem[T]?: return enumerator_cursor_next(&self)

## Enumerator::Iterator::operator* and operator++: the current pair, and the cursor advanced;
## none past the end.
pub func enumerator_cursor_next[T, TContainer: IndexedContainer[T]](this: EnumeratorCursor[T, TContainer]*) -> EnumeratorItem[T]?:
    if this.index >= this.container.size():
        return none
    let item = EnumeratorItem[T](index = this.index, value = this.container.at(this.index))
    this.index += 1
    return item

## Ported from AK/Enumerate.h:41 AK::Detail::Enumerator::begin.
pub func enumerator_begin[T, TContainer: IndexedContainer[T]](this: Enumerator[TContainer*]*) -> EnumeratorCursor[T, TContainer]:
    return EnumeratorCursor[T, TContainer](index = 0, container = this.iterable)

## Ported from AK/Enumerate.h:42 AK::Detail::Enumerator::end.
pub func enumerator_end[T, TContainer: IndexedContainer[T]](this: Enumerator[TContainer*]*) -> EnumeratorCursor[T, TContainer]:
    return EnumeratorCursor[T, TContainer](index = this.iterable.size(), container = this.iterable)

## Ported from AK/Enumerate.h:48 AK::enumerate: the (index, element) pairs of a container.
pub func enumerate[T, TContainer: IndexedContainer[T]](range: TContainer*) -> EnumeratorCursor[T, TContainer]:
    var enumerator = Enumerator[TContainer*](iterable = range)
    return enumerator_begin[T, TContainer](&enumerator)