Type Method

URLByResolvingAliasFileAtURL:options:error:

Returns a new URL made by resolving the alias file at url.

Declaration

+ (instancetype)URLByResolvingAliasFileAtURL:(NSURL *)url options:(NSURLBookmarkResolutionOptions)options error:(NSError * _Nullable *)error;

Parameters

url

The URL pointing to the alias file.

options

Options taken into account when resolving the bookmark data. The NSURLBookmarkResolutionWithSecurityScope option is not supported by this method.

error

The error that occurred while trying to resolve the provided URL.

Return Value

A new URL created by resolving the bookmark data derived from the provided alias file. If an error occurs, this method returns nil.

Discussion

Creates and initializes a new URL based on the alias file at url. Use this method to resolve bookmark data that was saved using writeBookmarkData:toURL:options:error: and resolves that data in one step.

If the url argument does not refer to an alias file as defined by the NSURLIsAliasFileKey property, this method returns the url argument.

If the url argument is unreachable, this method returns nil and the optional error argument is populated.

See Also

Creating an NSURL Object

+ URLWithString:

Creates and returns an NSURL object initialized with a provided URL string.

- initWithString:

Initializes an NSURL object with a provided URL string.

+ URLWithString:relativeToURL:

Creates and returns an NSURL object initialized with a base URL and a relative string.

- initWithString:relativeToURL:

Initializes an NSURL object with a base URL and a relative string.

+ fileURLWithPath:isDirectory:

Initializes and returns a newly created NSURL object as a file URL with a specified path.

- initFileURLWithPath:isDirectory:

Initializes a newly created NSURL referencing the local file or directory at path.

+ fileURLWithPath:

Initializes and returns a newly created NSURL object as a file URL with a specified path.

- initFileURLWithPath:

Initializes a newly created NSURL referencing the local file or directory at path.

+ fileURLWithPathComponents:

Initializes and returns a newly created NSURL object as a file URL with specified path components.

- initByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:

Initializes a newly created NSURL that points to a location specified by resolving bookmark data.

+ fileURLWithFileSystemRepresentation:isDirectory:relativeToURL:

Returns a new URL object initialized with a C string representing a local file system path.

- getFileSystemRepresentation:maxLength:

Fills the provided buffer with a C string representing a local file system path.

- initFileURLWithFileSystemRepresentation:isDirectory:relativeToURL:

Initializes a URL object with a C string representing a local file system path.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software