# url(scheme:user:password:host:port:path:query:fragment:) Creates a regex component that matches a URL substring, capturing it as a Foundation URL. ``` static func url(scheme: URL.ParseStrategy.ComponentParseStrategy = .required, user: URL.ParseStrategy.ComponentParseStrategy = .optional, password: URL.ParseStrategy.ComponentParseStrategy = .optional, host: URL.ParseStrategy.ComponentParseStrategy = .required, port: URL.ParseStrategy.ComponentParseStrategy = .optional, path: URL.ParseStrategy.ComponentParseStrategy = .optional, query: URL.ParseStrategy.ComponentParseStrategy = .optional, fragment: URL.ParseStrategy.ComponentParseStrategy = .optional) -> Self ``` ## Parameters `scheme` A for matching the URL scheme component. `user` A for matching the user component. `password` A for matching the password component. `host` A for matching the host component. `port` A for matching the port component. `path` A for matching the path component. `query` A for matching the query component. `fragment` A for matching the fragment component. ## Return Value A `RegexComponent` that matches a URL. ## Discussion All the parameters to this method take a value to configure the matching behavior for one component of the URL. The three possible values are: - — The URL component needs to be present for matching to succeed. - — The URL component doesn’t need to be present for matching to succeed. - — If the URL component is absent, the captured URL contains the provided default value for the component. The following example creates a [`Regex`](/documentation/Swift/Regex) that matches a URL, when it contains a scheme and a host. It then matches against a source string that contains a date formatted in the `en_US` locale, some whitespace, and a valid URL. The regex defines a default value for the port with , and because the source URL doesn’t include a port, the captured URL adds it. ``` let source = "7/31/2022, 5:15:12 AM https://www.example.com/productList?query=slushie" let matcher = Regex { One(.dateTime(date: .numeric, time: .standard, locale: Locale(identifier: "en_US"), timeZone: TimeZone(identifier: "PST")!)) OneOrMore(.horizontalWhitespace) Capture { One(.url(scheme: .required, user: .optional, password: .optional, host: .required, port: .defaultValue(8088), path: .optional, query: .optional, fragment: .optional)) } } guard let match = source.firstMatch(of: matcher) else { return } let url = match.1 // url = https://www.example.com:8088/productList?query=slushie ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)