summaryrefslogtreecommitdiff
path: root/src/libical-glib/api/i-cal-recur-iterator.xml
blob: 032c4257465285bc1798e253b62b2507a8ee951e (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
<!--
  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="RecurIterator" native="icalrecur_iterator" destroy_func="icalrecur_iterator_free">
    <method name="i_cal_recur_iterator_new" corresponds="icalrecur_iterator_new" kind="constructor" since="1.0">
        <parameter type="ICalRecurrence *" name="rule" comment="The rule applied on the #ICalRecurIterator"/>
        <parameter type="ICalTime *" name="dtstart" comment="The start time of the recurrence"/>
        <returns type="ICalRecurIterator *" annotation="transfer full" comment="The newly created #ICalRecurIterator"/>
        <comment xml:space="preserve">Creates an #ICalRecurIterator.</comment>
    </method>
    <method name="i_cal_recur_iterator_next" corresponds="icalrecur_iterator_next" since="1.0">
        <parameter type="ICalRecurIterator *" name="iterator" comment="The iterator"/>
        <returns type="ICalTime *" annotation="transfer full" comment="The next occurrence according to this recurrence rule."/>
        <comment xml:space="preserve">Gets the next occurrence from an iterator.</comment>
    </method>
    <method name="i_cal_recur_iterator_set_start" corresponds="icalrecur_iterator_set_start" since="3.0">
        <parameter type="ICalRecurIterator *" name="iterator" comment="The iterator"/>
        <parameter type="ICalTime *" name="start" comment="The date-time to move the iterator to"/>
        <returns type="gint" comment="1 if succeeded, 0 if failed, like when the recurrence type is unsupported."/>
        <comment xml:space="preserve">Sets the date-time at which the iterator will start, where 'start' is a value between DTSTART and UNTIL.
Note: CAN NOT be used with RRULEs that contain COUNT.</comment>
    </method>
    <method name="i_cal_recur_iterator_set_end" corresponds="icalrecur_iterator_set_end" since="3.1">
        <parameter type="ICalRecurIterator *" name="iterator" comment="The iterator"/>
        <parameter type="ICalTime *" name="end" comment="The date-time at which the iterator will stop"/>
        <returns type="gint" comment="1 if succeeded, 0 if failed"/>
        <comment xml:space="preserve">Sets the date-time at which the iterator will stop at the latest. Values equal to or greater than end will not be returned by the iterator.</comment>
    </method>
    <method name="i_cal_recur_iterator_free" corresponds="icalrecur_iterator_free" annotation="skip" kind="destructor" since="1.0">
        <parameter type="ICalRecurIterator *" name="iterator" comment="The iterator to be freed"/>
        <comment xml:space="preserve">Frees an iterator.</comment>
    </method>
</structure>