events (Attribute)

>>--events------------------------------><

The events attribute is an array that holds the event log records that are read from the event log during a call to readRecords(). The array is empty if no call to readRecords() has been made. Each time readRecords() is called the array is first emptied.

Each index in the array holds one event record in the form of a string with a fixed format.

~events= (set events)

events= is a private method, not intended to be changed by the programmer.

~events (get events)

Returns the array holding the event log records from the last readRecords() call. The array will be empty if no call to readRecords() has been made.

Example:

This example displays the number of event log records that were read from the System log.


  eventLog = .WindowsEventLog~new
  if eventLog~readRecords("BACKWARDS", , "System") == 0 then do
    say 'The System log has' eventLog~events~items 'records'
  end

::requires 'winSystm.cls'

/* Output might be:

The System log has 1983 records

*/