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
|
#import "OFObject.h"
@class OFString;
@class OFDataArray;
/**
* \brief A base class for different types of streams.
*/
@interface OFStream: OFObject
{
char *cache, *wcache;
size_t cache_len, wcache_len;
BOOL use_wcache;
}
/**
* Returns a boolean whether the end of the stream has been reached.
*
* IMPORTANT: Do *NOT* override this in subclasses! Override
* atEndOfStreamWithoutCache instead, as otherwise, you *WILL* break caching and
* thus get broken results!
*
/**
* Returns a boolean whether the end of the stream has been reached without
* looking at the cache.
*
* IMPORTANT: Do *NOT* use this! Use atEndOfCache instead, as this is *ONLY*
* for being overriden in subclasses!
*
* \return A boolean whether the end of the stream has been reached
*/
- (BOOL)atEndOfStreamWithoutCache;
* IMPORTANT: Do *NOT* override this in subclasses! Override
* readNBytesWithoutCache:intoBuffer: instead, as otherwise, you *WILL* break
* caching and thus get broken results!
*
/**
* Reads from the stream into a buffer without looking at the cache.
*
* IMPORTANT: Do *NOT* use this! Use readNBytes:intoBuffer: instead, as this is
* *ONLY* for being overriden in subclasses!
*
* \param buf The buffer into which the data is read
* \param size The size of the data that should be read at most.
* The buffer MUST be at least size big!
* \return The number of bytes read
*/
- (size_t)readNBytesWithoutCache: (size_t)size
intoBuffer: (char*)buf;
|
>
>
>
>
>
>
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
|
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
|
#import "OFObject.h"
@class OFString;
@class OFDataArray;
/**
* \brief A base class for different types of streams.
*
* IMPORTANT: If you want to subclass this, override _readNBytes:intoBuffer:,
* _writeNBytes:fromBuffer: and _atEndOfStream, but nothing else. Those are not
* defined in the headers, but do the actual work. OFStream uses those and does
* all the caching and other stuff. If you override these methods without the
* _ prefix, you *WILL* break caching and get broken results!
*/
@interface OFStream: OFObject
{
char *cache, *wcache;
size_t cache_len, wcache_len;
BOOL use_wcache;
}
/**
* Returns a boolean whether the end of the stream has been reached.
*
* \return A boolean whether the end of the stream has been reached
*/
- (BOOL)atEndOfStream;
/**
* Reads at most size bytes from the stream into a buffer.
*
* \param buf The buffer into which the data is read
* \param size The size of the data that should be read at most.
* The buffer MUST be at least size big!
* \return The number of bytes read
*/
- (size_t)readNBytes: (size_t)size
intoBuffer: (char*)buf;
/**
* Reads exactly size bytes from the stream into a buffer. Unlike
* readNBytes:intoBuffer:, this method does not return when less than the
* specified size has been read - instead, it waits until it got exactly size
* bytes.
*
* \param buf The buffer into which the data is read
|
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
|
* Writes everything in the write cache to the stream.
*/
- flushWriteCache;
/**
* Writes from a buffer into the stream.
*
* IMPORTANT: Do *NOT* override this in subclasses! Override
* writeNBytesWithoutCache:fromBuffer: instead, as otherwise, you *WILL* break
* caching and thus get broken results!
*
/**
* Directly writes from a buffer into the stream without caching the data first.
*
* IMPORTANT: Do *NOT* use this! Use writeNBytes:fromBuffer: instead, as this is
* *ONLY* for being overriden in subclasses!
*
* \param buf The buffer from which the data is written to the stream
* \param size The size of the data that should be written
* \return The number of bytes written
*/
- (size_t)writeNBytesWithoutCache: (size_t)size
fromBuffer: (const char*)buf;
|
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
<
|
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
* Writes everything in the write cache to the stream.
*/
- flushWriteCache;
/**
* Writes from a buffer into the stream.
*
* \param buf The buffer from which the data is written to the stream
* \param size The size of the data that should be written
* \return The number of bytes written
*/
- (size_t)writeNBytes: (size_t)size
fromBuffer: (const char*)buf;
/**
* Writes an uint8_t into the stream.
*
* \param int8 An uint8_t
*/
- (void)writeInt8: (uint8_t)int8;
|