6.1-roSystemLog
ON THIS PAGE
This object enables the application to receive events that are intended for reporting errors and trends, rather than for triggering a response to a user action.
The roSystemLog object requires specific design patterns in your BrightScript application:
- Use one roMessagePort throughout the application (instead of creating a new roMessagePort for each screen).
- Create one roSystemLog instance at startup that remains for the entire lifetime of the application.
- Pass the global roMessagePort mentioned above to
SetMessagePort()
on the roSystemLog component. - Enable the desired log types using
EnableType()
.
Object Creation: This object is created with no parameters:
CreateObject("roSystemLog")
ifStreamSend
SetSendEol(eol_sequence As String) As Void
Sets the EOL sequence when writing to the stream. The default value is CR+LF. If you need to set this value to a non-printing character, use the chr()
global function.
SendByte(byte As Integer) As Void
Writes the specified byte to the stream.
SendLine(string As String) As Void
Writes the specified characters to the stream followed by the current EOL sequence.
SendBlock(a As Dynamic) As Void
Writes the specified characters to the stream. This method can support either a string or an roByteArray. If the block is a string, any null bytes will terminate the block.
Flush()
ifSystemLog
ReadLog() As Object