Sets the URL’s resource properties for a given set of keys to a given set of values.
SDKs
- iOS 4.0+
- macOS 10.6+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Foundation
Declaration
- (BOOL)setResourceValues:(NSDictionary<NSURLResource Key, id> *)keyedValues error:(NSError * _Nullable *)error;
Parameters
keyedValues
A dictionary of resource values to be set.
error
The error that occurred if one or more resource values could not be set.
Return Value
YES
if all resource values in keyed
are successfully set; otherwise, NO
.
Discussion
This method synchronously writes the new resource value out to disk. If an error occurs after some resource properties have been successfully changed, the user
dictionary in the returned error object contains a k
key whose value is an array of the resource values that were not successfully set.
Attempts to set a read-only resource property or to set a resource property that is not supported by the resource are ignored and are not considered errors.
The order in which the resource values are set is not defined. If you need to guarantee the order in which resource values are set, you should make multiple requests to this method or set
.
Note
This method applies only to URLs for file system resources.
Handling Errors in Swift:
In Swift, this method returns Void
and is marked with the throws
keyword to indicate that it throws an error in cases of failure.
You call this method in a try
expression and handle any errors in the catch
clauses of a do
statement, as described in Error Handling in The Swift Programming Language and About Imported Cocoa Error Parameters.