Instance Method

initFileURLWithPath:

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

Declaration

- (instancetype)initFileURLWithPath:(NSString *)path;

Parameters

path

The path that the NSURL object will represent. path should be a valid system path, and must not be an empty path. If path begins with a tilde, it must first be expanded with stringByExpandingTildeInPath. If path is a relative path, it is treated as being relative to the current working directory.

Return Value

An NSURL object initialized with path.

Discussion

Invoking this method is equivalent to invoking initWithScheme:host:path: with scheme NSURLFileScheme, a nil host, and path.

This method assumes that path is a directory if it ends with a slash. If path does not end with a slash, the method examines the file system to determine if path is a file or a directory. If path exists in the file system and is a directory, the method appends a trailing slash. If path does not exist in the file system, the method assumes that it represents a file and does not append a trailing slash.

As an alternative, consider using initFileURLWithPath:isDirectory:, which allows you to explicitly specify whether the returned NSURL object represents a file or directory.

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.

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