Instance Method

fileReferenceURL()

Returns a new file reference URL that points to the same resource as the receiver.

Declaration

func fileReferenceURL() -> URL?

Return Value

The new file reference URL.

Discussion

File reference URLs use a URL path syntax that identifies a file system object by reference, not by path. This form of file URL remains valid when the file system path of the URL’s underlying resource changes.

If the original URL is a file path URL, this property contains a copy of the URL converted into a file reference URL. If the original URL is a file reference URL, this property contains the original. If the original URL is not a file URL, this property contains nil.

File reference URLs cannot be created to file system objects which do not exist or are not reachable. This property contains nil instead.

In some areas of the file system hierarchy, file reference URLs cannot be generated to the leaf node of the URL path.

See Also

Modifying and Converting a File URL

var filePathURL: URL?

A file path URL that points to the same resource as the URL object. (read-only)

func appendingPathComponent(String)

Returns a new URL made by appending a path component to the original URL.

func appendingPathComponent(String, isDirectory: Bool)

Returns a new URL made by appending a path component to the original URL, along with a trailing slash if the component is designated a directory.

func appendingPathExtension(String)

Returns a new URL made by appending a path extension to the original URL.

var deletingLastPathComponent: URL?

A URL created by taking the receiver and removing the last path component. (read-only)

var deletingPathExtension: URL?

A URL created by taking the receiver and removing the path extension, if any. (read-only)

var resolvingSymlinksInPath: URL?

A URL that points to the same resource as the receiver and includes no symbolic links. (read-only)

var standardizingPath: URL?

A URL that points to the same resource as the original URL using an absolute path. (read-only)