PoDoFo  0.9.1
Public Member Functions | Static Public Member Functions
PoDoFo::PdfError Class Reference

#include <PdfError.h>

List of all members.

Public Member Functions

 PdfError ()
 PdfError (const EPdfError &eCode, const char *pszFile=NULL, int line=0, const char *pszInformation=NULL)
 PdfError (const PdfError &rhs)
const PdfErroroperator= (const PdfError &rhs)
const PdfErroroperator= (const EPdfError &eCode)
bool operator== (const PdfError &rhs)
bool operator== (const EPdfError &eCode)
bool operator!= (const PdfError &rhs)
bool operator!= (const EPdfError &eCode)
EPdfError GetError () const
const TDequeErrorInfo & GetCallstack () const
void SetError (const EPdfError &eCode, const char *pszFile=NULL, int line=0, const char *pszInformation=NULL)
void SetErrorInformation (const char *pszInformation)
void SetErrorInformation (const wchar_t *pszInformation)
void AddToCallstack (const char *pszFile=NULL, int line=0, const char *pszInformation=NULL)
bool IsError () const
void PrintErrorMsg () const
virtual const char * what () const throw ()

Static Public Member Functions

static LogMessageCallback * SetLogMessageCallback (LogMessageCallback *fLogMessageCallback)
static PODOFO_NOTHROW const char * ErrorName (EPdfError eCode)
static const char * ErrorMessage (EPdfError eCode)
static void LogMessage (ELogSeverity eLogSeverity, const char *pszMsg,...)
static void LogMessage (ELogSeverity eLogSeverity, const wchar_t *pszMsg,...)
static void EnableLogging (bool bEnable)
static bool LoggingEnabled ()
static void DebugMessage (const char *pszMsg,...)
static void EnableDebug (bool bEnable)
static bool DebugEnabled ()

Detailed Description

The error handling class of PoDoFo lib. Whenever a function encounters an error a PdfError object is returned.

A PdfError with Error() == ErrOk means successfull execution.

This class provides also meaningfull error descriptions.


Constructor & Destructor Documentation

PoDoFo::PdfError::PdfError ( )

Create a PdfError object initialized to ErrOk

PoDoFo::PdfError::PdfError ( const EPdfError eCode,
const char *  pszFile = NULL,
int  line = 0,
const char *  pszInformation = NULL 
)

Create a PdfError object with a given error code.

Parameters:
eCodethe error code of this object
pszFilethe file in which the error has occured. Use the compiler macro FILE to initialize the field.
linethe line in which the error has occured. Use the compiler macro LINE to initialize the field.
pszInformationadditional information on this error which mayy be formatted like printf
PoDoFo::PdfError::PdfError ( const PdfError rhs)

Copy constructor

Parameters:
rhscopy the contents of rhs into this object

Member Function Documentation

void PoDoFo::PdfError::AddToCallstack ( const char *  pszFile = NULL,
int  line = 0,
const char *  pszInformation = NULL 
)
inline
Add callstack information to an error object. Always call this function

if you get an error object but do not handle the error but throw it again.

Parameters:
pszFilethe filename of the source file causing the error or NULL. Typically you will use the gcc macro FILE here.
linethe line of source causing the error or 0. Typically you will use the gcc macro LINE here.
pszInformationadditional information on the error. e.g. how to fix the error. This string is intended to be shown to the user.
static bool PoDoFo::PdfError::DebugEnabled ( )
inlinestatic

Is the display of debugging messages enabled or not?

void PoDoFo::PdfError::DebugMessage ( const char *  pszMsg,
  ... 
)
static

Log a message to the logging system defined for PoDoFo for debugging

Parameters:
pszMsgthe message to be logged
static void PoDoFo::PdfError::EnableDebug ( bool  bEnable)
inlinestatic

Enable or disable the display of debugging messages

Parameters:
bEnableenable (true) or disable (false)
static void PoDoFo::PdfError::EnableLogging ( bool  bEnable)
inlinestatic

Enable or disable Logging

Parameters:
bEnableenable (true) or disable (false)
const char * PoDoFo::PdfError::ErrorMessage ( EPdfError  eCode)
static

Get the error message for a certain error code.

Returns:
the error message or NULL if no error message for the specified error code is available.
const char * PoDoFo::PdfError::ErrorName ( EPdfError  eCode)
static

