Instance Method

url(relativeTo:)

Returns a URL object derived from the components object.

Declaration

func url(relativeTo baseURL: URL?) -> URL?

Parameters

baseURL

If non-nil, this URL is used as the base URL portion of the resulting URL object.

Discussion

If the components object has an authority component (user, password, host, or port) and a path component, then the path must either begin with "/" or be an empty string. Otherwise, this property contains nil.

If the NSURLComponentsdoes not have an authority component (user, password, host, or port) and has a path component, the path component must not start with "//". If it does, this property contains nil.

To configure a components object based on an existing URL, call either the componentsWithURL:resolvingAgainstBaseURL: or init(url:resolvingAgainstBaseURL:) method.

See Also

Getting the URL

var string: String?

A URL derived from the components object, in string form.

var url: URL?

A URL object derived from the components object.

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