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
|
- (BOOL)isAtEndOfStream;
/**
* \brief Reads <i>at most</i> size bytes from the stream into a buffer.
*
* On network streams, this might read less than the specified number of bytes.
* If you want to read exactly the specified number of bytes, use
* -[readIntoBuffer:exactLength:].
*
* \param buffer The buffer into which the data is read
* \param length The length of the data that should be read at most.
* The buffer <i>must</i> be at least this big!
* \return The number of bytes read
*/
- (size_t)readIntoBuffer: (void*)buffer
length: (size_t)size;
#ifdef OF_HAVE_BLOCKS
/**
* \brief Asyncronously reads <i>at most</i> size bytes from the stream into a
* buffer.
*
* On network streams, this might read less than the specified number of bytes.
* If you want to read exactly the specified number of bytes, use
* -[readIntoBuffer:exactLength:].
*
* \param buffer The buffer into which the data is read.
* The buffer must not be free'd before the async read completed!
* \param length The length of the data that should be read at most.
* The buffer <i>must</i> be at least this big!
* \param block The block to call when the data has been received.
* If the block returns YES, it will be called again with the same
* buffer and maximum length when more data has been received. If
* you want the next block in the queue to handle the data
* received next, you need to return NO from the block.
*/
- (void)asyncReadWithBuffer: (void*)buffer
length: (size_t)length
block: (of_stream_async_read_block_t)block;
#endif
* The buffer <i>must</i> be <i>exactly</i> this big!
*/
- (void)readIntoBuffer: (void*)buffer
exactLength: (size_t)length;
/**
* \brief Reads a uint8_t from the stream.
*
* \warning Only call this when you know that enough data is available!
* Otherwise you will get an exception!
*
|
|
>
>
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
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
|
- (BOOL)isAtEndOfStream;
/**
* \brief Reads <i>at most</i> size bytes from the stream into a buffer.
*
* On network streams, this might read less than the specified number of bytes.
* If you want to read exactly the specified number of bytes, use
* -readIntoBuffer:exactLength:. Note that a read can even return 0 bytes -
* this does not necessarily mean that the stream ended, so you still need to
* check isAtEndOfStream.
*
* \param buffer The buffer into which the data is read
* \param length The length of the data that should be read at most.
* The buffer <i>must</i> be at least this big!
* \return The number of bytes read
*/
- (size_t)readIntoBuffer: (void*)buffer
length: (size_t)size;
/**
* \brief Reads exactly the specified length bytes from the stream into a
* buffer.
*
* Unlike readIntoBuffer:length:, this method does not return when less than the
* specified length has been read - instead, it waits until it got exactly the
* specified length.
*
* \warning Only call this when you know that specified amount of data is
* available! Otherwise you will get an exception!
*
* \param buffer The buffer into which the data is read
* \param length The length of the data that should be read.
* The buffer <i>must</i> be <i>exactly</i> this big!
*/
- (void)readIntoBuffer: (void*)buffer
exactLength: (size_t)length;
#ifdef OF_HAVE_BLOCKS
/**
* \brief Asyncronously reads <i>at most</i> size bytes from the stream into a
* buffer.
*
* On network streams, this might read less than the specified number of bytes.
* If you want to read exactly the specified number of bytes, use
* asyncReadIntoBuffer:exactLength:block:. Note that a read can even return 0
* bytes - this does not necessarily mean that the stream ended, so you still
* need to check isAtEndOfStream.
*
* \param buffer The buffer into which the data is read.
* The buffer must not be free'd before the async read completed!
* \param length The length of the data that should be read at most.
* The buffer <i>must</i> be at least this big!
* \param block The block to call when the data has been received.
* If the block returns YES, it will be called again with the same
* buffer and maximum length when more data has been received. If
* you want the next block in the queue to handle the data
* received next, you need to return NO from the block.
*/
- (void)asyncReadIntoBuffer: (void*)buffer
length: (size_t)length
block: (of_stream_async_read_block_t)block;
/**
* \brief Asyncronously reads exactly the specified length bytes from the
* stream into a buffer.
*
* Unlike asyncReadIntoBuffer:length:block, this method does not invoke the
* block when less than the specified length has been read - instead, it waits
* until it got exactly the specified length or the stream has ended.
*
* \param buffer The buffer into which the data is read
* \param length The length of the data that should be read.
* The buffer <i>must</i> be <i>exactly</i> this big!
* \param block The block to call when the data has been received.
* If the block returns YES, it will be called again with the same
* buffer and exact length when more data has been received. If
* you want the next block in the queue to handle the data
* received next, you need to return NO from the block.
*/
- (void)asyncReadIntoBuffer: (void*)buffer
exactLength: (size_t)length
block: (of_stream_async_read_block_t)block;
#endif
/**
* \brief Reads a uint8_t from the stream.
*
* \warning Only call this when you know that enough data is available!
* Otherwise you will get an exception!
*
|