Lade...
 

CX_SYSTEM_OBJECT::Log

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.

"Testmessage" "my.special.logger.name" INFO SystemObject Call(Log)

 

Bitte auch das Kommando Debug(LOG) beachten, sofern Abläufe protokolliert werden sollen.

Code-Beispiel:
"Just debug info" "cx.app.debug" DEBUG SystemObject Call(Log)
x ifnot {
  "Oh oh, something bad happened" "cx.app" ERROR SystemObject Call(Log)
}

// Old semantics
"Just a regular info log" SystemObject Call(Log)

 

Stack 224620
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    
Funktionsaufruf: Call(Log)