Please note, this is a STATIC archive of website developer.mozilla.org from 03 Nov 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

Logging

This chapter describes the global functions you use to perform logging. NSPR provides a set of logging functions that conditionally write printf() style strings to the console or to a log file. NSPR uses this facility itself for its own development debugging purposes.

You can select events to be logged by module or level. A module is a user-defined class of log events. A level is a numeric value that indicates the seriousness of the event to be logged. You can combine module and level criteria to get highly selective logging.

NSPR also provides "assert"-style macros and functions to aid in application debugging.

Conditional Compilation and Execution

NSPR's logging facility is conditionally compiled in and enabled for applications using it. These controls are platform dependent. Logging is not compiled in for the Win16 platform. Logging is compiled into the NSPR debug builds; logging is not compiled into the NSPR optimized builds. コンパイル時に #define で、DEBUG または FORCE_PR_LOGをセットするとアプリケーション・プログラムでNSPR loggingが有効になります。.

To enable NSPR logging and/or the debugging aids in your application, compile using the NSPR debug build headers and runtime. Set one of the compile-time defines when you build your application.

Execution-time control of NSPR's logging uses two environment variables. These variables control which modules and levels are logged as well as the file name of the log file. By default, no logging is enabled at execution time.

Log Types and Variables

Two types supporting NSPR logging are exposed in the API:

Two environment variables control the behavior of logging at execution time:

Logging Functions and Macros

The functions and macros for logging are:

Use Example

The following sample code fragment demonstrates use of the logging and debugging aids.

  • Compile the program with DEBUG defined.
  • Before running the compiled program, set the environment variable NSPR_LOG_MODULES to userStuff:5
static void UserLogStuff( void )
{
    PRLogModuleInfo *myLM;
    PRIntn i;

    PR_STATIC_ASSERT(5 > 4); /* NSPR 4.6.6 or newer */

    myLM = PR_NewLogModule( "userStuff" );
    PR_ASSERT( myLM );

    PR_LOG( myLM, PR_LOG_NOTICE, ("Log a Notice %d\n", 999 ));
    for (i = 0; i < 10 ; i++ )
    {
        PR_LOG( myLM, PR_LOG_DEBUG, ("Log Debug number: %d\n", i));
        PR_Sleep( 500 );
    }
    PR_LOG( myLM, PR_LOG_NOTICE, ("That's all folks\n");

} /* end UserLogStuff() */

See also

NSPR Logging reference

ドキュメントのタグと貢献者

 このページの貢献者: none53
 最終更新者: none53,