A record of execution of some particular type of action during profiling.
Check for an intrinsic dimension needed
on record
, while looking for
a value of the derived dimension dim
.
Check for an intrinsic dimension needed
on record
, while looking for
a value of the derived dimension dim
. If needed
is found, get its value
and pass it to f
, using the f
's return value as the value of the dim
dimension. Otherwise, use error
to report the missing dimension. If
eventtype
is empty, accept any event.
Given a record, an event type and a dimension name, return the value of the record at that dimension.
Given a record, an event type and a dimension name, return the value of the record at that dimension. By default, the name is just looked up in the record's intrinsic dimensions. If the dimension is not known, an error message string is returned as the value. Override this method to add derived dimensions or to change the interpretation of intrinsic ones.
Called when the report writing is about to finish.
Called when the report writing is about to finish. By default this method does nothing.
Check the event type of a record by looking for its event
intrinsic
dimension and comparing to the given event
string.
Check the event type of a record by looking for its event
intrinsic
dimension and comparing to the given event
string. Return true if
it is of the given event type, false otherwise.
Send string to the profile output.
Send string and a newline to the profile output.
Send string and a newline to the profile output. Default: print an empty line.
Whether or not to print the profile tables.
Whether or not to print the profile tables. Some special profile
dimensions produce their own output rather than using the default
table style. They can turn this flag off in the startReport
method to inhibit the default output.
Called when the report writing is about to start.
Called when the report writing is about to start. By default this method does nothing. The method is passed the dimension names that have been requested so that can react to them.
Convert an arbitrary value to a string using toString
.
Convert an arbitrary value to a string using toString
. Override this
method to customise how values are shown.
The interface and default implementation for a profiler's access to profiled values. Clients can provide implementations of these operations to override or customise the treatment of values for specific purposes. E.g., derived dimensions can be added by overriding
dimValue
and defaulting to the version here.