Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
TError.cxx File Reference
#include "TError.h"
#include <cstdarg>
#include <cstdio>
#include <cstdlib>
#include <cerrno>
#include <string>
Include dependency graph for TError.cxx:

Namespaces

namespace  ROOT
 This file contains a specialised ROOT message handler to test for diagnostic in unit tests.
 
namespace  ROOT::Internal
 

Functions

void AbstractMethod (const char *method)
 This function can be used in abstract base classes in case one does not want to make the class a "real" (in C++ sense) ABC.
 
void Break (const char *location, const char *fmt,...)
 Use this function in case an error occurred.
 
void Error (const char *location, const char *fmt,...)
 Use this function in case an error occurred.
 
void ErrorHandler (Int_t level, const char *location, const char *fmt, std::va_list ap)
 General error handler function. It calls the user set error handler.
 
void Fatal (const char *location, const char *fmt,...)
 Use this function in case of a fatal error. It will abort the program.
 
ErrorHandlerFunc_t GetErrorHandler ()
 Returns the current error handler function.
 
ErrorSystemMsgHandlerFunc_t ROOT::Internal::GetErrorSystemMsgHandler ()
 
static ROOT::Internal::ErrorSystemMsgHandlerFunc_tGetErrorSystemMsgHandlerRef ()
 
void Info (const char *location, const char *fmt,...)
 Use this function for informational messages.
 
void MayNotUse (const char *method)
 This function can be used in classes that should override a certain function, but in the inherited class the function makes no sense.
 
void ROOT::Internal::MinimalErrorHandler (Int_t level, Bool_t abort_bool, const char *location, const char *msg)
 A very simple error handler that is usually replaced by the TROOT default error handler.
 
void Obsolete (const char *function, const char *asOfVers, const char *removedFromVers)
 Use this function to declare a function obsolete.
 
ErrorHandlerFunc_t SetErrorHandler (ErrorHandlerFunc_t newhandler)
 Set an errorhandler function. Returns the old handler.
 
ErrorSystemMsgHandlerFunc_t ROOT::Internal::SetErrorSystemMsgHandler (ErrorSystemMsgHandlerFunc_t h)
 Returns the previous system error message handler.
 
void SysError (const char *location, const char *fmt,...)
 Use this function in case a system (OS or GUI) related error occurred.
 
void Warning (const char *location, const char *fmt,...)
 Use this function in warning situations.
 

Variables

Int_t gErrorAbortLevel = kSysError+1
 
static ErrorHandlerFunc_t gErrorHandler = ROOT::Internal::MinimalErrorHandler
 
Int_t gErrorIgnoreLevel = kUnset
 
TVirtualMutexgErrorMutex = nullptr
 Error handling routines.
 
Bool_t gPrintViaErrorHandler = kFALSE
 
const char * kAssertMsg = "%s violated at line %d of `%s'"
 
const Int_t kBreak = 4000
 
const char * kCheckMsg = "%s not true at line %d of `%s'"
 
const Int_t kError = 3000
 
const Int_t kFatal = 6000
 
const Int_t kInfo = 1000
 
const Int_t kPrint = 0
 
const Int_t kSysError = 5000
 
const Int_t kUnset = -1
 
const Int_t kWarning = 2000
 

Function Documentation

◆ AbstractMethod()

void AbstractMethod ( const char *  method)

This function can be used in abstract base classes in case one does not want to make the class a "real" (in C++ sense) ABC.

If this function is called it will warn the user that the function should have been overridden.

Definition at line 171 of file TError.cxx.

◆ Break()

void Break ( const char *  location,
const char *  fmt,
  ... 
)

Use this function in case an error occurred.

Definition at line 219 of file TError.cxx.

◆ Error()

void Error ( const char *  location,
const char *  fmt,
  ... 
)

Use this function in case an error occurred.

Definition at line 197 of file TError.cxx.

◆ ErrorHandler()

void ErrorHandler ( Int_t  level,
const char *  location,
const char *  fmt,
std::va_list  ap 
)

General error handler function. It calls the user set error handler.

