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