⚡ V SIGIL DIFFICULTY: Apprentice Behavioral

The Iterator Sigil

Traversing an unknown, non-euclidean collection of arcane items sequentially.

✧ GANG OF FOUR LINEAGE & ARCANUM ✧
GOF DESIGN PATTERN: Iterator
ARCANUM SCHOOL: Divination // Scrying
SCRIBE / ARCHON: Joshua Edward McLaughlin Cox
CANONICAL REGISTRATION:
// V PATTERN //
module main

struct Artifact {
	name string
}

interface Iterator {
mut:
	has_next() bool
	next() Artifact
}

struct Vault {
	items []Artifact
}
fn (v Vault) create_iterator() Iterator {
	return VaultIterator{vault: v, index: 0}
}

struct VaultIterator {
	vault Vault
mut:
	index int
}
fn (mut i VaultIterator) has_next() bool {
	return i.index < i.vault.items.len
}
fn (mut i VaultIterator) next() Artifact {
	item := i.vault.items[i.index]
	i.index++
	return item
}

fn main() {
	vault := Vault{
		items: [Artifact{name: "Chalice of Void"}, Artifact{name: "Dagger of Time"}]
	}

	mut iter := vault.create_iterator()
	for iter.has_next() {
		artifact := iter.next()
		println("Scried artifact: \$artifact.name")
	}
}

The Iterator Sigil

A magus should not be concerned with the inner dimensionality of a Vault. The Iterator extracts the traversal logic from the collection, providing a sequential scrying window over the artifacts. In V, while native loops exist, an explicit iterator enables traversing complex, generated, or paginated arcane data sources securely.

Runic Tags: #vlang #iterator #behavioral #scrying