13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
+
-
-
+
+
+
|
* LICENSE.GPLv2 or LICENSE.GPLv3 respectively included in the packaging of this
* file.
*/
#import "OFObject.h"
@class OFString;
#ifndef DOXYGEN
@class OFArray;
@class OFMutableArray;
@class OFArray OF_GENERIC(ObjectType);
@class OFMutableArray OF_GENERIC(ObjectType);
#endif
/*!
* @class OFINICategory OFINICategory.h ObjFW/OFINICategory.h
*
* @brief A class for representing a category of an INI file.
*/
@interface OFINICategory: OFObject
|
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
-
+
|
* A multi-key is a key which exists several times in the same category. Each
* occurrence of the key/value pair adds the respective value to the array.
*
* @param key The multi-key for which the array should be returned
* @return The array for the specified key, or an empty array if it does not
* exist
*/
- (OFArray*)arrayForKey: (OFString*)key;
- (OFArray OF_GENERIC(OFString*)*)arrayForKey: (OFString*)key;
/*!
* @brief Sets the value of the specified key to the specified string.
*
* If the specified key is a multi-key (see @ref arrayForKey:), the value of
* the first key/value pair found is changed.
*
|
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
|
-
+
|
* yet, it is appended to the section.
*
* See also @ref arrayForKey: for more information about multi-keys.
*
* @param array The array of strings to which the multi-key should be set
* @param key The multi-key for which the new values should be set
*/
- (void)setArray: (OFArray*)array
- (void)setArray: (OFArray OF_GENERIC(OFString*)*)array
forKey: (OFString*)key;
/*!
* @brief Removes the value for the specified key
*
* If the specified key is a multi-key (see @ref arrayForKey:), all key/value
* pairs matching the specified key are removed.
*
* @param key The key of the value to remove
*/
- (void)removeValueForKey: (OFString*)key;
@end
|