Instance Method

initWithString:relativeToURL:

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

Declaration

- (instancetype)initWithString:(NSString *)URLString relativeToURL:(NSURL *)baseURL;

Parameters

URLString

The URL string with which to initialize the NSURL object. Must conform to RFC 2396. URLString is interpreted relative to baseURL.

baseURL

The base URL for the NSURL object.

Return Value

An NSURL object initialized with URLString and baseURL. If URLString was malformed, returns nil.

Discussion

This method allows you to create a URL relative to a base path or URL. For example, if you have the URL for a folder on disk and the name of a file within that folder, you can construct a URL for the file by providing the folder’s URL as the base path (with a trailing slash) and the filename as the string part.

This method expects URLString to contain only characters that are allowed in a properly formed URL. All other characters must be properly percent escaped. Any percent-escaped characters are interpreted using UTF-8 encoding.

initWithString:relativeToURL: is the designated initializer for NSURL.

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.

+ 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.

+ URLByResolvingAliasFileAtURL:options:error:

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

- 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.