out

Log class that forwards messages to a trace local connection. It provides for time stamps, type information and recursive listing of display objects. To use it you need a separate program that can read the shared memory messages used by the local connection class. If you do not have such a program for your OS then consider using global trace and fdb instead.

Summary

out	Log class that forwards messages to a trace local connection.
Logging internals
INFO	Informational logging level
DEBUG	Debug logging level
WARNING	Warning logging level
ERROR	Error logging level
FATAL	Fatal error logging level
lc	The destination of trace output
_trace	Forward messages to a trace local connection which is established if required.
onStatus	Catches the onStatus event so it does not cause an exception
Logging methods
trace	Trace arguments with the default style
info	Trace arguments with the informational style
debug	Trace arguments with the debug style
warning	Trace arguments with the warning style
error	Trace arguments with the error style
fatal	Trace arguments with the fatal error style
traceType	Trace object type information tagged with the name
traceTime	Trace arguments with a timestamp
traceDisplayList	Logs the display list of a DisplayObjectContainer with the INFO level.
Logging helpers
traverseDisplayList	Recursively traverses the display list gathering display object information
timeStamp	Formats a timestamp to a sortable, fixed-width time format
zeroPad	Convert a number to a string and pad with zeros until length is reached

Logging internals

INFO

public static const INFO: String

Informational logging level

DEBUG

public static const DEBUG: String

Debug logging level

WARNING

public static const WARNING: String

Warning logging level

ERROR

public static const ERROR: String

Error logging level

FATAL

public static const FATAL: String

Fatal error logging level

lc

private static var lc: LocalConnection

The destination of trace output

_trace

private static function _trace( msg: String,
level: String ):void

Forward messages to a trace local connection which is established if required.

onStatus

private static function onStatus( event: StatusEvent ):void

Catches the onStatus event so it does not cause an exception

Logging methods

trace

public static function trace( ... args ):void

Trace arguments with the default style

info

public static function info( ... args ):void

Trace arguments with the informational style

debug

public static function debug( ... args ):void

Trace arguments with the debug style

warning

public static function warning( ... args ):void

Trace arguments with the warning style

error

public static function error( ... args ):void

Trace arguments with the error style

fatal

public static function fatal( ... args ):void

Trace arguments with the fatal error style

traceType

public static function traceType( name: String,
obj: Object ):void

Trace object type information tagged with the name

traceTime

public static function traceTime( ... args ):void

Trace arguments with a timestamp

traceDisplayList

public static function traceDisplayList( displayObject: DisplayObject ):void

Logs the display list of a DisplayObjectContainer with the INFO level.

Parameters

displayObject

The DisplayObject or DisplayObjectContainer to inspect.

Logging helpers

traverseDisplayList

private static function traverseDisplayList( displayObject: Object,
indent: String = "" ):String

Recursively traverses the display list gathering display object information

timeStamp

private static function timeStamp():String

Formats a timestamp to a sortable, fixed-width time format

zeroPad

private static function zeroPad( num: Number,
len: int ):String

Convert a number to a string and pad with zeros until length is reached

Parameters

num	number to be converted to a string
len	minimum length of converted string

Returns

String prepended with zeros if smaller than length