| ︙ | | | ︙ | |
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
|
* created per scheme.
*
* @param class_ The class to register as the handler for the specified scheme
* @param scheme The scheme for which to register the handler
* @return Whether the class was successfully registered. If a handler for the
* same scheme is already registered, registration fails.
*/
+ (bool)registerClass: (Class)class_
forScheme: (OFString *)scheme;
/**
* @brief Returns the handler for the specified URL.
*
* @return The handler for the specified URL.
*/
+ (nullable OF_KINDOF(OFURLHandler *))handlerForURL: (OFURL *)URL;
|
|
<
|
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
|
* created per scheme.
*
* @param class_ The class to register as the handler for the specified scheme
* @param scheme The scheme for which to register the handler
* @return Whether the class was successfully registered. If a handler for the
* same scheme is already registered, registration fails.
*/
+ (bool)registerClass: (Class)class_ forScheme: (OFString *)scheme;
/**
* @brief Returns the handler for the specified URL.
*
* @return The handler for the specified URL.
*/
+ (nullable OF_KINDOF(OFURLHandler *))handlerForURL: (OFURL *)URL;
|
| ︙ | | | ︙ | |
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
|
* `w+x` | Read-write, create or fail, exclusive
* `a` | Write-only, create or append
* `a+` | Read-write, create or append
* @n
* The handler is allowed to not implement all modes and is also
* allowed to implement additional, scheme-specific modes.
*/
- (OFStream *)openItemAtURL: (OFURL *)URL
mode: (OFString *)mode;
/**
* @brief Returns the attributes for the item at the specified URL.
*
* @param URL The URL to return the attributes for
* @return A dictionary of attributes for the specified URL, with the keys of
* type @ref of_file_attribute_key_t
|
|
<
|
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
* `w+x` | Read-write, create or fail, exclusive
* `a` | Write-only, create or append
* `a+` | Read-write, create or append
* @n
* The handler is allowed to not implement all modes and is also
* allowed to implement additional, scheme-specific modes.
*/
- (OFStream *)openItemAtURL: (OFURL *)URL mode: (OFString *)mode;
/**
* @brief Returns the attributes for the item at the specified URL.
*
* @param URL The URL to return the attributes for
* @return A dictionary of attributes for the specified URL, with the keys of
* type @ref of_file_attribute_key_t
|
| ︙ | | | ︙ | |
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
|
* name of the item.
*
* This method is not available for all URLs.
*
* @param source The URL to the item for which a link should be created
* @param destination The URL to the item which should link to the source
*/
- (void)linkItemAtURL: (OFURL *)source
toURL: (OFURL *)destination;
/**
* @brief Creates a symbolic link for an item.
*
* The destination uRL must have a full path, which means it must include the
* name of the item.
*
|
|
<
|
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
* name of the item.
*
* This method is not available for all URLs.
*
* @param source The URL to the item for which a link should be created
* @param destination The URL to the item which should link to the source
*/
- (void)linkItemAtURL: (OFURL *)source toURL: (OFURL *)destination;
/**
* @brief Creates a symbolic link for an item.
*
* The destination uRL must have a full path, which means it must include the
* name of the item.
*
|
| ︙ | | | ︙ | |
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
|
*
* @param source The file, directory or symbolic link to copy
* @param destination The destination URL
* @return True if an efficient copy was performed, false if an efficient copy
* was not possible. Note that errors while performing a copy are
* reported via exceptions and not by returning false!
*/
- (bool)copyItemAtURL: (OFURL *)source
toURL: (OFURL *)destination;
/**
* @brief Tries to efficiently move an item. If a move would only be possible
* by copying the source and deleting it, it returns false.
*
* The destination URL must have a full path, which means it must include the
* name of the item.
*
* If the destination is on a different logical device or uses a different
* scheme, an efficient move is not possible and false is returned.
*
* @param source The item to rename
* @param destination The new name for the item
* @return True if an efficient move was performed, false if an efficient move
* was not possible. Note that errors while performing a move are
* reported via exceptions and not by returning false!
*/
- (bool)moveItemAtURL: (OFURL *)source
toURL: (OFURL *)destination;
@end
OF_ASSUME_NONNULL_END
|
|
<
|
<
|
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
|
*
* @param source The file, directory or symbolic link to copy
* @param destination The destination URL
* @return True if an efficient copy was performed, false if an efficient copy
* was not possible. Note that errors while performing a copy are
* reported via exceptions and not by returning false!
*/
- (bool)copyItemAtURL: (OFURL *)source toURL: (OFURL *)destination;
/**
* @brief Tries to efficiently move an item. If a move would only be possible
* by copying the source and deleting it, it returns false.
*
* The destination URL must have a full path, which means it must include the
* name of the item.
*
* If the destination is on a different logical device or uses a different
* scheme, an efficient move is not possible and false is returned.
*
* @param source The item to rename
* @param destination The new name for the item
* @return True if an efficient move was performed, false if an efficient move
* was not possible. Note that errors while performing a move are
* reported via exceptions and not by returning false!
*/
- (bool)moveItemAtURL: (OFURL *)source toURL: (OFURL *)destination;
@end
OF_ASSUME_NONNULL_END
|