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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
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
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
|
@interface OFArray: OFObject <OFCopying, OFMutableCopying, OFCollection,
OFFastEnumeration>
{
OFDataArray *array;
}
/**
* \return A new autoreleased OFArray
*/
+ array;
/**
* Creates a new OFArray with the specified object.
*
* \param object An object
* \return A new autoreleased OFArray
*/
+ arrayWithObject: (id)object;
/**
* Creates a new OFArray with the specified objects, terminated by nil.
*
* \param firstObject The first object in the array
* \return A new autoreleased OFArray
*/
+ arrayWithObjects: (id)firstObject, ...;
/**
* Creates a new OFArray with the objects from the specified C array.
*
* \param objects A C array of objects, terminated with nil
* \return A new autoreleased OFArray
*/
+ arrayWithCArray: (id*)objects;
/**
* Creates a new OFArray with the objects from the specified C array of the
* specified length.
*
* \param objects A C array of objects
* \param length The length of the C array
* \return A new autoreleased OFArray
*/
+ arrayWithCArray: (id*)objects
length: (size_t)length;
/**
* Initializes an OFArray with the specified object.
*
* \param object An object
* \return An initialized OFArray
*/
- initWithObject: (id)object;
/**
* Initializes an OFArray with the specified objects.
*
* \param firstObject The first object
* \return An initialized OFArray
*/
- initWithObjects: (id)firstObject, ...;
/**
* Initializes an OFArray with the specified object and a va_list.
*
* \param firstObject The first object
* \param arguments A va_list
* \return An initialized OFArray
*/
- initWithObject: (id)firstObject
arguments: (va_list)arguments;
/**
* Initializes an OFArray with the objects from the specified C array.
*
* \param objects A C array of objects, terminated with nil
* \return An initialized OFArray
*/
- initWithCArray: (id*)objects;
/**
* Initializes an OFArray with the objects from the specified C array of the
* specified length.
*
* \param objects A C array of objects
* \param length The length of the C array
* \return An initialized OFArray
*/
- initWithCArray: (id*)objects
length: (size_t)length;
/**
* \return The objects of the array as a C array
*/
- (id*)cArray;
/**
* Returns a specific object of the array.
*
* The returned object is <i>not</i> retained and autoreleased for performance
* reasons!
*
* \param index The number of the object to return
* \return The specified object of the OFArray
*/
- (id)objectAtIndex: (size_t)index;
/**
* Returns the index of the first object that is equivalent to the specified
* object or OF_INVALID_INDEX if it was not found.
*
* \param object The object whose index is returned
* \return The index of the first object equivalent to the specified object
* or OF_INVALID_INDEX if it was not found
*/
- (size_t)indexOfObject: (id)object;
/**
* Returns the index of the first object that has the same address as the
* specified object or OF_INVALID_INDEX if it was not found.
*
* \param object The object whose index is returned
* \return The index of the first object that has the same aaddress as
* the specified object or OF_INVALID_INDEX if it was not found
*/
- (size_t)indexOfObjectIdenticalTo: (id)object;
/**
* Returns the first object of the array or nil.
*
* The returned object is <i>not</i> retained and autoreleased for performance
* reasons!
*
* \return The first object of the array or nil
*/
- (id)firstObject;
/**
* Returns the last object of the array or nil.
*
* The returned object is <i>not</i> retained and autoreleased for performance
* reasons!
*
* \return The last object of the array or nil
*/
- (id)lastObject;
/**
* Returns the objects from the specified index to the specified index as a new
* OFArray.
*
* \param start The index where the subarray starts
* \param end The index where the subarray ends.
* This points BEHIND the last object!
* \return The subarray as a new autoreleased OFArray
*/
- (OFArray*)objectsFromIndex: (size_t)start
toIndex: (size_t)end;
/**
* Returns the objects in the specified range as a new OFArray.
* \param range The range for the subarray
* \return The subarray as a new autoreleased OFArray
*/
- (OFArray*)objectsInRange: (of_range_t)range;
/**
* Creates a string by joining all objects of the array.
*
* \param separator The string with which the objects should be joined
* \return A string containing all objects joined by the separator
*/
- (OFString*)componentsJoinedByString: (OFString*)separator;
/**
* Performs the specified selector on all objects in the array.
*
* \param selector The selector to perform on all objects in the array
*/
- (void)makeObjectsPerformSelector: (SEL)selector;
/**
* Performs the specified selector on all objects in the array with the
* specified object.
*
* \param selector The selector to perform on all objects in the array
* \param object The object to perform the selector with on all objects in the
* array
*/
- (void)makeObjectsPerformSelector: (SEL)selector
withObject: (id)object;
#ifdef OF_HAVE_BLOCKS
/**
* Executes a block for each object.
*
* \param block The block to execute for each object
*/
- (void)enumerateObjectsUsingBlock: (of_array_enumeration_block_t)block;
/**
* Returns a new array, mapping each object using the specified block.
*
* \param block A block which maps an object for each object
* \return A new, autoreleased OFArray
*/
- (OFArray*)mappedArrayUsingBlock: (of_array_map_block_t)block;
/**
* Returns a new array, only containing the objects for which the block returns
* YES.
*
* \param block A block which determines if the object should be in the new
* array
* \return A new, autoreleased OFArray
*/
- (OFArray*)filteredArrayUsingBlock: (of_array_filter_block_t)block;
#endif
|
>
>
|
|
|
|
|
|
|
|
|
|
|
>
>
|
|
|
|
|
|
|
|
|
|
>
|
|
|
|
|
|
|
|
|
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
166
167
168
169
170
171
172
173
174
175
176
177
178
179
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
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
|
@interface OFArray: OFObject <OFCopying, OFMutableCopying, OFCollection,
OFFastEnumeration>
{
OFDataArray *array;
}
/**
* \brief Creates a new OFArray.
*
* \return A new autoreleased OFArray
*/
+ array;
/**
* \brief Creates a new OFArray with the specified object.
*
* \param object An object
* \return A new autoreleased OFArray
*/
+ arrayWithObject: (id)object;
/**
* \brief Creates a new OFArray with the specified objects, terminated by nil.
*
* \param firstObject The first object in the array
* \return A new autoreleased OFArray
*/
+ arrayWithObjects: (id)firstObject, ...;
/**
* \brief Creates a new OFArray with the objects from the specified C array.
*
* \param objects A C array of objects, terminated with nil
* \return A new autoreleased OFArray
*/
+ arrayWithCArray: (id*)objects;
/**
* \brief Creates a new OFArray with the objects from the specified C array of
* the specified length.
*
* \param objects A C array of objects
* \param length The length of the C array
* \return A new autoreleased OFArray
*/
+ arrayWithCArray: (id*)objects
length: (size_t)length;
/**
* \brief Initializes an OFArray with the specified object.
*
* \param object An object
* \return An initialized OFArray
*/
- initWithObject: (id)object;
/**
* \brief Initializes an OFArray with the specified objects.
*
* \param firstObject The first object
* \return An initialized OFArray
*/
- initWithObjects: (id)firstObject, ...;
/**
* \brief Initializes an OFArray with the specified object and a va_list.
*
* \param firstObject The first object
* \param arguments A va_list
* \return An initialized OFArray
*/
- initWithObject: (id)firstObject
arguments: (va_list)arguments;
/**
* \brief Initializes an OFArray with the objects from the specified C array.
*
* \param objects A C array of objects, terminated with nil
* \return An initialized OFArray
*/
- initWithCArray: (id*)objects;
/**
* \brief Initializes an OFArray with the objects from the specified C array of
* the specified length.
*
* \param objects A C array of objects
* \param length The length of the C array
* \return An initialized OFArray
*/
- initWithCArray: (id*)objects
length: (size_t)length;
/**
* \brief Returns the objects of the array as a C array.
*
* \return The objects of the array as a C array
*/
- (id*)cArray;
/**
* \brief Returns a specified object of the array.
*
* The returned object is <i>not</i> retained and autoreleased for performance
* reasons!
*
* \param index The number of the object to return
* \return The specified object of the OFArray
*/
- (id)objectAtIndex: (size_t)index;
/**
* \brief Returns the index of the first object that is equivalent to the
* specified object or OF_INVALID_INDEX if it was not found.
*
* \param object The object whose index is returned
* \return The index of the first object equivalent to the specified object
* or OF_INVALID_INDEX if it was not found
*/
- (size_t)indexOfObject: (id)object;
/**
* \brief Returns the index of the first object that has the same address as the
* specified object or OF_INVALID_INDEX if it was not found.
*
* \param object The object whose index is returned
* \return The index of the first object that has the same aaddress as
* the specified object or OF_INVALID_INDEX if it was not found
*/
- (size_t)indexOfObjectIdenticalTo: (id)object;
/**
* \brief Returns the first object of the array or nil.
*
* The returned object is <i>not</i> retained and autoreleased for performance
* reasons!
*
* \return The first object of the array or nil
*/
- (id)firstObject;
/**
* \brief Returns the last object of the array or nil.
*
* The returned object is <i>not</i> retained and autoreleased for performance
* reasons!
*
* \return The last object of the array or nil
*/
- (id)lastObject;
/**
* \brief Returns the objects from the specified index to the specified index as
* a new OFArray.
*
* \param start The index where the subarray starts
* \param end The index where the subarray ends.
* This points BEHIND the last object!
* \return The subarray as a new autoreleased OFArray
*/
- (OFArray*)objectsFromIndex: (size_t)start
toIndex: (size_t)end;
/**
* \brief Returns the objects in the specified range as a new OFArray.
*
* \param range The range for the subarray
* \return The subarray as a new autoreleased OFArray
*/
- (OFArray*)objectsInRange: (of_range_t)range;
/**
* \brief Creates a string by joining all objects of the array.
*
* \param separator The string with which the objects should be joined
* \return A string containing all objects joined by the separator
*/
- (OFString*)componentsJoinedByString: (OFString*)separator;
/**
* \brief Performs the specified selector on all objects in the array.
*
* \param selector The selector to perform on all objects in the array
*/
- (void)makeObjectsPerformSelector: (SEL)selector;
/**
* \brief Performs the specified selector on all objects in the array with the
* specified object.
*
* \param selector The selector to perform on all objects in the array
* \param object The object to perform the selector with on all objects in the
* array
*/
- (void)makeObjectsPerformSelector: (SEL)selector
withObject: (id)object;
#ifdef OF_HAVE_BLOCKS
/**
* \brief Executes a block for each object.
*
* \param block The block to execute for each object
*/
- (void)enumerateObjectsUsingBlock: (of_array_enumeration_block_t)block;
/**
* \brief Returns a new array, mapping each object using the specified block.
*
* \param block A block which maps an object for each object
* \return A new, autoreleased OFArray
*/
- (OFArray*)mappedArrayUsingBlock: (of_array_map_block_t)block;
/**
* \brief Returns a new array, only containing the objects for which the block
* returns YES.
*
* \param block A block which determines if the object should be in the new
* array
* \return A new, autoreleased OFArray
*/
- (OFArray*)filteredArrayUsingBlock: (of_array_filter_block_t)block;
#endif
|