Info: Enthaelt Makros zum Umgang mit Listen, die aus Schluessel-Wert-Paaren bestehen; dabei kann der Wert auch wieder eine Liste sein.
Sonstiges: hashliste, felder, index, getivalue liefert den wert an position 'index'. der index beginnt bei null!, iskey liefert 1 zurueck, wenn der angegebene schluessel in der liste enthalten ist, ansonsten error., listen
Siehe auch: indexindex(tf), listen
Kommandos: hshowlist, showlist, savehrlist, savelist, loadlist, addlisttosave, savealllists, loadhrlist
Makros: sreplace, paramparse, islist, sortforeach, hsortforeach, hashlist, removehashed, hxaddtolist, haddtolist, hforeach, haddlisttosave, hcreatelist, hcopylist, hloadlist, hsavelist, hcount_entries, hgetvalueof, hdelallkeysandvalues, hdeletekeyandvalue, hgetdvalueof, hgetlistvalueof, haddlisttolist, hxaddlisttolist, hgetentrylist, aget, aput, aclear, alen, astart, ashow, asshow, aswap, ascmp, asicmp, ancmp, amsort, amsort1, asort, aforeach, aforeach2, asortforeach, hasortforeach, split_list, merge_lists, umerge_lists2, hmerge_lists, createlist, xaddbtolist, xaddtolist, addtolist, uaddtolist, addbtolist, addlisttolist, uaddlisttolist, xaddlisttolist, foreach, reggetvalueof, reggetkey, reggetkeyofvalue, reggetvalue, getidxofvalue, getidxofkey, reggetidxofvalue, reggetidxofkey, getvalueof, getnextvalueof, count_entries, getdvalueof, geti, delikeyandvalue, getivalue, getikey, getkeyofvalue, iskey, getdlistvalueof, makesub, unmakesub, getlistvalueof, deletekeyandvalue, delallkeysandvalues, getfirstvalue, getfirstkey, showlist2, listkeys, showshortlist
Benoetigt: loading.tf, util.tf
Variablen: value (ganz wichtig)
Listen: lists
Datei: lists.tf
Version: lists.tf,v 1.7 2001/09/13 22:06:36 nieten (Mesirii@mg.mud.de)
Aenderungen: 1.01 Wenn /loadlist das File nicht findet, werden existierende listen unveraendert gelassen.
1.02 /loadlist, /savelist, /loadhrlist, /savehrlist mit /custom Parameter '-c' versehen (siehe /custom), damit auch Listen aus mudspezifischen Verzeichnissen geladen werden koennen.
1.04 Der Parameter '-c' wurde ergaenzt, so dass auch '-cp' moeglich ist. Damit werden neben mudspezifischen auch darunterliegende playerspezifische Verzeichnisse als Ablage moeglich (siehe /custom).
-------------------------
(top) Source of: lists.tf
Info: Ersetzt Parameter1 durch Parameter2 im dem String, der als restlicher Parameter angegeben ist. Das Ergebnis wird mit /echo(tf) ausgegeben, also ueber $() holen. Dabei koennen Parameter1 bzw. Parameter2 auch \space fuer Leerzeichen sein.
Syntax:
/replace (suchtext|\space) (ersetztext|\space) string
Rueckgabewert: ueber /echo den veraenderten String
Siehe auch: substitution(tf)
Datei: lists.tf
Info: Erlaubt einen anderen Parameterseparator als das Leerzeichen. Dabei werden /paramparse als Parameter1 der Separator, als Parameter2 die gewuenschte Position (1,2,3 oder -1,-2,-3...) und als Rest die Parameter uebergeben.
Syntax:
/paramparse separator [-](1,2,3..) Parameter
Rueckgabewert: ueber /echo, also mit $() abholen
Siehe auch: substitution(tf), regexp(tf)
Datei: lists.tf
Info: Liefert einen Wert ungleich 'error' zurueck, wenn die Variable dem Anschein nach eine Liste ist, also mit
Beispiel:
/isList listenname
Rueckgabewert: error (%error) bei Fehler
Datei: lists.tf
Info: Hat die gleiche Funktionalitaet wie /forEach, die Werte werden aber alphabetisch sortiert bearbeitet.
Alte Version
Beispiel:
sortForEach liste k[v] /makroname
Datei: lists.tf
Info: Hat die gleiche Funktionalitaet wie /hforEach (also fuer Hashlisten), die Werte werden aber alphabetisch sortiert bearbeitet.
Alte Version
Beispiel:
hsortForEach liste k[v] /makroname
Datei: lists.tf
Info: Hashlisten basieren darauf, dass tf-Variablen beliebig zur Laufzeit erzeugt werden koennen. Fuer jeden Schluessel in der Liste wird der Hashwert (siehe /hash) gebildet und dieser an eine Variable mit dem Namen der Liste angehaengt (z.B. 'weapons___329874923'). In dieser Variablen wird nun eine normale Liste aller Schluessel-Wert-Paare gespeichert, deren Schluessel denselben Hashcode erzeugen. Der Zugriff auf die TF-Variablen ist um ein Vielfaches schneller als die Arbeit mit riesigen Strings.
Datei: lists.tf
Info: Wandelt eine normale Liste in eine Hashliste um.
Beispiel:
/hashlist listenname
Datei: lists.tf
Info: Wandelt eine Hashliste wieder in eine normale Liste um, das kann ggf. dauern ;)
Beispiel:
/removehashed listenname
Datei: lists.tf
Info: Fuegt ein Schluessel-Wert-Paar zu einer Hashliste hinzu, dabei kann der Schluessel auch mehrteilig sein, Trennung der Parameter durch '&'.
Datei: lists.tf
Info: Fuegt ein Schluessel-Wert-Paar zu einer Hashliste hinzu. Dabei darf der Schluessel keine Leerzeichen enthalten.
Datei: lists.tf
Info: Wie /forEach fuer normale Listen, arbeitet /hforEach eine Hashliste durch. Dabei ist jedoch nicht wie bei /forEach eine Reihenfolge garantiert. Die Schluessel und/oder Werte werden dem angegebenen Makro als Parameter uebergeben.
Beispiel:
hforEach listenname k[v] /makroname
Datei: lists.tf
Info: Verwaltet die aktuell geladenen Hashlisten in einer eigenen Liste, damit sie bei Aenderungen durch /saveall oder /savealllists gespeichert werden.
Beispiel:
/haddlisttosave listenname
Siehe auch: hsavelist, hloadlist, hashliste, saveall
Datei: lists.tf
Info: Erzeugt eine Hashliste, d.h. es werden alle Eintraege mit diesem Listennamen geloescht.
Beispiel:
/hcreatelist listenname
Siehe auch: createlist, hashliste
Datei: lists.tf
Info: Erstellt eine Kopie der angegebenen Hashliste.
Beispiel:
/hcopylist quellliste zielliste
Datei: lists.tf
Info: Analog zu /loadlist fuer normale Listen werden mit /hloadlist Hashliste n geladen. Die Dateien heissen listenname.hlist.
Beispiel:
/hloadlist [-q] [-c] listenname
Siehe auch: hsavelist, loadlist
Datei: lists.tf
Info: Wie /savelist fuer normale Listen speichert /hsavelist Hashliste n ab. Die Dateien heissen listenname.hlist
Beispiel:
/hsavelist [-q] [-c] listenname
Siehe auch: hloadlist, savelist
Datei: lists.tf
Info: Liefert die Anzahl der Schluessel in der angegebenen Hashliste zurueck.
Beispiel:
/hcount_entries listenname
Siehe auch: /count_entries
Datei: lists.tf
Info: Wie /getvalueof fuer normale Listen liefert es den zum angegebenen Schluessel gehoerenden Wert bei Hashliste n.
Beispiel:
/hgetvalueof listenname schluessel
Siehe auch: getvalueof, hashliste, getkeyofvalue
Datei: lists.tf
Info: Loescht alle Schluesseleintraege dieses Schluessels in der angegebenen Hashliste.
Beispiel:
/hdelallkeysandvalues liste schluessel
Datei: lists.tf
Info: Loescht den ersten Schluesseleintrag dieses Schluessels in der angegebenen Hashliste.
Beispiel:
/hdeletekeyandvalue liste schluessel
Datei: lists.tf
Info: Liefert den ersten Wert, der mit dem angegebenen Schluessel in der Hashliste eingetragen ist, und loescht diesen Eintrag. Gut zum Durcharbeiten der Liste geeignet.
Beispiel:
/hgetdvalueof liste schluessel
Siehe auch: getdvalueof, hgetvalueof
Datei: lists.tf
Info: Liefert den Wert des angegebenen Schluessels als Liste zurueck. D.h. wenn er vorher mit /haddlisttolist hinzugefuegt wurde, ist es notwendig, dies rueckgaengig zu machen. Die Ergebnisliste ist eine normale Liste, sie kann mit '/set(tf) listenname=%value' gesichert werden.
Beispiel:
/hgetlistvalueof liste schluessel
Siehe auch: hgetvalueof, getlistvalueof, haddlisttolist, hxaddlisttolist
Datei: lists.tf
Info: Fuegt die als Wert (%variable) angebebene Liste unter dem angegebenen Schluessel zur Hashliste hinzu. Dabei wird die Liste modifiziert, um als Subliste innerhalb der eigentlichen Liste erhalten zu bleiben.
Beispiel:
/haddlisttolist listename schluessel wertliste
Siehe auch: hgetlistvalueof, addlisttolist, makesub, unmakesub, hxaddlisttolist
Datei: lists.tf
Info: Fuegt die als Wert (%variable) angebebene Liste unter dem angegebenen Schluessel zur Hashliste hinzu. Dabei wird die Liste modifiziert, um als Subliste innerhalb der eigentlichen Liste erhalten zu bleiben. Damit der Schluessel auch Leerzeichen enthalten kann, muessen die Parameter durch '&' getrennt werden.
Beispiel:
/hxaddlisttolist listename&schl ues sel&wertliste
Siehe auch: hgetlistvalueof, addlisttolist, makesub, unmakesub, haddlisttolist
Datei: lists.tf
Info: Liefert eine Liste zurueck, in der alle Eintraege mit dem angegebenen Schluessel gesammelt sind.
Beispiel:
hgetentrylist listenname schluessel
Rueckgabewert: in %value eine normale Liste der Eintraege und Werte
Datei: lists.tf
Info: Die Felder sind einfach eine Abbildung auf TF-Variablen, in denen dann die Inhalte stehen. Dabei wird der Variablenname wie folgt zusammengesetzt: 'array_feldname___index'. Die hoechsten und niedrigsten Indizes stehen in 'array_feldname___maxlen' und '*___minlen', werden aber auch von /alen und /astart geliefert.
Siehe auch: aget, aput, ashow, asshow, asort, amsort, aforEach, alen, astart, aclear
Datei: lists.tf
Info: Liefert den Wert des Feldes am angegebenen Index zurueck.
Beispiel:
/aget feldname index
Rueckgabewert: in %value und als Rueckgabewert
Siehe auch: aput
Datei: lists.tf
Info: Setzt den Wert des Feldes am angegebenen Index.
Beispiel:
/aput feldname index wert
Siehe auch: aget
Datei: lists.tf
Info: Loescht die Variablen, die das angegebene Feld ausmachen, und setzt die min/max Indizes neu.
Beispiel:
/aclear feldname
Datei: lists.tf
Info: Liefert den hoechsten Index des angegebenen Feldes zurueck.
Beispiel:
/alen feldname
Rueckgabewert: als Rueckgabewert
Siehe auch: astart
Datei: lists.tf
Info: Liefert den hoechsten Index des angegebenen Feldes zurueck.
Beispiel:
/astart feldname
Rueckgabewert: als Rueckgabewert
Siehe auch: alen
Datei: lists.tf
Info: Zeigt die Variablen an, die das angegebene Feld ausmachen.
Beispiel:
/ashow feldname
Siehe auch: asshow
Datei: lists.tf
Info: Zeigt nur die Werte an, die das angegebene Feld ausmachen.
Beispiel:
/asshow feldname
Siehe auch: ashow
Datei: lists.tf
Info: Tauscht die Feldwerte an den angegebenen Indizes aus.
Beispiel:
/aswap feldname index1 index2
Siehe auch: asort
Datei: lists.tf
Info: Vergleichsfunktion auf Stringbasis. Liefert einen Wert < 0, wenn der Feldwert an 'index1' lexikalisch kleiner ist als an 'index2'.
Beispiel:
/ascmp feldname index1 index2
Rueckgabewert: in %value und als Rueckgabewert
Datei: lists.tf
Info: Vergleichsfunktion auf Stringbasis. Liefert einen Wert < 0, wenn der Feldwert an 'index1' lexikalisch kleiner ist als an 'index2'.
Beispiel:
/asicmp feldname index1 index2
Rueckgabewert: in %value und als Rueckgabewert
Datei: lists.tf
Info: Vergleichsfunktion auf numerischer Basis. Liefert einen Wert < 0, wenn der Feldwert an 'index1' kleiner ist als an 'index2'.
Beispiel:
/ancmp feldname index1 index2
Rueckgabewert: in %value und als Rueckgabewert
Datei: lists.tf
Info: Merge-Sort Implementation fuer die Felder. Es werden das zu sortierende Feld, min und maxIndex sowie der Name der Sortierfunktion uebergeben. Ausserdem ist es moeglich, ein Feld anzugeben, das in derselben Weise wie das Sortierfeld mitgetauscht wird.
Beispiel:
/amsort feldname von bis sortierfunc(z.B. asicmp,ascmp,ancmp) zweitfeld
Siehe auch: amsort1
Datei: lists.tf
Info: Eigentliche Implementation des Merge-Sort-Algorithmus. Wird rekursiv aufgerufen.
Beispiel:
/amsort1 von bis
Variablen: amsort_base = Sortierfeld, amsort_func = Sortierfunktion, amsort_base2 ggf. zweitfeld
Datei: lists.tf
Info: Quick-Sort-Implementation fuer die Felder. Es werden das zu sortierende Feld, min und maxIndex sowie der Name der Sortierfunktion uebergeben. Ausserdem ist es moeglich, ein Feld anzugeben, das in der selben Weise wie das Sortierfeld mitgetauscht wird.
Beispiel:
/asort feldname von bis sortierfunc(z.B.asicmp,ascmp,ancmp) zweitfeld
Siehe auch: amsort
Datei: lists.tf
Info: Wie /forEach bzw. /hforEach fuer Listen arbeitet /aforEach alle Elemente eines Feldes durch, indem sie als Parameter fuer das uebergebene Makro genutzt werden.
Beispiel:
/aforEach feldname /makroname
Datei: lists.tf
Info: Wie /forEach bzw. /hforEach fuer Listen arbeitet /aforEach2 alle Elemente zweier Felder durch, indem sie als Parameter fuer das uebergebene Makro genutzt werden.
Beispiel:
/aforEach2 feldname feldname2 /makroname
Datei: lists.tf
Info: Erfuellt dieselbe Funktion wie /forEach fuer Listen, nur dass die Elemente sortiert bearbeitet werden. Dabei kann in der Variablen 'sort_alg' (moeglichst als lokale Variable) der Sortieralgorithmus eingestellt werden ('asort' oder 'amsort'), sowie in der Variablen 'comp_func' die Vergleichsfunktion ('asicmp', 'ascmp', 'ancmp').
Beispiel:
/asortForEach listenname k[v] /makroname
Siehe auch: forEach, asort, amsort, asicmp, ascmp, ancmp, hasortForEach
Variablen: sort_alg, comp_func
Datei: lists.tf
Info: Erfuellt dieselbe Funktion wie /hforEach fuer Hashlisten, nur dass die Elemente sortiert bearbeitet werden. Dabei kann in der Variablen 'sort_alg' (moeglichst als lokale Var) der Sortieralgorithmus eingestellt werden ('asort' oder 'amsort'), sowie in der Variablen 'comp_func' die Vergleichsfunktion ('asicmp', 'ascmp', 'ancmp').
Beispiel:
/hasortForEach listenname k[v] /makroname
Siehe auch: hforEach, asort, amsort, asicmp, ascmp, ancmp, asortForEac
Variablen: sort_alg, comp_func
Datei: lists.tf
Info: Die angegebenen Schluessel werden aus der als ersten Parameter angegebenen Lister geloescht und mit ihren Werten in die Liste 'split_list' eingetragen
Datei: lists.tf
Info: Fuegt zwei Listen zusammen, wobei Schluessel, die in beiden Listen vorkommen, aus der zuerst angegebenen genommen werden. Die Ergebnisliste heisst 'merge_list'.
Beispiel:
/merge_lists liste1 liste2
Rueckgabewert: Ergebnisliste merge_list
Siehe auch: hmerge_lists
Datei: lists.tf
Info: Kopiert in Inhalt der ersten in die zweite Liste, wobei je nach Parameter 3 (kv) Schluessel und/oder Werte kopiert werden. Dabei werden schon vorhandene Schluessel ueberschrieben.
Beispiel:
/umerge_lists2 katzen tiere kv
Datei: lists.tf
Info: Fuegt zwei Hashlisten zusammen, wobei Schluessel, die in beiden Listen vorkommen, aus der zuerst angegebenen genommen werden. Die Ergebnisliste heisst 'hmerge_list'.
Beispiel:
/hmerge_lists liste1 liste2
Rueckgabewert: Ergebnisliste hmerge_list
Siehe auch: merge_lists
Datei: lists.tf
Info: Erstellt eine leere Liste. Diese Liste wird in der globalen Variable mit dem angegebenen Namen gehalten.
Syntax:
/createlist liste
Datei: lists.tf
Info: Fuegt einen Schluessel, in dem auch Leerzeichen enthalten sein koennen, und einen Wert, die durch ein kaufmaennisches UND ('&') getrennt sind, an den Anfang einer Liste ein.
Syntax:
/xaddbtolist listeK.UNDkeyK.UNDwert
Datei: lists.tf
Info: Fuegt einen Schluessel, in dem auch Leerzeichen enthalten sein koennen, und einen Wert, die durch ein kaufmaennisches UND ('&') getrennt sind, am Ende einer Liste ein.
Syntax:
/xaddtolist listeK.UNDkeyK.UNDwert
Datei: lists.tf
Info: Fuegt einen Schluessel (ohne Leerzeichen) und einen Wert an das Ende einer Liste an.
Syntax:
/addtolist liste key wert
Siehe auch: addbtolist, getvalueof
Datei: lists.tf
Info: Fuegt einen Schluessel (ohne Leerzeichen) und einen Wert an das Ende einer Liste an, nachdem alle bisherigen Vorkommen des Schluessels geloescht wurden.
Syntax:
/uaddtolist liste key wert
Siehe auch: addtolist, getvalueof
Datei: lists.tf
Info: Fuegt einen Schluessel (ohne Leerzeichen) und einen Wert am Anfang einer Liste ein.
Syntax:
/addbtolist liste key wert
Siehe auch: addtolist
Datei: lists.tf
Info: Fuegt einen Schluessel (ohne Leerzeichen) und eine (Sub)Liste am Ende einer Liste an. In der Subliste werden relevante Zeichen ersetzt (Stern->Llammeraffe, Doppelkreuz->kaufm. Und).
Syntax:
/addlisttolist liste key subliste(der inhalt!)
Siehe auch: addtolist, getlistvalueof
Datei: lists.tf
Info: Fuegt einen Schluessel (ohne Leerzeichen) und eine (Sub)Liste am Ende einer Liste an. In der Subliste werden die Listentrenner um eine Stufe erweitert.
Syntax:
/addlisttolist liste key subliste(der inhalt!)
Siehe auch: addtolist, uaddtolist, getlistvalueof
Datei: lists.tf
Info: Fuegt einen Schluessel und eine (Sub)Liste am Ende einer Liste an. Dabei kann der Schluessel Leerzeichen enthalten. Die einzelnen Parameter muessen durch das Trennzeichen kaufmaennisches UND ('&') getrennt sein.
Syntax:
/xaddlisttolist listeK.UNDkeyK.UNDsubliste(der inhalt!)
Siehe auch: xaddtolist, addlisttolist, getlistvalueof
Datei: lists.tf
Info: Fuehrt fuer jedes Paar der Liste das angegebene Makro mit den entsprechenden Parametern (Schluessel und/oder Wert) aus.
Syntax:
forEach liste (k|v|kv) /makro - der zweite Parameter sagt aus, was dem Makro uebergeben wird (key|value|key value)
Variablen: fetemp_list
Datei: lists.tf
Info: Wie /getvalueof nur, dass der Schluessel als regexp angegeben ist (ohne Klammern rundherum).
Syntax:
/reggetvalueof liste Schluessel (als regexp)
Rueckgabewert: value=erster zum Schluessel passender Wert
Siehe auch: getvalueof, regexp(tf), reggetkey
Datei: lists.tf
Info: Es wird der erste Schluessel geliefert, auf den die uebergebene regexp passt.
Syntax:
/reggetkey liste regexp
Rueckgabewert: value=erster zum Wert passender Schluessel
Siehe auch: getkeyofvalue, regexp(tf), reggetvalueof
Makros: getikey
Datei: lists.tf
Info: Wie /getkeyofvalue nur, dass der Wert als regexp angegeben ist (ohne Klammern rundherum).
Syntax:
/reggetkey liste regexp
Rueckgabewert: value=erster zum Wert passender Schluessel
Siehe auch: reggetkeyofvalue, regexp(tf), reggetvalueof
Makros: getikey
Datei: lists.tf
Info: Liefert den ersten Wert zurueck, auf den die regexp passt.
Syntax:
/reggetvalue liste regexp
Rueckgabewert: value=erster zur regexp passender Wert
Siehe auch: regexp(tf)
Makros: getivalue
Datei: lists.tf
Info: Liefert den Index des angegebenen Wertes zurueck. Taucht der Wert mehrmals in der Liste auf, wird der kleinste passende Index zurueckgegeben.
Syntax:
/getidxofvalue liste wert
Rueckgabewert: value=Index des Wertes
Siehe auch: reggetidxofvalue, geti, getikey, getivalue
Datei: lists.tf
Info: Liefert den kleinsten Index des angegebenen Schluessels zurueck. Taucht der Schluessel mehrmals in der Liste auf, wird der kleinste passende Index zurueckgegeben.
Syntax:
/getidxofkey liste schluessel
Rueckgabewert: value=Index des Schluessels
Siehe auch: reggetidxofkey, geti, getikey, getivalue
Makros: getikey
Datei: lists.tf
Info: Liefert den Index des ersten Wertes zurueck, auf den die regexp passt.
Syntax:
/reggetidxofvalue liste regexp
Rueckgabewert: value=Index des ersten zur regexp passenden Wertes
Siehe auch: regexp(tf), geti, getikey, getivalue
Datei: lists.tf
Info: Liefert den Index des ersten Schluessels zurueck, auf den die regexp passt.
Syntax:
/reggetidxofkey liste regexp
Rueckgabewert: value=Index des ersten zur regexp passenden Schluessels
Siehe auch: regexp(tf), geti, getikey, getivalue
Makros: getikey
Datei: lists.tf
Info: Liefert den ersten Wert mit diesem Schluessel zurueck.
Syntax:
/getvalueof liste Schluessel
Rueckgabewert: value=erster zum Schluessel passender Wert oder error bei Fehler.
Datei: lists.tf
Info: Liefert bei aufeinanderfolgenden Aufrufen die verschiedenen Werte, die zu einem Schluessel in der Liste gespeichert sind.
Syntax:
/getnextvalueof list schluessel
Rueckgabewert: in %value der Wert zu diesem Schluessel oder error, wenn keine (mehr) vorhanden sind
Datei: lists.tf
Info: Liefert die Anzahl der Eintraege in der angegebenen Liste
Beispiel:
/count_entries listename
Rueckgabewert: als echo und Rueckgabewert
Datei: lists.tf
Info: Gibt den ersten gefundenen zum Schluessel passenden Wert zurueck und loescht ggf. das Paar.
Syntax:
/getdvalueof liste key
Rueckgabewert: value=erster zum Schluessel passender Wert oder error bei Fehler.
Siehe auch: getvalueof, deletekeyandvalue
Datei: lists.tf
Info: Beim Arbeiten mit Listen und Indizes ist zu beachten, dass die Zaehlung des Index bei Null beginnt!
Makros: geti, getidxofkey, getidxofvalue, reggetidxofkey, reggetidxofvalue, delikeyandvalue, getikey, getivalue
Datei: lists.tf
Info: Liefert den Teil der Liste zurueck, der am Index beginnt. Diese Funktion ist zum internen Gebrauch bestimmt. Der Index beginnt bei Null!
Syntax:
/geti liste index
Rueckgabewert: value=Liste ab Index
Siehe auch: indexindex(tf), geti, getikey, getivalue, delikeyandvalue
Datei: lists.tf
Info: Loescht das Paar (Schluessel und Wert) am Index. Der Index beginnt bei Null!
Syntax:
/delikeyandvalue liste index
Rueckgabewert: value=error bei Misserfolg
Siehe auch: indexindex(tf), deletekeyandvalue, deleteallkeys
Datei: lists.tf
Syntax:
/getivalue liste index
Rueckgabewert: value=Wert am Index, error bei Misserfolg
Siehe auch: indexindex(tf), getikey, getidxofvalue
Makros: geti
Datei: lists.tf
Info: Liefert den Schluessel mit dem angegebenen Index zurueck. Der Index beginnt bei Null!
Syntax:
/getikey liste index
Rueckgabewert: value=Schluessel am Index, error bei Misserfolg
Siehe auch: indexindex(tf), getivalue, getidxofkey
Makros: geti
Datei: lists.tf
Info: Liefert zum gegebenen Wert den Schluessel. Wenn der Wert in der Liste nicht eineindeutig ist, wird der erste gefundene Schluessel geliefert.
Syntax:
/getkeyofvalue liste Wert
Rueckgabewert: value=Schluessel mit diesem Wert, error bei Misserfolg
Siehe auch: getvalueof
Datei: lists.tf
Syntax:
/iskey liste key
Rueckgabewert: value=1 wenn Schluessel in Liste, error bei Misserfolg
Siehe auch: getvalueof
Datei: lists.tf
Info: Holt die Subliste, die dem Schluessel zugeordnet ist, aus der Liste und loescht sie.
Syntax:
/getdlistvalueof liste schluessel
Rueckgabewert: value=Subliste, die dem Schluessel zugeordnet ist oder error bei Misserfolg.
Siehe auch: getlistvalueof
Makros: getdvalueof, makelistofvalue, deletekeyandvalue, dele
Datei: lists.tf
Info: Substituiert im String Listentrennzeichen durch Sublistentrennzeichen usw.
Syntax:
/makesub string
Rueckgabewert: per /echo also $()
Siehe auch: getlistvalueof, addlisttolist, unmakesub
Datei: lists.tf
Info: Substituiert im String Sublistentrennzeichen durch Listentrennzeichen usw.
Syntax:
/unmakesub string
Rueckgabewert: per /echo also $()
Siehe auch: getlistvalueof, addlisttolist, makesub
Datei: lists.tf
Info: Holt die Subliste, die dem Schluessel zugeordnet ist, aus der Liste.
Syntax:
/getlistvalueof liste schluessel
Rueckgabewert: value=Subliste, die Schluessel zugeordnet ist, oder error bei Misserfolg.
Siehe auch: getvalueof
Makros: getvalueof, makelistofvalue, replace(tf)
Datei: lists.tf
Info: Loscht das (erste) Paar Schluessel-Wert.
Syntax:
/deletekeyandvalue liste schluessel
Rueckgabewert: value=error bei Misserfolg
Siehe auch: delallkeysandvalues, delikeyandvalue, getdvalueof, getdlistvalueof
Makros: getvalueof
Datei: lists.tf
Info: Loscht alle Paare Schluessel-Wert.
Syntax:
/delallkeysandvalues liste schluessel
Rueckgabewert: value=error bei Misserfolg
Siehe auch: deletekeyandvalue, delikeyandvalue, getdvalueof, getdlistvalueof
Makros: deletekeyandvalue
Datei: lists.tf
Info: Liefert den ersten Wert der Liste zurueck.
Syntax:
/getfirstvalue liste
Rueckgabewert: value=erster Wert der Liste oder error bei Misserfolg
Makros: getfirstkey, getvalueof
Datei: lists.tf
Info: Liefert den ersten Schluessel der Liste zurueck.
Syntax:
/getfirstkey liste
Rueckgabewert: value=erster Schluessel der Liste oder error bei Misserfolg
Datei: lists.tf
Info: Zeigt die angegebene Hashliste in einem lesbaren Format an. Sublisten werden eingerueckt.
Beispiel:
/hshowlist listenname
Makros: hforEach
Datei: lists.tf
Info: Zeigt die angegebene Liste in einem lesbaren Format an. Sublisten werden eingerueckt.
Syntax:
/showlist [-s] [-p] [-e] listenname
Optionen: -s Wenn angegeben werden Sublisten rekursiv dargestellt
-p Wenn angegeben wird die Ausgabe mit more seitenweise dargestellt
-e Wenn angegeben erfolgt die Ausgabe auf tferr
Beispiel:
/showlist listenname
Makros: forEach
Datei: lists.tf
Info: Hilfsmethode von showlist, fuehrt fuer alle Elemente der Liste die Darstellung durch, ggf. werden Sublisten wieder mit /showlist angezeigt.
Datei: lists.tf
Info: liefert alle Schluessel der angegebenen Liste als mit Komata getrennte Liste zurueck
Datei: lists.tf
Info: Zeigt die Liste an, so dass Wert aus Sublisten durch Komata getrennt werden und nicht jeweils auf einer Zeile stehen.
Beispiel:
/showshortlist listenname
Datei: lists.tf
Info: Speichert die angegebene Liste in menschenlesbarer Form. Die Datei heisst 'listenname.hr.list'.
Syntax:
/savehrlist liste
Siehe auch: savelist, tfio(tf)
Makros: savehrsublist
Variablen: temp_list, temp_handle
Datei: lists.tf
Aenderungen: 1.02 mit /custom Parameter '-c' versehen
Info: Speichert die angegebene Liste ab. Die Datei heisst 'listenname.list'. Eine ggf. vorhandene Aenderungsmarkierung wird geloescht.
Syntax:
/savelist [-c[directory]]liste
Siehe auch: savehrlist, tfio(tf)
Makros: deletekeyandvalue, getvalueof
Variablen: temp_handle
Datei: lists.tf
Info: Laedt die angegebene Liste aus der Datei 'listenname.list'. Dabei wird ihre Laenge als Veraenderungserkennung gemerkt. Wenn der Parameter '-c' (wie custom) angegeben wird, dann wird die Liste aus dem Verzeichnis ${world_host} (z.B. 'mg.mud.de') geladen.
Syntax:
/loadlist [-c[directory]] liste
Siehe auch: savelist
Makros: addlisttosave, createlist, load(tf)
Datei: lists.tf
Version: 1.02
Aenderungen: 1.01 Falls /loadlist das File nicht laden kann, werden schon existente Listen unberuehrt gelassen, ansonsten wird eine neue Liste intialisiert.
1.02 /custom directory Angabe ausgelagert.
Info: Speichert die Laenge der angegebenen Liste als Veraenderungsmerkmal.
Syntax:
/addlisttosave liste
Siehe auch: savelist, loadlist
Makros: deletekeyandvalue, addtolist
Variablen: _temp
Listen: lists
Datei: lists.tf
Info: Speichert die veraenderten Listen ab.
Syntax:
/savealllists
Siehe auch: savelist, loadlist
Makros: createlist, foreach
Variablen: tlists
Listen: lists
Datei: lists.tf
Info: Ist eine Liste, die die geladenen Listen und deren Laenge beim Laden enthaelt. Die Laenge wird dann mit der aktuellen Laenge verglichen, um etwaige Veraenderungen feststellen zu koennen.
Siehe auch: savealllists, addlisttosave, loadlist
Datei: lists.tf
Info: Laedt die angegebene Liste aus der Datei 'listenname.hr.list'. Dabei wird ihre Laenge als Veraenderungserkennung gemerkt.
Syntax:
/loadhrlist liste
Siehe auch: savehrlist, loadlist, savelist
Makros: addlisttosave, createlist, load(tf)
Variablen: makdir
Datei: lists.tf
Aenderungen: 1.02 mit /custom Parameter '-c' versehen
Info: Die Listenverwaltung bildet den Grundstock fuer alle anderen Makros. Die Listen bestehen jeweils aus Schluessel-Wert-Paaren, die durch Trennzeichen getrennt in einem grossen String stehen. Der Wert eines Schluessels kann auch wieder eine (Sub)Liste sein.
Siehe auch: createlist, addtolist, getvalueof usw.
Datei: lists.tf
lists.tf,v 1.7 2001/09/13 22:06:36 nieten (Mesirii@mg.mud.de) Key-Value Listen, Arrays, Sortierfunktionen, Iteratoren ... Requires: util.tf loading.tf
This file was created using TinyFugue (c) 1998 by Ken Keys at Fre 14 Sep 2001 23:37:05 MEST by Michael Hunger (mh14@inf.tu-dresden.de).