Get the name for a certain error code.

Returns:
the name or NULL if no name for the specified error code is available.

< The encryption dictionary is invalid or misses a required key

< The password used to open the PDF file was invalid

< This font format is not supported by PoDoFO.

< This image format is not supported by PoDoFO.

< This color format cannot be converted.

const TDequeErrorInfo & PoDoFo::PdfError::GetCallstack ( ) const
inline

Get access to the internal callstack of this error

Returns:
the callstack
EPdfError PoDoFo::PdfError::GetError ( ) const
inline

Return the error code of this object

Returns:
the error code of this object
bool PoDoFo::PdfError::IsError ( ) const
inline
Returns:
true if an error code was set and false if the error code is ePdfError_ErrOk
static bool PoDoFo::PdfError::LoggingEnabled ( )
inlinestatic

Is the display of debugging messages enabled or not?

void PoDoFo::PdfError::LogMessage ( ELogSeverity  eLogSeverity,
const char *  pszMsg,
  ... 
)
static

Log a message to the logging system defined for PoDoFo.

Parameters:
eLogSeveritythe sevirity of the log message
pszMsgthe message to be logged
void PoDoFo::PdfError::LogMessage ( ELogSeverity  eLogSeverity,
const wchar_t *  pszMsg,
  ... 
)
static

Log a message to the logging system defined for PoDoFo.

Parameters:
eLogSeveritythe sevirity of the log message
pszMsgthe message to be logged
bool PoDoFo::PdfError::operator!= ( const PdfError rhs)

Comparison operator compares 2 PdfError objects

Parameters:
rhsanother PdfError object
Returns:
true if both objects have the different error code.
bool PoDoFo::PdfError::operator!= ( const EPdfError eCode)

Overloaded comparison operator compares 2 PdfError objects

Parameters:
eCodean erroce code
Returns:
true if this object has different error code.
const PdfError & PoDoFo::PdfError::operator= ( const PdfError rhs)

Assignment operator

Parameters:
rhsanother PdfError object
Returns:
this object
const PdfError & PoDoFo::PdfError::operator= ( const EPdfError eCode)

Overloaded assignment operator

Parameters:
eCodea EPdfError code
Returns:
this object
bool PoDoFo::PdfError::operator== ( const PdfError rhs)

Comparison operator compares 2 PdfError objects

Parameters:
rhsanother PdfError object
Returns:
true if both objects have the same error code.
bool PoDoFo::PdfError::operator== ( const EPdfError eCode)

Overloaded comparison operator compares 2 PdfError objects

Parameters:
eCodean erroce code
Returns:
true if this object has the same error code.
void PoDoFo::PdfError::PrintErrorMsg ( ) const

Print an error message to stderr

void PoDoFo::PdfError::SetError ( const EPdfError eCode,
const char *  pszFile = NULL,
int  line = 0,
const char *  pszInformation = NULL 
)
inline

Set the error code of this object.

Parameters:
eCodethe error code of this object
pszFilethe filename of the source file causing the error or NULL. Typically you will use the gcc macro FILE here.
linethe line of source causing the error or 0. Typically you will use the gcc macro LINE here.
pszInformationadditional information on the error. e.g. how to fix the error. This string is intended to be shown to the user.
void PoDoFo::PdfError::SetErrorInformation ( const char *  pszInformation)
inline

Set additional error informatiom

Parameters:
pszInformationadditional information on the error. e.g. how to fix the error. This string is intended to be shown to the user.
void PoDoFo::PdfError::SetErrorInformation ( const wchar_t *  pszInformation)
inline

Set additional error informatiom

Parameters:
pszInformationadditional information on the error. e.g. how to fix the error. This string is intended to be shown to the user.
PdfError::LogMessageCallback * PoDoFo::PdfError::SetLogMessageCallback ( LogMessageCallback *  fLogMessageCallback)
static

Set a global static LogMessageCallback functor to repleace stderr output in LogMessageInternal

Parameters:
fLogMessageCallbackthe pointer to the new callback functor object
Returns:
the pointer to the previous callback functor object
const char * PoDoFo::PdfError::what ( ) const throw ()
virtual

Reimplemented from std::exception.

Returns:
a c string describing the error. Annotated throw() in defiance of CODINGSTYLE.txt because we can't discard qualifiers on override.