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
|
* Alternatively, it may be distributed under the terms of the GNU General
* Public License, either version 2 or 3, which can be found in the file
* LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
* file.
*/
#import "OFObject.h"
#import "OFString.h"
#import "OFZooArchiveEntry.h"
OF_ASSUME_NONNULL_BEGIN
@class OFStream;
* @param mode The mode for the Zoo file. The only valid mode is "r" for
* reading.
* @return A new, autoreleased OFZooArchive
*/
+ (instancetype)archiveWithStream: (OFStream *)stream mode: (OFString *)mode;
/**
* @brief Creates a new OFZooArchive object with the specified file.
*
* @param IRI The IRI to the Zoo file
* @param mode The mode for the Zoo file. The only valid mode is "r" for
* reading.
* @return A new, autoreleased OFZooArchive
*/
+ (instancetype)archiveWithIRI: (OFIRI *)IRI mode: (OFString *)mode;
- (instancetype)init OF_UNAVAILABLE;
/**
* @brief Initializes an already allocated OFZooArchive object with the
* specified stream.
*
* @param stream A stream from which the Zoo archive will be read.
* For read mode, this needs to be an OFSeekableStream.
* @param mode The mode for the Zoo file. The only valid mode is "r" for
* reading.
* @return An initialized OFZooArchive
*/
- (instancetype)initWithStream: (OFStream *)stream
mode: (OFString *)mode OF_DESIGNATED_INITIALIZER;
/**
* @brief Initializes an already allocated OFZooArchive object with the
* specified file.
*
* @param IRI The IRI to the Zoo file
* @param mode The mode for the Zoo file. The only valid mode is "r" for
* reading.
* @return An initialized OFZooArchive
*/
- (instancetype)initWithIRI: (OFIRI *)IRI mode: (OFString *)mode;
/**
* @brief Returns the next entry from the Zoo archive or `nil` if all entries
* have been read.
*
* @note This is only available in read mode.
*
* @warning Calling @ref nextEntry will invalidate all streams returned by
* @ref streamForReadingCurrentEntry! Reading from an invalidated
* stream will throw an @ref OFReadFailedException!
*
* @return The next entry from the Zoo archive or `nil` if all entries have
* been read
* @throw OFInvalidFormatException The archive's format is invalid
* @throw OFTruncatedDataException The archive was truncated
*/
- (nullable OFZooArchiveEntry *)nextEntry;
/**
* @brief Returns a stream for reading the current entry.
*
* @note This is only available in read mode.
*
* @note The returned stream conforms to @ref OFReadyForReadingObserving if the
* underlying stream does so, too.
*
* @return A stream for reading the current entry
* @throw OFSeekFailedException Seeking to the data in the archive failed
*/
- (OFStream *)streamForReadingCurrentEntry;
/**
* @brief Closes the OFZooArchive.
*
* @throw OFNotOpenException The archive is not open
*/
- (void)close;
@end
OF_ASSUME_NONNULL_END
|
>
<
<
>
>
>
>
>
|
|
|
|
|
|
|
|
|
>
|
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
|
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
|
* Alternatively, it may be distributed under the terms of the GNU General
* Public License, either version 2 or 3, which can be found in the file
* LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
* file.
*/
#import "OFObject.h"
#import "OFSeekableStream.h"
#import "OFString.h"
#import "OFZooArchiveEntry.h"
OF_ASSUME_NONNULL_BEGIN
/**
* @class OFZooArchive OFZooArchive.h ObjFW/OFZooArchive.h
*
* @brief A class for accessing and manipulating Zoo files.
*/
OF_SUBCLASSING_RESTRICTED
@interface OFZooArchive: OFObject
{
OF_KINDOF(OFStream *) _stream;
uint_least8_t _mode;
OFStringEncoding _encoding;
uint16_t _minVersionNeeded;
uint8_t _headerType;
OFZooArchiveEntry *_Nullable _currentEntry;
#ifdef OF_ZOO_ARCHIVE_M
@public
#endif
OFStream *_Nullable _lastReturnedStream;
@protected
OFStreamOffset _lastHeaderOffset;
size_t _lastHeaderLength;
}
/**
* @brief The encoding to use for the archive. Defaults to UTF-8.
*/
@property (nonatomic) OFStringEncoding encoding;
/**
* @brief Creates a new OFZooArchive object with the specified stream.
*
* @param stream A stream from which the Zoo archive will be read.
* For read mode, this needs to be an OFSeekableStream.
* @param mode The mode for the Zoo file. Valid modes are "r" for reading and
* "w" for creating a new file.
* @return A new, autoreleased OFZooArchive
*/
+ (instancetype)archiveWithStream: (OFStream *)stream mode: (OFString *)mode;
/**
* @brief Creates a new OFZooArchive object with the specified file.
*
* @param IRI The IRI to the Zoo file
* @param mode The mode for the Zoo file. Valid modes are "r" for reading and
* "w" for creating a new file.
* @return A new, autoreleased OFZooArchive
*/
+ (instancetype)archiveWithIRI: (OFIRI *)IRI mode: (OFString *)mode;
- (instancetype)init OF_UNAVAILABLE;
/**
* @brief Initializes an already allocated OFZooArchive object with the
* specified stream.
*
* @param stream A stream from which the Zoo archive will be read.
* For read mode, this needs to be an OFSeekableStream.
* @param mode The mode for the Zoo file. Valid modes are "r" for reading and
* "w" for creating a new file.
* @return An initialized OFZooArchive
*/
- (instancetype)initWithStream: (OFStream *)stream
mode: (OFString *)mode OF_DESIGNATED_INITIALIZER;
/**
* @brief Initializes an already allocated OFZooArchive object with the
* specified file.
*
* @param IRI The IRI to the Zoo file
* @param mode The mode for the Zoo file. Valid modes is "r" for reading and
* "w" for creating a new file.
* @return An initialized OFZooArchive
*/
- (instancetype)initWithIRI: (OFIRI *)IRI mode: (OFString *)mode;
/**
* @brief Returns the next entry from the Zoo archive or `nil` if all entries
* have been read.
*
* @note This is only available in read mode.
*
* @warning Calling @ref nextEntry will invalidate all streams returned by
* @ref streamForReadingCurrentEntry or
* @ref streamForWritingEntry:! Reading from or writing to an
* invalidated stream will throw an @ref OFReadFailedException or
* @ref OFWriteFailedException!
*
* @return The next entry from the Zoo archive or `nil` if all entries have
* been read
* @throw OFInvalidFormatException The archive's format is invalid
* @throw OFUnsupportedVersionException The archive's format is of an
* unsupported version
* @throw OFTruncatedDataException The archive was truncated
*/
- (nullable OFZooArchiveEntry *)nextEntry;
/**
* @brief Returns a stream for reading the current entry.
*
* @note This is only available in read mode.
*
* @note The returned stream conforms to @ref OFReadyForReadingObserving if the
* underlying stream does so, too.
*
* @return A stream for reading the current entry
* @throw OFSeekFailedException Seeking to the data in the archive failed
*/
- (OFStream *)streamForReadingCurrentEntry;
/**
* @brief Returns a stream for writing the specified entry.
*
* @note This is only available in write and append mode.
*
* @note The returned stream conforms to @ref OFReadyForWritingObserving if the
* underlying stream does so, too.
*
* @warning Calling @ref streamForWritingEntry: will invalidate all streams
* returned by @ref streamForReadingCurrentEntry or
* @ref streamForWritingEntry:! Reading from or writing to an
* invalidated stream will throw an @ref OFReadFailedException or
* @ref OFWriteFailedException!
*
* @param entry The entry for which a stream for writing should be returned.@n
* The following parts of the specified entry will be ignored:
* * The header type.
* * The minimum version needed.
* * The compressed size.
* * The uncompressed size.
* * The CRC16.
* @return A stream for writing the specified entry
*/
- (OFStream *)streamForWritingEntry: (OFZooArchiveEntry *)entry;
/**
* @brief Closes the OFZooArchive.
*
* @throw OFNotOpenException The archive is not open
*/
- (void)close;
@end
OF_ASSUME_NONNULL_END
|