map_var	Die Funktion m$findNext erwartetet (wie alle m$*() Funktionen) als ersten Parameter eine Referenz auf eine (ggf. indizierte) Variable. Diese Variable wird identisch zu map() zwangsweise in eine Map gewandelt, um anschließend modifiziert zu werden. Der Inhalt der Variable map_var wird nicht auf den Stack kopiert. Stattdessen wird direkt und damit effizient auf den Inhalt der Variable zugegriffen.
search	Eine Zeichenkette mit einem Schlüssel, zu dem der Nachfolger gesucht werden sollen. Bei NONE oder einem ungültigen Wertetyp wird das erste Element der Map gesucht.

Beschreibung:

In einer Map wird das Element gesucht, welches der Nachfolger von search ist. Dabei muss das Element mit dem Schlüssel search nicht unbedingt existieren. Ist search==NONE, dann wird der Schlüssel des ersten Elementes gesucht.

Dieses Funktion eignet sich auch zum Iterieren durch eine Map, wobei normalerweise das Kommando #FOREACH vorzuziehen ist:

#def key = @none
#loop
    #def key = m$findNext(map,key)
    #break #if key == @none
    ....
#endloop

Funktionsergebnis: STRING

Als Funktionsergebnis wird der Schlüssel des gefundenen Elementes geliefert. Sollte kein solches Element existieren, dann wird ersatzwesie NONE als Funktionsergebnis geliefert.

Siehe auch:
m$findPrev() m$find3() m$find2()

Weitere ähnliche Funktionen:

Maps
Funktion	Kurzinfo
catMap()	—
flatList()	Die komplette Listen- und/oder Map-Struktur in eine flache Liste überführen.
isMap()	Test, ob eine Variable mit gegebenen oder errechnetem Namen existiert und vom Typ MAP ist.
keyMap()	—
len()	Die Anzahl der Zeichen einer Zeichenkette bzw. die Anzahl der Elemente einer Liste oder einer Map bestimmen.
length()	Die Anzahl der Zeichen einer Zeichenkette bzw. die Anzahl der Elemente einer Liste oder einer Map bestimmen.
m$cat()	—
m$clear()	—
m$exist()	—
m$find2()	Ein Element in einer Map oder ersatzweise die virtuellen Nachbarn suchen.
m$find3()	Ein Element in einer Map und seine virtuellen Nachbarn suchen.
m$findKeys()	—
m$findKeysBegin()	—
m$findKeysEnd()	—
m$findKeysPCRE()	—
m$findKeysRE()	—
m$findNext()	Den Nachfolger in einer Map zu einem gegebenen Schlüssel finden.
m$findPrev()	Den Vorgänger in einer Map zu einem gegebenen Schlüssel finden.
m$keys()	—
m$length()	Die Anzahl der Elemente einer Map bestimmen.
m$map()	—
m$operation()	Operationen mit Mengen, bei denen Elemente Werte besitzen.
m$pack()	—
m$purge()	—
m$size()	—
map()	—
mapOperation()	Operationen mit Mengen, bei denen Elemente Werte besitzen.

Suchen & Ersetzen
Funktion	Kurzinfo
compilePCRE()	Eine PCRE übersetzen und einer eindeutigen ID zuweisen.
compileRE()	Eine RegEx übersetzen und einer eindeutigen ID zuweisen.
count()	—
countNum()	Die Anzahl der numerischen Elemente zählen.
countPCRE()	Die Anzahl der Treffer eines PCRE berechnen.
countRE()	Die Anzahl der Treffer eines RegEx berechnen.
countVal()	Die Anzahl der skalaren Elemente zählen.
find()	—
findAllPCRE()	Alle Vorkommen einer Zeichenkette mittels eines PCRE suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findAllRE()	Alle Vorkommen einer Zeichenkette mittels eines RegEx suchen und eine Liste mit den Fundpositionen und Fundtexten als Ergebnis liefern.
findPCRE()	Eine Zeichenkette mittels eines PCRE suchen und die Startposition dieser Zeichenkette ermitteln.
findRE()	Eine Zeichenkette mittels eines RegEx suchen und die Startposition dieser Zeichenkette ermitteln.
findReverse()	—
findTextPCRE()	Eine Zeichenkette mittels eines PCRE suchen und den gefundenen Text als Ergebnis liefern.
findTextRE()	Eine Zeichenkette mittels eines RegEx suchen und den gefundenen Text als Ergebnis liefern.
item()	—
itemPCRE()	—
itemRE()	—
m$find2()	Ein Element in einer Map oder ersatzweise die virtuellen Nachbarn suchen.
m$find3()	Ein Element in einer Map und seine virtuellen Nachbarn suchen.
m$findKeys()	—
m$findKeysBegin()	—
m$findKeysEnd()	—
m$findKeysPCRE()	—
m$findKeysRE()	—
m$findNext()	Den Nachfolger in einer Map zu einem gegebenen Schlüssel finden.
m$findPrev()	Den Vorgänger in einer Map zu einem gegebenen Schlüssel finden.
replace()	—
split()	—
splitEol()	Aus einem Text eine Liste mit den einzelnen Zeilen erzeugen.
splitPCRE()	—
splitRE()	—
splitString()	—
subst()	Eine Zeichenkette suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
substChar()	In einer Zeichenkette nach einzelnen Zeichen suchen und die Fundstellen durch Zeichenketten ersetzen.
substPCRE()	Eine Zeichenkette mittels eines Perl kompatiblen regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.
substRE()	Eine Zeichenkette mittels eines regulären Ausdrückes suchen und die Fundstelle durch eine andere Zeichenkette ersetzen.