Type Method

fileURL(withPath:)

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

Declaration

class func fileURL(withPath path: String) -> URL

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

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 fileURL(withPath:isDirectory:), which allows you to explicitly specify whether the returned NSURL object represents a file or directory.

See Also

Creating an NSURL Object

init?(scheme: String, host: String?, path: String)

Initializes a newly created NSURL with a specified scheme, host, and path.

Deprecated
init?(string: String)

Initializes an NSURL object with a provided URL string.

init?(string: String, relativeTo: URL?)

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

class func fileURL(withPath: String, isDirectory: Bool)

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

init(fileURLWithPath: String, isDirectory: Bool)

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

init(fileURLWithPath: String)

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

class func fileURL(withPathComponents: [String])

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

init(resolvingAliasFileAt: URL, options: NSURL.BookmarkResolutionOptions = [])

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

class func fileURL(withFileSystemRepresentation: UnsafePointer<Int8>, isDirectory: Bool, relativeTo: URL?)

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

func getFileSystemRepresentation(UnsafeMutablePointer<Int8>, maxLength: Int)

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

init(fileURLWithFileSystemRepresentation: UnsafePointer<Int8>, isDirectory: Bool, relativeTo: URL?)

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