Definition at line 121 of file TError.cxx.

◆ Fatal()

void Fatal ( const char *  location,
const char *  fmt,
  ... 
)

Use this function in case of a fatal error. It will abort the program.

Warning
Fatal() will not abort the program if gErrorIgnoreLevel > kFatal
  • but for all reasonable settings it will abort.

Definition at line 256 of file TError.cxx.

◆ GetErrorHandler()

ErrorHandlerFunc_t GetErrorHandler ( )

Returns the current error handler function.

Definition at line 112 of file TError.cxx.

◆ GetErrorSystemMsgHandlerRef()

static ROOT::Internal::ErrorSystemMsgHandlerFunc_t & GetErrorSystemMsgHandlerRef ( )
static

Definition at line 53 of file TError.cxx.

◆ Info()

void Info ( const char *  location,
const char *  fmt,
  ... 
)

Use this function for informational messages.

Definition at line 230 of file TError.cxx.

◆ MayNotUse()

void MayNotUse ( const char *  method)

This function can be used in classes that should override a certain function, but in the inherited class the function makes no sense.

Definition at line 180 of file TError.cxx.

◆ Obsolete()

void Obsolete ( const char *  function,
const char *  asOfVers,
const char *  removedFromVers 
)

Use this function to declare a function obsolete.

Specify as of which version the method is obsolete and as from which version it will be removed.

Definition at line 189 of file TError.cxx.

◆ SetErrorHandler()

ErrorHandlerFunc_t SetErrorHandler ( ErrorHandlerFunc_t  newhandler)

Set an errorhandler function. Returns the old handler.

Definition at line 102 of file TError.cxx.

◆ SysError()

void SysError ( const char *  location,
const char *  fmt,
  ... 
)

Use this function in case a system (OS or GUI) related error occurred.

Definition at line 208 of file TError.cxx.

◆ Warning()

void Warning ( const char *  location,
const char *  fmt,
  ... 
)

Use this function in warning situations.

Definition at line 241 of file TError.cxx.

Variable Documentation

◆ gErrorAbortLevel

Int_t gErrorAbortLevel = kSysError+1

Definition at line 44 of file TError.cxx.

◆ gErrorHandler

Definition at line 50 of file TError.cxx.

◆ gErrorIgnoreLevel

Int_t gErrorIgnoreLevel = kUnset

Definition at line 43 of file TError.cxx.

◆ gErrorMutex

TVirtualMutex* gErrorMutex = nullptr

Error handling routines.

This file defines a number of global error handling routines: Warning(), Error(), SysError() and Fatal(). They all take a location string (where the error happened) and a printf style format string plus vararg's. In the end these functions call an errorhandler function. Initially the MinimalErrorHandler, which is supposed to be replaced by the proper DefaultErrorHandler()

Definition at line 32 of file TError.cxx.

◆ gPrintViaErrorHandler

Bool_t gPrintViaErrorHandler = kFALSE

Definition at line 45 of file TError.cxx.

◆ kAssertMsg

const char* kAssertMsg = "%s violated at line %d of `%s'"

Definition at line 47 of file TError.cxx.

◆ kBreak

const Int_t kBreak = 4000

Definition at line 39 of file TError.cxx.

◆ kCheckMsg

const char* kCheckMsg = "%s not true at line %d of `%s'"

Definition at line 48 of file TError.cxx.

◆ kError

const Int_t kError = 3000

Definition at line 38 of file TError.cxx.

◆ kFatal

const Int_t kFatal = 6000

Definition at line 41 of file TError.cxx.

◆ kInfo

const Int_t kInfo = 1000

Definition at line 36 of file TError.cxx.

◆ kPrint

const Int_t kPrint = 0

Definition at line 35 of file TError.cxx.

◆ kSysError

const Int_t kSysError = 5000

Definition at line 40 of file TError.cxx.

◆ kUnset

const Int_t kUnset = -1

Definition at line 34 of file TError.cxx.

◆ kWarning

const Int_t kWarning = 2000

Definition at line 37 of file TError.cxx.