Inhaltsverzeichnis
Werbung
13.6. PROTOKOLLMONITOR SPEZIFISCHE LUA ERWEITERUNGEN
mehreren Teilnehmern ist dies nicht zwangsläufig das vorherige Telegramm.
D.h. Sie brauchen eine Möglichkeit über die zuvor empfangenen Telegramme
zu 'iterieren' um das passende Telegramm zu finden.
Der Zugriff auf ein beliebiges Telegramm erfolgt einfach per Aufruf der Modul
Funktion telegrams.at(index) wobei index die Nummer des gewünschten
Telegramms ist.
Der Rückgabewert (oder das Rückgabeobjekt) ist immer vom Typ telegram
(siehe 13.6.6). Dieser spezielle Typ agiert als ein Interface und stellt Ihnen die
gleichen Funktionen zur Verfügung, die Sie bereits von dem Modulen tg und
tgprev gewöhnt sind.
telegrams.at ist die einzige Funktion die Sie für den Zugriff auf ein bestimm-
tes Telegramm benötigen. Da es sich beim Abruf des aktuellen oder vorherigen
Telegramms aber um die am meisten benötigten Operationen handelt, bietet
das Modul zwei entsprechende Alias Funktion. Die folgende Tabelle listet alle
Modul Funktionen auf:
Funktion
Beschreibung
at
liefert das Telegramm mit der angegebenen Nummer bzw. Po-
sition.
this
liefert das aktuell in out() behandelte Telegramm. Dies
ist ein Alias und gleichbedeutend mit dem Aufruf für
telegrams.at(-1).
prev
liefert das vorherige in out() behandelte Telegramm. Ent-
spricht dem Aufruf telegrams.at(-2).
telegrams.at
Die Funktion telegrams.at(index) akzeptiert absolute und relative Indexe
und liefert das zugehörige Telegramm - oder nil, wenn Sie einen ungültigen
Index übergeben. Der (Zeit)Aufwand für den Telegrammzugriff ist immer linear.
Es macht keinen Unterschied ob Sie das zuletzt empfangene oder allererste
Telegramm abfragen.
Absolute Telegrammnummern sind immer positiv. Sie starten mit einem Index
von 1 (erstes Telegramm) und enden mit der Nummer des letzten aufgenom-
menen Telegramms.
Relative Index hingegen zählen vom aktuell in der out() Funktion bearbeiten
Telegramm und werden als negative Werte übergeben. Ein Index von -1 liefert
das aktuelle Telegramm (und macht das tg Modul obsolete), ein Index -2 das
vorherige (bisher per tgprev realisiert), ein Index von -3 das vorvorletzte (im-
mer bezogen auf das in out() behandelte Telegramm), usw.
Da in der out() Funktion immer nur das EINE Telegramm bezogen auf die
entsprechende Zeile im Ausgabefenster bearbeitet wird, ist eine relative Inde-
xierung viel praktischer, da Sie nicht über die zugehörige absolute Telegramm-
nummer nachdenken müssen.
telegrams.at( index )
index: Der Index oder die Nummer des angeforderten Telegramms. Ein
positiver Index zählt vom Beginn der Aufnahme, ein negativer Index zählt
rückwärts vom aktuell in out() behandelten Telegramm.
159
Werbung
Inhaltsverzeichnis
