Instance Method

URLByAppendingPathComponent:

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

Declaration

- (NSURL *)URLByAppendingPathComponent:(NSString *)pathComponent;

Parameters

pathComponent

The path component to add to the URL, in its original form (not URL encoded).

Return Value

A new URL with pathComponent appended.

Discussion

If the original URL does not end with a forward slash and pathComponent does not begin with a forward slash, a forward slash is inserted between the two parts of the returned URL, unless the original URL is the empty string.

If the receiver is a file URL and pathComponent does not end with a trailing slash, this method may read file metadata to determine whether the resulting path is a directory. This is done synchronously, and may have significant performance costs if the receiver is a location on a network mounted filesystem. You can instead call the URLByAppendingPathComponent:isDirectory: method if you know whether the resulting path is a directory to avoid this file metadata operation.

See Also

Modifying and Converting a File URL

filePathURL

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

- fileReferenceURL

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

- URLByAppendingPathComponent:isDirectory:

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.

- URLByAppendingPathExtension:

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

URLByDeletingLastPathComponent

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

URLByDeletingPathExtension

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

URLByResolvingSymlinksInPath

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

URLByStandardizingPath

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

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