Creates and returns an NSURL object initialized with a base URL and a relative string.
SDKs
- iOS 2.0+
- macOS 10.0+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Foundation
Declaration
Parameters
URLString
The URL string with which to initialize the NSURL object. May not be
nil
. Must conform to RFC 2396.URLString
is interpreted relative tobase
.URL baseURL
The base URL for the NSURL object.
Return Value
An NSURL object initialized with URLString
and base
. If URLString
was malformed or nil
, returns nil
.
Discussion
This method allows you to create a URL relative to a base path or URL. For example, if you have the URL for a folder on disk and the name of a file within that folder, you can construct a URL for the file by providing the folder’s URL as the base path (with a trailing slash) and the filename as the string part.
This method expects URLString
to contain only characters that are allowed in a properly formed URL. All other characters must be properly percent escaped. Any percent-escaped characters are interpreted using UTF-8 encoding.
Note
In macOS 10.7 and later or iOS 5 and later, this method returns nil
if the URL string is nil
. In earlier versions, this method throws an exception if the URL string is nil
.