init(string:)

Initializes an NSURL object with a provided URL string.

Declaration

convenience init?(string URLString: String)

Parameters

URLString:
The URL string with which to initialize the NSURL object. Linked on or after iOS 17, this method parses URLString according to RFC 3986. Linked before iOS 17, this method parses URLString according to RFCs 1738 and 1808.

Return Value

An NSURL object initialized with URLString. If the URL string was malformed, returns nil.

Discussion

To check if URLString is strictly valid according to the RFC, use the new [NSURL URLWithString:URLString encodingInvalidCharacters:NO] method. This method leaves all characters as they are and returns nil if URLString is explicitly invalid.

For apps linked before iOS 17, this method expects URLString to contain only characters that are allowed in a properly formed URL. All other characters must be properly percent encoded. Any percent-encoded characters are interpreted using UTF-8 encoding.