:Revision=15
:html
<<
128.117
Debug-Objekt|Debug
--
Das IP-Objekt Debug erlaubt die Ausgabe von im Interpreterschritt auftretenden Werten in spezielle Meldungsfenster oder ein Debug-Logfile.
>>

<<
128.117.2
Prozeduren des Debug-Objekts|Prozeduren
--
>>

<<
128.117.2.1
Debug.Info|Info
--
<!DEF>
procedure <!TW>DEBUG.INFO (.Wert : string|real|vector|stringvector [; .Wert : string|real|vector|stringvector [...]]);
<!TXT>
Ausgabe der Werte hintereinander in kleinen Debug-Info-Fenster (rechts, hinter den Prfschrittdaten).

Werte knnen <!RW>Real, <!RW>String, <!RW>Vector oder <!RW>StringVector sein. Zwischen den Werten wird ein Leerzeichen ausgegeben.

Die Anzeige dieses Fensters kann in den Grundeinstellungen abgeschaltet werden. Ist das Fenster abgeschaltet, so wird der Befehl ignoriert.

<!TXT>

Beispiel
<!CODE>
step
 // Dieser Befehl zeigt Informationen im Debug Info Fenster.
 Debug.INFO('Debug Info', 1);
 System.SetValue(0);
end.
<!TXT>

>>

<<
128.117.2.2
Debug.Show|Show
!128.154.9
--
<!DEF>
procedure <!TW>DEBUG.SHOW (rColor : real; .Wert : string|real|vector|stringvector [; .Wert : string|real|vector|stringvector [...]]);
<!TXT>
Ausgabe der Werte hintereinander im groen Debug-Fenster. Dieses Fenster ist nur im Einzelschrittmodus (SBS) sichtbar.

Werte knnen <!RW>Real, <!RW>String, <!RW>Vector oder <!RW>StringVector sein. Zwischen den Werten wird ein Leerzeichen ausgegeben.

<!PW>rColor legt die Farbe der Ausgabe fest.

<!TXT>

Beispiel
<!CODE>
step
 // Dieser Befehl schreibt in das groe Debug Fenster im StepByStep Modus.
 Debug.SHOW(1, 'Diese Information wird in blau in das groe Debug Fenster im StepByStep Modus geschrieben.');
 Debug.SHOW(4, 'Diese Information wird in Rot in das groe Debug Fenster im StepByStep Modus geschrieben.');
 System.SetValue(0);
end.
<!TXT>

>>
<<
128.117.2.3
Debug.Log|Log
--
<!DEF>
procedure <!TW>DEBUG.LOG (.Wert : string|real|vector|stringvector [; .Wert : string|real|vector|stringvector [...]]);
<!TXT>
Ausgabe der Werte in eine Zeile des IPDebug.Log.

Werte knnen <!RW>Real, <!RW>String, <!RW>Vector oder <!RW>StringVector sein. Zwischen den Werten wird ein Leerzeichen ausgegeben.

<!TXT>

Beispiel
<!CODE>
step
 // Dieser Befehl schreibt in die Debug Logging Datei.
 Debug.LOG('Diese Information wird in die Debug Logging Datei geschrieben.');
 System.SetValue(0);
end.
<!TXT>

>>

<<
128.117.2.4
Debug.DUTInfo|DUTInfo
!128.154.9
--
<!DEF>
procedure <!TW>DEBUG.DUTINFO (rColor : real; .Wert : string|real|vector|stringvector [; .Wert : string|real|vector|stringvector [...]]);
<!TXT>
Ausgabe der Werte hintereinander im Prfling-Feld (Achtung: sehr schmal!). Diese Funktion ist nur im Single Simultan Mode zu verwenden.

Werte knnen <!RW>Real, <!RW>String, <!RW>Vector oder <!RW>StringVector sein. Zwischen den Werten wird ein Leerzeichen ausgegeben.

<!PW>rColor legt die Farbe der Ausgabe fest.

<!TXT>

Beispiel
<!CODE>
step
 // Dieser Befehl gibt eine kurze Info im Prflingsfeld aus.
 Debug.DUTINFO(2,'Short Info');
 System.SetValue(0);
end.
<!TXT>

>>

<<
128.117.2.5
Debug.Debug|Debug
--
<!DEF>
procedure <!TW>Debug.Debug;
<!TXT>
Unterbricht den Schritt und ffnet an dieser Stelle den Interpreterdebugger.

Diese Prozedur sollte nur zu Testzwecken verwendet werden und in Interpretercode, der auf Produktionssystemen benutzt wird, nicht vorhanden sein.

<!TXT>

Beispiel
<!CODE>
step
 Debug.SHOW(1,'Dieser Befehl wird direkt ausgefhrt.');
 // Dieser Befehl hlt den Testablauf an und startet den Debugger.
 Debug.Debug;
 Debug.SHOW(1,'Dieser Befehl wird erst auf Kommando des Debuggers ausgefhrt.');
 System.SetValue(0);
end.
<!TXT>

>>

