PoDoFo 1.0.0-dev
Loading...
Searching...
No Matches
PdfError.h
Go to the documentation of this file.
1
7#ifndef PDF_ERROR_H
8#define PDF_ERROR_H
9
11
16namespace PoDoFo {
17
79
80class PODOFO_API PdfErrorInfo final
81{
82public:
83 PdfErrorInfo(std::string filepath, unsigned line, std::string info);
84 PdfErrorInfo(const PdfErrorInfo& rhs) = default;
85 PdfErrorInfo& operator=(const PdfErrorInfo& rhs) = default;
86
87public:
91 std::string_view GetFilePath() const;
92 const std::string& GetFullFilePath() const { return m_FilePath; }
93 inline unsigned GetLine() const { return m_Line; }
94 inline const std::string& GetInformation() const { return m_Info; }
95
96private:
97 unsigned m_Line;
98 std::string m_FilePath;
99 std::string m_Info;
100};
101
102using PdErrorInfoStack = std::deque<PdfErrorInfo>;
103
104// This is required to generate the documentation with Doxygen.
105// Without this define doxygen thinks we have a class called PODOFO_EXCEPTION_API(PODOFO_API) ...
106#define PODOFO_EXCEPTION_API_DOXYGEN PODOFO_EXCEPTION_API(PODOFO_API)
107
118class PODOFO_EXCEPTION_API_DOXYGEN PdfError final : public std::exception
119{
120 PODOFO_PRIVATE_FRIEND(void AddToCallStack(PdfError& err, std::string filepath, unsigned line, std::string information));
121
122public:
131 PdfError(PdfErrorCode code, std::string filepath, unsigned line,
132 std::string information = { });
133
137 PdfError(const PdfError& rhs) = default;
138
143 PdfError& operator=(const PdfError& rhs) = default;
144
150 bool operator==(PdfErrorCode code);
151
157 bool operator!=(PdfErrorCode code);
158
159 std::string_view GetName() const;
160
164 inline PdfErrorCode GetCode() const { return m_Code; }
165
169 inline const PdErrorInfoStack& GetCallStack() const { return m_CallStack; }
170
174 void PrintErrorMsg() const;
175
179 const char* what() const noexcept override;
180
181public:
186 static std::string_view ErrorName(PdfErrorCode code);
187
193 static std::string_view ErrorMessage(PdfErrorCode code);
194
195private:
209 void AddToCallStack(std::string&& filepath, unsigned line, std::string&& information);
210
211 void initFullDescription();
212
213private:
214 PdfErrorCode m_Code;
215 PdErrorInfoStack m_CallStack;
216 std::string m_FullDescription;
217};
218
219};
220
221#endif // PDF_ERROR_H
SPDX-FileCopyrightText: (C) 2005 Dominik Seichter domseichter@web.de SPDX-FileCopyrightText: (C) 2020...
The error handling class of the PoDoFo library.
Definition PdfError.h:119
const PdErrorInfoStack & GetCallStack() const
Get access to the internal callstack of this error.
Definition PdfError.h:169
PdfErrorCode GetCode() const
Return the error code of this object.
Definition PdfError.h:164
PdfError & operator=(const PdfError &rhs)=default
Assignment operator.
PdfError(const PdfError &rhs)=default
Copy constructor.
Convenient type for char array storage and/or buffer with std::string compatibility.
Definition basetypes.h:38
SPDX-FileCopyrightText: (C) 2022 Francesco Pretto ceztko@gmail.com SPDX-License-Identifier: LGPL-2....
Definition basetypes.h:16
PdfErrorCode
Error Code enum values which are used in PdfError to describe the error.
Definition PdfError.h:26
@ InvalidKey
The specified key is invalid.
@ InvalidXRef
The XRef table is invalid.
@ BrokenFile
The file content is broken.
@ InvalidXRefStream
A XRef stream is invalid.
@ InvalidEnumValue
An invalid enum value was specified.
@ ChangeOnImmutable
Changing values on immutable objects is not allowed.
@ XmpMetadataError
Error while creating or reading XMP metadata.
@ MaxRecursionReached
Reached maximum recursion depth.
@ FileNotFound
A file was not found or cannot be opened.
@ InvalidHandle
Unexpected null pointer or invalid state.
@ InvalidDataType
The passed datatype is invalid or was not recognized.
@ InvalidContentStream
The content stream is invalid due to mismatched context pairing or other problems.
@ IOError
Tried to do something unsupported to an I/O device like seek a non-seekable input device.
@ InvalidStrokeStyle
Invalid stroke style during drawing.
@ FlateError
Error in zlib.
@ UnsupportedFontFormat
This font format is not supported by PoDoFo.
@ InvalidTrailer
The PDF file has no or an invalid trailer.
@ InvalidObject
Invalid object or none none was found.
@ UnsupportedFilter
The requested filter is not yet implemented.
@ UnsupportedImageFormat
This image format is not supported by PoDoFo.
@ FreeTypeError
Error in FreeType.
@ InternalLogic
An internal sanity check or assertion failed.
@ ItemAlreadyPresent
An item to be inserted is already in this container.
@ InvalidNumber
A number was expected in the PDF file, but the read string is no number.
@ InvalidPassword
The password used to open the PDF file was invalid.
@ InvalidPredictor
Invalid or unimplemented predictor.
@ NotImplemented
This feature is currently not implemented.
@ OpenSSLError
OpenSSL error.
@ UnsupportedPixelFormat
This pixel format is not supported by PoDoFo.
@ InvalidName
The specified Name is not valid in this context.
@ InvalidFontData
The font file is invalid.
@ OutOfMemory
Not enough memory to complete an operation.
@ ObjectNotFound
An object was requested but was not found.
@ WrongDestinationType
The requested field is not available for the given destination type.
@ InvalidEncoding
Invalid encoding information.
@ InvalidPDF
The file is no PDF file.
@ InvalidStream
The stream is invalid.
@ InvalidInput
Invalid input.
@ CannotConvertColor
This color format cannot be converted.
@ InvalidEncryptionDict
The encryption dictionary is invalid or misses a required key.
@ InvalidEOFToken
The PDF file has no or an invalid EOF marker.
@ ValueOutOfRange
The specified memory is out of the allowed range.
@ UnexpectedEOF
End of file was reached but data was expected.