12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
* LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
* file.
*/
#import "OFObject.h"
#import "OFSerialization.h"
#import "OFMessagePackRepresentation.h"
OF_ASSUME_NONNULL_BEGIN
@class OFString;
@class OFURL;
enum {
OF_DATA_SEARCH_BACKWARDS = 1
};
/**
* @class OFData OFData.h ObjFW/OFData.h
*
* @brief A class for storing arbitrary data in an array.
*
* For security reasons, serialization and deserialization is only implemented
|
>
>
>
>
>
>
>
|
>
|
<
>
|
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
|
* LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
* file.
*/
#import "OFObject.h"
#import "OFSerialization.h"
#import "OFMessagePackRepresentation.h"
/*! @file */
OF_ASSUME_NONNULL_BEGIN
@class OFString;
@class OFURL;
/**
* @brief Options for searching in data.
*
* This is a bit mask.
*/
typedef enum {
/** Search backwards in the data */
OFDataSearchBackwards = 1
} OFDataSearchOptions;
/**
* @class OFData OFData.h ObjFW/OFData.h
*
* @brief A class for storing arbitrary data in an array.
*
* For security reasons, serialization and deserialization is only implemented
|
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
|
/**
* @brief Compares the data to other data.
*
* @param data Data to compare the data to
* @return The result of the comparison
*/
- (of_comparison_result_t)compare: (OFData *)data;
/**
* @brief Returns a specific item of the OFData.
*
* @param index The number of the item to return
* @return The specified item of the OFData
*/
- (const void *)itemAtIndex: (size_t)index OF_RETURNS_INNER_POINTER;
/**
* @brief Returns the data in the specified range as a new OFData.
*
* @param range The range of the data for the new OFData
* @return The data in the specified range as a new OFData
*/
- (OFData *)subdataWithRange: (of_range_t)range;
/**
* @brief Returns the range of the data.
*
* @param data The data to search for
* @param options Options modifying search behavior.@n
* Possible values are:
* Value | Description
* ---------------------------|-----------------------------
* `OF_DATA_SEARCH_BACKWARDS` | Search backwards in the data
* @param range The range in which to search
* @return The range of the first occurrence of the data or a range with
* `OF_NOT_FOUND` as start position if it was not found.
*/
- (of_range_t)rangeOfData: (OFData *)data
options: (int)options
range: (of_range_t)range;
#ifdef OF_HAVE_FILES
/**
* @brief Writes the OFData into the specified file.
*
* @param path The path of the file to write to
*/
|
|
|
|
<
<
<
<
|
|
|
|
|
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
|
/**
* @brief Compares the data to other data.
*
* @param data Data to compare the data to
* @return The result of the comparison
*/
- (OFComparisonResult)compare: (OFData *)data;
/**
* @brief Returns a specific item of the OFData.
*
* @param index The number of the item to return
* @return The specified item of the OFData
*/
- (const void *)itemAtIndex: (size_t)index OF_RETURNS_INNER_POINTER;
/**
* @brief Returns the data in the specified range as a new OFData.
*
* @param range The range of the data for the new OFData
* @return The data in the specified range as a new OFData
*/
- (OFData *)subdataWithRange: (OFRange)range;
/**
* @brief Returns the range of the data.
*
* @param data The data to search for
* @param options Options modifying search behavior
* @param range The range in which to search
* @return The range of the first occurrence of the data or a range with
* `OFNotFound` as start position if it was not found.
*/
- (OFRange)rangeOfData: (OFData *)data
options: (OFDataSearchOptions)options
range: (OFRange)range;
#ifdef OF_HAVE_FILES
/**
* @brief Writes the OFData into the specified file.
*
* @param path The path of the file to write to
*/
|