Skip to content

Initializer

init(string:encodingInvalidCharacters:)

iOS 17.0+ iPadOS 17.0+ Mac Catalyst 17.0+ macOS 14.0+ tvOS 17.0+ watchOS 10.0+
Creates a URL instance from the provided string, optionally IDNA- and percent-encoding any invalid characters.
init?(string: String, encodingInvalidCharacters: Bool)

Parameters

string

A URL location.

encodingInvalidCharacters

A Boolean value that indicates whether the initializer attempts to encode any invalid characters in string.

Discussion

If encodingInvalidCharacters is true, this initializer tries to encode the string to create a valid URL. If the URL string is still invalid after encoding, the initializer returns nil.

If encodingInvalidCharacters is false, and the URL string is invalid according to RFC 3986, nil is returned.