logkit.hpp

Go to the documentation of this file.

// $Id: logkit.hpp 1072 2012-09-18 13:53:37Z perroe $
 
// Copyright (c)  2011, Norwegian Computing Center
// All rights reserved.
// Redistribution and use in source and binary forms, with or without modification,
// are permitted provided that the following conditions are met:
// •  Redistributions of source code must retain the above copyright notice, this
//    list of conditions and the following disclaimer.
// •  Redistributions in binary form must reproduce the above copyright notice, this list of
//    conditions and the following disclaimer in the documentation and/or other materials
//    provided with the distribution.
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
// OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
// SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
// OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
// HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
// OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
// EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
#ifndef NRLIB_LOGKIT_H
#define NRLIB_LOGKIT_H
 
#include<ostream>
#include<vector>
#include<string>
 
namespace NRLib {
 
class LogStream;
struct BufferMessage;
 
class LogKit {
public:
 
  enum MessageLevels {Error = 1, Warning = 2, Low = 4, Medium = 8, High = 16, DebugLow = 32, DebugHigh = 64};
 
  enum LimitLevels {L_Error = 1, L_Warning = 3, L_Low = 7, L_Medium = 15,
                    L_High = 31, L_DebugLow = 63, L_DebugHigh = 127};
 
  static void SetFileLog(const std::string & fileName, int levels,
                         bool includeNRLibLogging = true);
 
  static void SetFileLog(const std::string & fileName,
                         const std::vector<int> & levels,
                         bool ignore_general = false);
 
  static void SetFileLog(const std::string & fileName,
                         int levels,
                         int phase,
                         bool ignore_general = false);
 
 
  static void SetScreenLog(int levels, bool includeNRLibLogging = true);
 
  static void SetScreenLog(const std::vector<int> & levels, bool ignore_general = false);
 
 
  static void LogMessage(int level, const std::string & message);
 
  static void LogMessage(int level, int phase, const std::string & message);
 
  // Sending format as reference fails.
  static void LogFormatted(int level, std::string format, ...);
 
  static void LogFormatted(int level, int phase, std::string format, ...);
 
 
  static void EndLog();
 
  static void StartBuffering();
  static void EndBuffering();
 
  static void SetPrefix(const std::string & prefix, int level);
  static int GetNMessages(int level) { return n_messages_[level];}
  static void WriteHeader(const std::string & text, MessageLevels logLevel = Low);
 
 
private:
  static std::vector<LogStream *> logstreams_;
  static int screenLog_; //Remembers which log is screen.
  static std::vector<BufferMessage *> * buffer_;
  static std::vector<int> n_messages_;
  static std::vector<std::string> prefix_;
 
  static void SendToBuffer(int level, int phase, const std::string & message);
  static void DumpBuffer(LogStream * logstream);
};
 
class LogStream {
public:
  LogStream(std::ostream * logstream, int level);
  LogStream(std::ostream * logstream, const std::vector<int> & levels, bool ignore_general = false);
  ~LogStream();
 
  void LogMessage(int level, const std::string & message);
  void LogMessage(int level, int phase, const std::string & message);
 
private:
  std::ostream * logstream_;
  std::vector<int> levels_;
  int fullLevel_;
  bool deleteStream;
};
 
struct BufferMessage {
  std::string text_;
  int         phase_;
  int         level_;
};
 
}
#endif