File: ztimerset.api

package info (click to toggle)
czmq 4.2.1-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 9,912 kB
  • sloc: ansic: 30,811; cpp: 19,362; sh: 11,873; python: 11,814; pascal: 11,229; ruby: 8,818; java: 4,363; makefile: 299; perl: 151; javascript: 35
file content (69 lines) | stat: -rw-r--r-- 2,467 bytes parent folder | download | duplicates (4)
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
<class name = "ztimerset" state = "draft">
    <!--
    Copyright (c) the Contributors as noted in the AUTHORS file.
    This file is part of CZMQ, the high-level C binding for 0MQ:
    http://czmq.zeromq.org.

    This Source Code Form is subject to the terms of the Mozilla Public
    License, v. 2.0. If a copy of the MPL was not distributed with this
    file, You can obtain one at http://mozilla.org/MPL/2.0/.
    -->
    timer set

    <constructor>
        Create new timer set.
    </constructor>

    <destructor>
        Destroy a timer set
    </destructor>

    <callback_type name="fn">
        Callback function for timer event.
        <argument name = "timer_id" type = "integer" />
        <argument name = "arg" type = "anything" />
    </callback_type>

    <method name = "add">
        Add a timer to the set. Returns timer id if OK, -1 on failure.
        <argument name = "interval" type = "size" />
        <argument name = "handler" type = "ztimerset_fn" callback="1" />
        <argument name = "arg" type = "anything" />
        <return type = "integer" />
    </method>

    <method name = "cancel">
        Cancel a timer. Returns 0 if OK, -1 on failure.
        <argument name = "timer id" type = "integer" />
        <return type = "integer" />
    </method>

    <method name = "set interval">
        Set timer interval. Returns 0 if OK, -1 on failure.
        This method is slow, canceling the timer and adding a new one yield better performance.
        <argument name = "timer id" type = "integer" />
        <argument name = "interval" type = "size" />
        <return type = "integer" />
    </method>

    <method name = "reset">
        Reset timer to start interval counting from current time. Returns 0 if OK, -1 on failure.
        This method is slow, canceling the timer and adding a new one yield better performance.
        <argument name = "timer id" type = "integer" />
        <return type = "integer" />
    </method>

    <method name = "timeout">
        Return the time until the next interval.
        Should be used as timeout parameter for the zpoller wait method.
        The timeout is in msec.
        <return type = "integer" />
    </method>

    <method name = "execute">
        Invoke callback function of all timers which their interval has elapsed.
        Should be call after zpoller wait method.
        Returns 0 if OK, -1 on failure.
        <return type = "integer" />
    </method>
</class>