$darkmode
Libical API Documentation 4.0 STABLE VERSION Visit the v3.0 documentation
icalerror.h
Go to the documentation of this file.
1 /*======================================================================
2  FILE: icalerror.h
3  CREATOR: eric 09 May 1999
4 
5  SPDX-FileCopyrightText: 2000, Eric Busboom <eric@civicknowledge.com>
6  SPDX-License-Identifier: LGPL-2.1-only OR MPL-2.0
7 ======================================================================*/
8 
21 #ifndef ICALERROR_H
22 #define ICALERROR_H
23 
24 #include "libical_ical_export.h"
25 
26 #include <stdbool.h>
27 
28 #ifndef _MSC_VER
29 #pragma GCC visibility push(default)
30 #endif
31 
41 typedef enum icalerrorenum
42 {
45 
48 
51 
54 
57 
60 
63 
65  ICAL_INTERNAL_ERROR, /* Like assert --internal consist. prob */
66 
69 
72 
75 
77  ICAL_UNKNOWN_ERROR /* Used for problems in input to icalerror_strerror() */
79 #ifndef _MSC_VER
80 #pragma GCC visibility pop
81 #endif
82 
88 typedef enum icalerrorstate
89 {
92 
95 
98 
102 
115 LIBICAL_ICAL_EXPORT icalerrorenum *icalerror_icalerrno(void);
116 
133 #define icalerrno (*(icalerror_icalerrno()))
134 
149 LIBICAL_ICAL_EXPORT void icalerror_set_errno(icalerrorenum x);
150 
171 LIBICAL_ICAL_EXPORT const char *icalerror_strerror(icalerrorenum e);
172 
193 LIBICAL_ICAL_EXPORT const char *icalerror_perror(void);
194 
208 LIBICAL_ICAL_EXPORT void icalerror_set_error_state(icalerrorenum error, icalerrorstate state);
209 
215 LIBICAL_ICAL_EXPORT icalerrorstate icalerror_get_error_state(icalerrorenum error);
216 
232 LIBICAL_ICAL_EXPORT icalerrorenum icalerror_error_from_string(const char *str);
233 
246 LIBICAL_ICAL_EXPORT void icalerror_set_errors_are_fatal(bool fatal);
247 
261 LIBICAL_ICAL_EXPORT bool icalerror_get_errors_are_fatal(void);
262 
274 LIBICAL_ICAL_EXPORT void icalerror_clear_errno(void);
275 /* String interfaces to set an error to NONFATAL and restore it to its original value */
276 
292 LIBICAL_ICAL_EXPORT icalerrorstate icalerror_supress(const char *error);
293 
312 LIBICAL_ICAL_EXPORT void icalerror_restore(const char *error, icalerrorstate es);
313 
325 LIBICAL_ICAL_EXPORT void icalerror_backtrace(void);
326 
327 #endif /* !ICALERROR_H */
const char * icalerror_strerror(icalerrorenum e)
Finds the description string for error.
void icalerror_backtrace(void)
Prints backtrace.
Definition: icalerror.c:101
void icalerror_set_errno(icalerrorenum x)
Sets the icalerrno to a given error.
Definition: icalerror.c:90
icalerrorstate
Determine if an error is fatal or non-fatal.
Definition: icalerror.h:88
void icalerror_set_errors_are_fatal(bool fatal)
Change if errors are fatal.
Definition: icalerror.c:31
icalerrorenum
Represents the different types of errors that can be triggered in libical.
Definition: icalerror.h:41
icalerrorstate icalerror_get_error_state(icalerrorenum error)
Gets the error state (severity) for a given error.
bool icalerror_get_errors_are_fatal(void)
Determine if errors are fatal.
Definition: icalerror.c:36
icalerrorenum * icalerror_icalerrno(void)
Returns the current icalerrno value.
Definition: icalerror.c:58
icalerrorenum icalerror_error_from_string(const char *str)
Reads an error from a string.
icalerrorstate icalerror_supress(const char *error)
Suppresses a given error.
void icalerror_set_error_state(icalerrorenum error, icalerrorstate state)
Sets the icalerrorstate for a given icalerrorenum error.
void icalerror_clear_errno(void)
Resets icalerrno to ICAL_NO_ERROR.
Definition: icalerror.c:85
const char * icalerror_perror(void)
void icalerror_restore(const char *error, icalerrorstate es)