mirror of
https://github.com/cappuccino/cappuccino.git
synced 2026-11-17 04:00:42 +00:00
Added a README
This commit is contained in:
1 parent
586e18f1a7
commit
46956dbe9e
1 file changed
+27
@@ -0,0 +1,27 @@
|
||||
CPLog Custom Message Formatters
|
||||
===============================
|
||||
|
||||
You may now use a custom message formatter function with CPLog. To use a custom formatter, do the following:
|
||||
|
||||
- Create a formatter function that receives 3 parameters:
|
||||
|
||||
function myFormatter(aString, aLevel, aTitle)
|
||||
{
|
||||
// return a string
|
||||
}
|
||||
|
||||
- Pass the formatter function when you register your loggers:
|
||||
|
||||
CPLogRegister(aProvider, aMaxLevel, aFormatter)
|
||||
CPLogRegisterRange(aProvider, aMinLevel, aMaxLevel, aFormatter)
|
||||
CPLogRegisterSingle(aProvider, aLevel, aFormatter)
|
||||
|
||||
If you don't pass a formatter or pass null, the default CPLog formatter is used. You can change the formatter
|
||||
for a registered logger by calling one of the CPLogRegister functions again with the new formatter.
|
||||
|
||||
Each provider/level pair can have its own formatter. So, for example, you can use one formatter for errors
|
||||
sent to CPLogPopup, a different formatter for other levels sent to CPLogPopup, and a totally different
|
||||
formatter for CPLogConsole.
|
||||
|
||||
For examples of usage in the browser, see main.j and AppController.j in the test app. For examples of usage
|
||||
in a command-line app, see test.j and run the file "execute_me".
|
||||
Reference in new issue
Block a user