include/comphelper/logging.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_COMPHELPER_LOGGING_HXX
  21 #define INCLUDED_COMPHELPER_LOGGING_HXX
  22
  23 #include <comphelper/comphelperdllapi.h>
  24
  25 #include <com/sun/star/uno/XComponentContext.hpp>
  26 #include <com/sun/star/logging/XLogHandler.hpp>
  27 #include <com/sun/star/logging/LogLevel.hpp>
  28
  29 #include <boost/optional.hpp>
  30 #include <memory>
  31
  32 namespace comphelper
  33 {
  34
  35
  36     //= string conversions, employed by the templatized log* members of
  37     //= EventLogger
  38
  39
  40     namespace log { namespace convert
  41     {
  42         inline const OUString& convertLogArgToString( const OUString& _rValue )
  43         {
  44             return _rValue;
  45         }
  46
  47         inline OUString convertLogArgToString( const sal_Char* _pAsciiValue )
  48         {
  49             return OUString::createFromAscii( _pAsciiValue );
  50         }
  51
  52         inline OUString convertLogArgToString( double      _nValue ) { return OUString::number( _nValue ); }
  53         inline OUString convertLogArgToString( float       _nValue ) { return OUString::number( _nValue ); }
  54         inline OUString convertLogArgToString( sal_Int64   _nValue ) { return OUString::number( _nValue ); }
  55         inline OUString convertLogArgToString( sal_Int32   _nValue ) { return OUString::number( _nValue ); }
  56         inline OUString convertLogArgToString( sal_Int16   _nValue ) { return OUString::number( _nValue ); }
  57         inline OUString convertLogArgToString( sal_Unicode _nValue ) { return OUString( _nValue ); }
  58         inline OUString convertLogArgToString( bool    _bValue ) { return OUString::boolean( _bValue ); }
  59         void convertLogArgToString(sal_Bool) = delete;
  60
  61     } } // namespace log::convert
  62
  63
  64     //= EventLogger
  65
  66     class EventLogger_Impl;
  67     typedef ::boost::optional< OUString >    OptionalString;
  68
  69     /** encapsulates an css::logging::XLogger
  70
  71         The class silences several (unlikely) errors which could potentially happen
  72         when working with a logger. Additionally, it provides some convenience methods
  73         for logging events.
  74
  75         You can use this class as follows
  76 <pre>
  77     EventLogger aLogger( xContext, sLoggerName );
  78     ....
  79     aLogger.log( LogLevel::SEVERE, sSomeMessage );
  80     aLogger.logp( LogLevel::CONFIG, "MyClass", "MyMethod", sSomeMessage, SomeParameter1, SomeParameter2, SomeParameter3 );
  81 </pre>
  82
  83         The <code>log</code> and <code>logp</code> calls support up to 6 parameters, which can be of
  84         arbitrary type. For every parameter, there must exist a function <code>convertLogArgToString</code>
  85         which takes an argument of the respective type, and returns a string.
  86
  87         After a parameter has been converted to a string using the above mentioned
  88         <code>convertLogArgToString</code> function, a placeholder $1$ (resp. $2$ resp. $4$ ...)
  89         in the message will be replaced with this string, and the resulting message will be logged.
  90     */
  91     class COMPHELPER_DLLPUBLIC EventLogger
  92     {
  93     protected:
  94         std::shared_ptr< EventLogger_Impl > m_pImpl;
  95
  96     public:
  97         /** creates an <code>EventLogger</code> instance working with a css.logging.XLogger
  98             instance given by ASCII name.
  99
 100             @param _rxContext
 101                 the component context to create services
 102
 103             @param _rLoggerName
 104                 the ASCII name of the logger to create.
 105         */
 106         EventLogger(
 107             const css::uno::Reference< css::uno::XComponentContext >& _rxContext,
 108             const sal_Char* _pAsciiLoggerName
 109         );
 110
 111         ~EventLogger();
 112
 113     public:
 114         /// determines whether an event with the given level would be logged
 115         bool        isLoggable( const sal_Int32 _nLogLevel ) const;
 116
 117
 118         //- XLogger::log equivalents/wrappers
 119         //- string messages
 120
 121         /// logs a given message, without any arguments, or source class/method names
 122         bool        log( const sal_Int32 _nLogLevel, const OUString& rMessage ) const
 123         {
 124             if ( isLoggable( _nLogLevel ) )
 125                 return impl_log(_nLogLevel, nullptr, nullptr, rMessage);
 126             return false;
 127         }
 128
 129         /** logs a given message, replacing a placeholder in the message with an argument
 130
 131             The function takes, additionally to the log level and the message, an arbitrary
 132             argument. This argument is converted to a string using an overloaded function
 133             named <code>convertLogArgToString</code>. Then, a placeholder &quot;$1$&quot;
 134             is searched in the message string, and replaced with the argument string.
 135         */
 136         template< typename ARGTYPE1 >
 137         bool        log( const sal_Int32 _nLogLevel, const OUString& _rMessage, ARGTYPE1 _argument1 ) const
 138         {
 139             if ( isLoggable( _nLogLevel ) )
 140                 return impl_log( _nLogLevel, nullptr, nullptr, _rMessage,
 141                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ) );
 142             return false;
 143         }
 144
 145         /// logs a given message, replacing 2 placeholders in the message with respective values
 146         template< typename ARGTYPE1, typename ARGTYPE2 >
 147         bool        log( const sal_Int32 _nLogLevel, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2 ) const
 148         {
 149             if ( isLoggable( _nLogLevel ) )
 150                 return impl_log( _nLogLevel, nullptr, nullptr, _rMessage,
 151                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 152                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ) );
 153             return false;
 154         }
 155
 156         /// logs a given message, replacing 3 placeholders in the message with respective values
 157         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3 >
 158         bool        log( const sal_Int32 _nLogLevel, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3 ) const
 159         {
 160             if ( isLoggable( _nLogLevel ) )
 161                 return impl_log( _nLogLevel, nullptr, nullptr, _rMessage,
 162                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 163                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 164                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ) );
 165             return false;
 166         }
 167
 168         /// logs a given message, replacing 4 placeholders in the message with respective values
 169         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4 >
 170         bool        log( const sal_Int32 _nLogLevel, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4 ) const
 171         {
 172             if ( isLoggable( _nLogLevel ) )
 173                 return impl_log( _nLogLevel, nullptr, nullptr, _rMessage,
 174                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 175                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 176                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 177                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ) );
 178             return false;
 179         }
 180
 181         /// logs a given message, replacing 5 placeholders in the message with respective values
 182         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5 >
 183         bool        log( const sal_Int32 _nLogLevel, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5 ) const
 184         {
 185             if ( isLoggable( _nLogLevel ) )
 186                 return impl_log( _nLogLevel, nullptr, nullptr, _rMessage,
 187                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 188                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 189                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 190                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 191                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ) );
 192             return false;
 193         }
 194
 195         /// logs a given message, replacing 6 placeholders in the message with respective values
 196         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5, typename ARGTYPE6 >
 197         bool        log( const sal_Int32 _nLogLevel, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5, ARGTYPE6 _argument6 ) const
 198         {
 199             if ( isLoggable( _nLogLevel ) )
 200                 return impl_log( _nLogLevel, nullptr, nullptr, _rMessage,
 201                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 202                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 203                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 204                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 205                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ),
 206                     OptionalString( log::convert::convertLogArgToString( _argument6 ) ) );
 207             return false;
 208         }
 209
 210
 211         //- XLogger::log equivalents/wrappers
 212         //- ASCII messages
 213
 214         /** logs a given message, replacing a placeholder in the message with an argument
 215
 216             The function takes, additionally to the log level and the message, an arbitrary
 217             argument. This argument is converted to a string using an overloaded function
 218             named <code>convertLogArgToString</code>. Then, a placeholder &quot;$1$&quot;
 219             is searched in the message string, and replaced with the argument string.
 220         */
 221         template< typename ARGTYPE1 >
 222         bool        log( const sal_Int32 _nLogLevel, const sal_Char* _pMessage, ARGTYPE1 _argument1 ) const
 223         {
 224             if ( isLoggable( _nLogLevel ) )
 225                 return impl_log( _nLogLevel, nullptr, nullptr, OUString::createFromAscii( _pMessage ),
 226                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ) );
 227             return false;
 228         }
 229
 230         /// logs a given message, replacing 2 placeholders in the message with respective values
 231         template< typename ARGTYPE1, typename ARGTYPE2 >
 232         bool        log( const sal_Int32 _nLogLevel, const sal_Char* _pMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2 ) const
 233         {
 234             if ( isLoggable( _nLogLevel ) )
 235                 return impl_log( _nLogLevel, nullptr, nullptr, OUString::createFromAscii( _pMessage ),
 236                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 237                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ) );
 238             return false;
 239         }
 240
 241         /// logs a given message, replacing 3 placeholders in the message with respective values
 242         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3 >
 243         bool        log( const sal_Int32 _nLogLevel, const sal_Char* _pMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3 ) const
 244         {
 245             if ( isLoggable( _nLogLevel ) )
 246                 return impl_log( _nLogLevel, nullptr, nullptr, OUString::createFromAscii( _pMessage ),
 247                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 248                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 249                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ) );
 250             return false;
 251         }
 252
 253         /// logs a given message, replacing 4 placeholders in the message with respective values
 254         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4 >
 255         bool        log( const sal_Int32 _nLogLevel, const sal_Char* _pMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4 ) const
 256         {
 257             if ( isLoggable( _nLogLevel ) )
 258                 return impl_log( _nLogLevel, nullptr, nullptr, OUString::createFromAscii( _pMessage ),
 259                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 260                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 261                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 262                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ) );
 263             return false;
 264         }
 265
 266         /// logs a given message, replacing 5 placeholders in the message with respective values
 267         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5 >
 268         bool        log( const sal_Int32 _nLogLevel, const sal_Char* _pMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5 ) const
 269         {
 270             if ( isLoggable( _nLogLevel ) )
 271                 return impl_log( _nLogLevel, nullptr, nullptr, OUString::createFromAscii( _pMessage ),
 272                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 273                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 274                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 275                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 276                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ) );
 277             return false;
 278         }
 279
 280         /// logs a given message, replacing 6 placeholders in the message with respective values
 281         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5, typename ARGTYPE6 >
 282         bool        log( const sal_Int32 _nLogLevel, const sal_Char* _pMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5, ARGTYPE6 _argument6 ) const
 283         {
 284             if ( isLoggable( _nLogLevel ) )
 285                 return impl_log( _nLogLevel, nullptr, nullptr, OUString::createFromAscii( _pMessage ),
 286                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 287                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 288                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 289                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 290                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ),
 291                     OptionalString( log::convert::convertLogArgToString( _argument6 ) ) );
 292             return false;
 293         }
 294
 295
 296         //- XLogger::logp equivalents/wrappers
 297         //- string messages
 298
 299         /** logs a given message, replacing a placeholder in the message with an argument
 300
 301             The function takes, additionally to the logp level and the message, an arbitrary
 302             argument. This argument is converted to a string using an overloaded function
 303             named <code>convertLogArgToString</code>. Then, a placeholder &quot;$1$&quot;
 304             is searched in the message string, and replaced with the argument string.
 305         */
 306         template< typename ARGTYPE1 >
 307         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const OUString& _rMessage, ARGTYPE1 _argument1 ) const
 308         {
 309             if ( isLoggable( _nLogLevel ) )
 310                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, _rMessage,
 311                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ) );
 312             return false;
 313         }
 314
 315         /// logs a given message, replacing 2 placeholders in the message with respective values
 316         template< typename ARGTYPE1, typename ARGTYPE2 >
 317         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2 ) const
 318         {
 319             if ( isLoggable( _nLogLevel ) )
 320                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, _rMessage,
 321                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 322                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ) );
 323             return false;
 324         }
 325
 326         /// logs a given message, replacing 3 placeholders in the message with respective values
 327         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3 >
 328         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3 ) const
 329         {
 330             if ( isLoggable( _nLogLevel ) )
 331                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, _rMessage,
 332                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 333                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 334                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ) );
 335             return false;
 336         }
 337
 338         /// logs a given message, replacing 4 placeholders in the message with respective values
 339         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4 >
 340         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4 ) const
 341         {
 342             if ( isLoggable( _nLogLevel ) )
 343                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, _rMessage,
 344                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 345                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 346                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 347                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ) );
 348             return false;
 349         }
 350
 351         /// logs a given message, replacing 5 placeholders in the message with respective values
 352         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5 >
 353         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5 ) const
 354         {
 355             if ( isLoggable( _nLogLevel ) )
 356                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, _rMessage,
 357                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 358                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 359                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 360                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 361                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ) );
 362             return false;
 363         }
 364
 365         /// logs a given message, replacing 6 placeholders in the message with respective values
 366         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5, typename ARGTYPE6 >
 367         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const OUString& _rMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5, ARGTYPE6 _argument6 ) const
 368         {
 369             if ( isLoggable( _nLogLevel ) )
 370                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, _rMessage,
 371                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 372                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 373                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 374                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 375                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ),
 376                     OptionalString( log::convert::convertLogArgToString( _argument6 ) ) );
 377             return false;
 378         }
 379
 380
 381         //- XLogger::logp equivalents/wrappers
 382         //- ASCII messages
 383
 384         /** logs a given ASCII message, replacing a placeholder in the message with an argument
 385
 386             The function takes, additionally to the logp level and the message, an arbitrary
 387             argument. This argument is converted to a string using an overloaded function
 388             named <code>convertLogArgToString</code>. Then, a placeholder &quot;$1$&quot;
 389             is searched in the message string, and replaced with the argument string.
 390         */
 391         template< typename ARGTYPE1 >
 392         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const sal_Char* _pAsciiMessage, ARGTYPE1 _argument1 ) const
 393         {
 394             if ( isLoggable( _nLogLevel ) )
 395                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, OUString::createFromAscii( _pAsciiMessage ),
 396                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ) );
 397             return false;
 398         }
 399
 400         /// logs a given ASCII message, replacing 2 placeholders in the message with respective values
 401         template< typename ARGTYPE1, typename ARGTYPE2 >
 402         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const sal_Char* _pAsciiMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2 ) const
 403         {
 404             if ( isLoggable( _nLogLevel ) )
 405                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, OUString::createFromAscii( _pAsciiMessage ),
 406                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 407                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ) );
 408             return false;
 409         }
 410
 411         /// logs a given ASCII message, replacing 3 placeholders in the message with respective values
 412         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3 >
 413         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const sal_Char* _pAsciiMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3 ) const
 414         {
 415             if ( isLoggable( _nLogLevel ) )
 416                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, OUString::createFromAscii( _pAsciiMessage ),
 417                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 418                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 419                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ) );
 420             return false;
 421         }
 422
 423         /// logs a given ASCII message, replacing 4 placeholders in the message with respective values
 424         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4 >
 425         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const sal_Char* _pAsciiMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4 ) const
 426         {
 427             if ( isLoggable( _nLogLevel ) )
 428                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, OUString::createFromAscii( _pAsciiMessage ),
 429                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 430                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 431                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 432                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ) );
 433             return false;
 434         }
 435
 436         /// logs a given ASCII message, replacing 5 placeholders in the message with respective values
 437         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5 >
 438         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const sal_Char* _pAsciiMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5 ) const
 439         {
 440             if ( isLoggable( _nLogLevel ) )
 441                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, OUString::createFromAscii( _pAsciiMessage ),
 442                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 443                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 444                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 445                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 446                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ) );
 447             return false;
 448         }
 449
 450         /// logs a given ASCII message, replacing 6 placeholders in the message with respective values
 451         template< typename ARGTYPE1, typename ARGTYPE2, typename ARGTYPE3, typename ARGTYPE4, typename ARGTYPE5, typename ARGTYPE6 >
 452         bool        logp( const sal_Int32 _nLogLevel, const sal_Char* _pSourceClass, const sal_Char* _pSourceMethod, const sal_Char* _pAsciiMessage, ARGTYPE1 _argument1, ARGTYPE2 _argument2, ARGTYPE3 _argument3, ARGTYPE4 _argument4, ARGTYPE5 _argument5, ARGTYPE6 _argument6 ) const
 453         {
 454             if ( isLoggable( _nLogLevel ) )
 455                 return impl_log( _nLogLevel, _pSourceClass, _pSourceMethod, OUString::createFromAscii( _pAsciiMessage ),
 456                     OptionalString( log::convert::convertLogArgToString( _argument1 ) ),
 457                     OptionalString( log::convert::convertLogArgToString( _argument2 ) ),
 458                     OptionalString( log::convert::convertLogArgToString( _argument3 ) ),
 459                     OptionalString( log::convert::convertLogArgToString( _argument4 ) ),
 460                     OptionalString( log::convert::convertLogArgToString( _argument5 ) ),
 461                     OptionalString( log::convert::convertLogArgToString( _argument6 ) ) );
 462             return false;
 463         }
 464
 465     protected:
 466         bool        impl_log(
 467                         const sal_Int32 _nLogLevel,
 468                         const sal_Char* _pSourceClass,
 469                         const sal_Char* _pSourceMethod,
 470                         const OUString& _rMessage,
 471                         const OptionalString& _rArgument1 = OptionalString(),
 472                         const OptionalString& _rArgument2 = OptionalString(),
 473                         const OptionalString& _rArgument3 = OptionalString(),
 474                         const OptionalString& _rArgument4 = OptionalString(),
 475                         const OptionalString& _rArgument5 = OptionalString(),
 476                         const OptionalString& _rArgument6 = OptionalString()
 477                     ) const;
 478     };
 479 } // namespace comphelper
 480
 481
 482 #endif // INCLUDED_COMPHELPER_LOGGING_HXX
 483
 484 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */