CX_SYSTEM_OBJECT::Log
Beschreibung:
Diese Funktion schreibt die angegebene Zeichenkette mit dem angegebenen Logger und dem übergebenen Log-Level in die Log-Datei.
Hinweis: Vor Dll-Version 224620 wurde nur die Angabe einer Log-Nachricht unterstützt. Die Funktion hat dann auf den Logger cx.app mit Level INFO geloggt, wodurch die Funktion im Grunde LogInfo entsprach.
Der Aufruf mit nur einem STRING-Parameter wird für die Rückwärtskompatibilität weiterhin untersützt und in dem Fall wird intern LogInfo aufgerufen.
Die folgenden Log-Level werden von dieser Funktion als Parameter unterstützt:
Level |
---|
TRACE |
DEBUG |
INFO |
WARN |
ERROR |
FATAL |
Der verwendete Logger muss nicht explizit in der logging.ini definiert werden, Unterlogger werden implizit erzeugt und erben die Log-Level ihres Parents. Falls also in der logging.ini der Logger cx.app=INFO gesetzt ist, dann kann mit dieser Methode auch auf cx.app.mylog geloggt werden und alle Meldungen mit einem Level ≥ INFO werden auf diesen Logger geloggt.
Es kann auch auf völlig willkürlich vergebene Loggernamen geloggt werden. Damit die Einträge geloggt werden, müssen diese Loggernamen entweder in der logging.ini aufgeführt werden, oder es muss mindestens auf dem Log-Level geloggt werden, welches in der logging.ini unter log4cplus.rootLogger= angegeben ist.
Bitte auch das Kommando Debug(LOG) beachten, sofern Abläufe protokolliert werden sollen.
Code-Beispiel:
x ifnot {
"Oh oh, something bad happened" "cx.app" ERROR SystemObject Call(Log)
}
// Old semantics
"Just a regular info log" SystemObject Call(Log)
Stack | Position | Objekttyp | Kurzbeschreibung |
---|---|---|---|
Stack(In) | Top | CX_SYSTEM_OBJECT | Das System-Objekt |
Top-1 | NOTIFICATION_LEVEL | Das Log-Level | |
Top-2 | STRING | Der Logger-Name | |
Top-3 | STRING | Der zu loggende Text | |
Stack(Out) | Top |