/usr/share/zproject/czmq/zchunk.api is in libczmq-dev 4.1.0-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 | <class name = "zchunk" state = "stable">
<!--
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/.
-->
work with memory chunks
<constructor>
Create a new chunk of the specified size. If you specify the data, it
is copied into the chunk. If you do not specify the data, the chunk is
allocated and left empty, and you can then add data using zchunk_append.
<argument name = "data" type = "buffer" c_type = "const void *" />
<argument name = "size" type = "size" />
</constructor>
<destructor>
Destroy a chunk
</destructor>
<method name = "resize">
Resizes chunk max_size as requested; chunk_cur size is set to zero
<argument name = "size" type = "size" />
</method>
<method name = "size">
Return chunk cur size
<return type = "size" />
</method>
<method name = "max_size">
Return chunk max size
<return type = "size" />
</method>
<method name = "data">
Return chunk data
<return type = "buffer" mutable = "1" size = ".size" />
</method>
<method name = "set">
Set chunk data from user-supplied data; truncate if too large. Data may
be null. Returns actual size of chunk
<argument name = "data" type = "buffer" c_type = "const void *" />
<argument name = "size" type = "size" />
<return type = "size" />
</method>
<method name = "fill">
Fill chunk data from user-supplied octet
<argument name = "filler" type = "byte" />
<argument name = "size" type = "size" />
<return type = "size" />
</method>
<method name = "append">
Append user-supplied data to chunk, return resulting chunk size. If the
data would exceeded the available space, it is truncated. If you want to
grow the chunk to accommodate new data, use the zchunk_extend method.
<argument name = "data" type = "buffer" c_type = "const void *" />
<argument name = "size" type = "size" />
<return type = "size" />
</method>
<method name = "extend">
Append user-supplied data to chunk, return resulting chunk size. If the
data would exceeded the available space, the chunk grows in size.
<argument name = "data" type = "buffer" c_type = "const void *" />
<argument name = "size" type = "size" />
<return type = "size" />
</method>
<method name = "consume">
Copy as much data from 'source' into the chunk as possible; returns the
new size of chunk. If all data from 'source' is used, returns exhausted
on the source chunk. Source can be consumed as many times as needed until
it is exhausted. If source was already exhausted, does not change chunk.
<argument name = "source" type = "zchunk" mutable = "1" />
<return type = "size" />
</method>
<method name = "exhausted">
Returns true if the chunk was exhausted by consume methods, or if the
chunk has a size of zero.
<return type = "boolean" />
</method>
<method name = "read" singleton = "1">
Read chunk from an open file descriptor
<argument name = "handle" type = "FILE" mutable = "1" />
<argument name = "bytes" type = "size" />
<return type = "zchunk" fresh = "1" />
</method>
<method name = "write">
Write chunk to an open file descriptor
<argument name = "handle" type = "FILE" mutable = "1" />
<return type = "integer" />
</method>
<method name = "slurp" singleton = "1">
Try to slurp an entire file into a chunk. Will read up to maxsize of
the file. If maxsize is 0, will attempt to read the entire file and
fail with an assertion if that cannot fit into memory. Returns a new
chunk containing the file data, or NULL if the file could not be read.
<argument name = "filename" type = "string" />
<argument name = "maxsize" type = "size" />
<return type = "zchunk" fresh = "1" />
</method>
<method name = "dup">
Create copy of chunk, as new chunk object. Returns a fresh zchunk_t
object, or null if there was not enough heap memory. If chunk is null,
returns null.
<return type = "zchunk" fresh = "1" />
</method>
<method name = "strhex">
Return chunk data encoded as printable hex string. Caller must free
string when finished with it.
<return type = "string" fresh = "1" />
</method>
<method name = "strdup">
Return chunk data copied into freshly allocated string
Caller must free string when finished with it.
<return type = "string" fresh = "1" />
</method>
<method name = "streq">
Return TRUE if chunk body is equal to string, excluding terminator
<argument name = "string" type = "string" />
<return type = "boolean" />
</method>
<method name = "pack">
Transform zchunk into a zframe that can be sent in a message.
<return type = "zframe" fresh = "1" />
</method>
<method name = "unpack" singleton = "1">
Transform a zframe into a zchunk.
<argument name = "frame" type = "zframe" mutable = "1" />
<return type = "zchunk" fresh = "1" />
</method>
<method name = "digest">
Calculate SHA1 digest for chunk, using zdigest class.
<return type = "string" />
</method>
<method name = "fprint">
Dump chunk to FILE stream, for debugging and tracing.
<argument name = "file" type = "FILE" mutable = "1" />
</method>
<method name = "print">
Dump message to stderr, for debugging and tracing.
See zchunk_fprint for details
</method>
<method name = "is" singleton = "1">
Probe the supplied object, and report if it looks like a zchunk_t.
<argument name = "self" type = "anything" mutable = "1" />
<return type = "boolean" />
</method>
</class>
|