====== Logging ======

ADOdb provides an internal debugging system that exposes the executed SQL commands, as well as other messages that can help when troubleshooting errors when, for example, trying to establish a connection to the database or an SQL statement fails. 

The earliest that debugging can be started is after instantiating the driver but before connection. 

===== Usage =====

Please refer to [[v5:userguide:debug]] for details on usage.


===== Overriding The Default Logging Function ===== 
The default logging behavior is to send all messages to STDOUT, but the behavior may be modified by either:
  - Defining a constant **ADODB_OUTP** which holds the name of the function that overrides the standard value
  - A variable **$ADODB_OUTP** which is globalized and achieves the same as above. This function can be dynamically changed.

=== Function Definition ====

The overriding function must accept 2 arguments:
  - A String which contains the message
  - A boolean which indicates whether to throw a newline. This may be discarded based on how the function works

==== Example Function ====
<code php>
DEFINE ('ADODB_OUTP','myLogger');

function myLogger($msg,$discard)
{
    print "\nThis is my messsage: $msg";
} 
</code>