summaryrefslogtreecommitdiff
path: root/src/libical-glib/api/i-cal-error.xml
blob: e2692f71b7370d3d6dddb727399f40a1c90f7ad1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
<!--
  Copyright (C) 2015 William Yu <williamyu@gnome.org>

  This library is free software: you can redistribute it and/or modify it
  under the terms of version 2.1. of the GNU Lesser General Public License
  as published by the Free Software Foundation.

  This library is distributed in the hope that it will be useful, but
  WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
  for more details.

  You should have received a copy of the GNU Lesser General Public License
  along with this library. If not, see <https://www.gnu.org/licenses/>.
-->
<structure namespace="ICal" name="Error">
    <enum name="ICalErrorEnum" native_name="icalerrorenum" default_native="I_CAL_UNKNOWN_ERROR">
        <element name="ICAL_NO_ERROR"/>
        <element name="ICAL_BADARG_ERROR"/>
        <element name="ICAL_NEWFAILED_ERROR"/>
        <element name="ICAL_ALLOCATION_ERROR"/>
        <element name="ICAL_MALFORMEDDATA_ERROR"/>
        <element name="ICAL_PARSE_ERROR"/>
        <element name="ICAL_INTERNAL_ERROR"/>
        <element name="ICAL_FILE_ERROR"/>
        <element name="ICAL_USAGE_ERROR"/>
        <element name="ICAL_UNIMPLEMENTED_ERROR"/>
        <element name="ICAL_UNKNOWN_ERROR"/>
    </enum>
    <enum name="ICalErrorState" native_name="icalerrorstate" default_native="I_CAL_ERROR_UNKNOWN">
        <element name="ICAL_ERROR_FATAL"/>
        <element name="ICAL_ERROR_NONFATAL"/>
        <element name="ICAL_ERROR_DEFAULT"/>
        <element name="ICAL_ERROR_UNKNOWN"/>
    </enum>
    <method name="i_cal_error_stop_here" corresponds="icalerror_stop_here" since="1.0"></method>
    <method name="i_cal_error_crash_here" corresponds="icalerror_crash_here" since="1.0">
        <comment xml:space="preserve">Shout out the errors to the compiler.</comment>
    </method>
    <method name="i_cal_errno_return" corresponds="icalerrno_return" since="1.0">
        <returns type="ICalErrorEnum" annotation="transfer full" translator="(ICalErrorEnum) *" translator_argus="NONE" comment="Return the error happened" />
        <comment xml:space="preserve">Returns the error stored in the library. If no error, return I_CAL_NO_ERROR.</comment>
    </method>
    <method name="i_cal_error_clear_errno" corresponds="icalerror_clear_errno" since="1.0"></method>
    <method name="i_cal_error_strerror" corresponds="icalerror_strerror" since="1.0">
        <parameter type="ICalErrorEnum" name="e" comment="The #ICalErrorEnum to be translated"/>
        <returns type="const gchar *" annotation="transfer none" comment="The string representation of @e" />
        <comment xml:space="preserve">Translates the #ICalErrorEnum to the string representation.</comment>
    </method>
    <method name="i_cal_error_perror" corresponds="icalerror_perror" since="1.0">
        <returns type="const gchar *" annotation="transfer none" comment="The string representation of the current error" />
        <comment xml:space="preserve">Gets the #ICalErrorEnum in the string representation. This method called the icalerrorno_return to get the current error.</comment>
    </method>
    <method name="i_cal_bt" corresponds="ical_bt" kind="other" since="1.0"></method>
    <method name="i_cal_error_set_error_state" corresponds="icalerror_set_error_state" kind="set" since="1.0">
        <parameter type="ICalErrorEnum" name="error" comment="The error enum"/>
        <parameter type="ICalErrorState" name="state" comment="The error state"/>
        <comment xml:space="preserve">Sets the state to the corresponding error in the library.</comment>
    </method>
    <method name="i_cal_error_get_error_state" corresponds="icalerror_get_error_state" kind="get" since="1.0">
        <parameter type="ICalErrorEnum" name="error" comment="The error to be checked"/>
        <returns type="ICalErrorState" comment="The state of the @error" />
        <comment xml:space="preserve">Gets the state of an error.</comment>
    </method>
    <method name="i_cal_error_set_errno" corresponds="icalerror_set_errno" kind="set" since="1.0">
        <parameter type="ICalErrorEnum" name="x" comment="The error to be set"/>
        <comment xml:space="preserve">Sets the errno.</comment>
    </method>
    <method name="i_cal_error_supress" corresponds="icalerror_supress" since="1.0">
        <parameter type="const gchar *" name="error" comment="The error to be suppressed"/>
        <returns type="ICalErrorState" comment="The error state suppressed" />
        <comment xml:space="preserve">Suppresses the error.</comment>
    </method>
    <method name="i_cal_error_restore" corresponds="icalerror_restore" since="1.0">
        <parameter type="const gchar *" name="error" comment="The error to be restored"/>
        <parameter type="ICalErrorState" name="es" comment="The error state to be restored"/>
        <comment xml:space="preserve">Restores the error to specified state.</comment>
    </method>
</structure>