---
title: "formatted(_:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/url/formatted(_:)"
---

# formatted(_:)

Formats the URL, using the provided format style.

## Declaration

```swift
func formatted<F>(_ format: F) -> F.FormatOutput where F : FormatStyle, F.FormatInput == URL
```

## Parameters

- `format`: The format style to apply when formatting the URL.

## Return Value

Return Value A formatted string representation of the URL.

## Discussion

Discussion Use this method when you want to format a single URL value with a specific format style, or call it repeatedly with different format styles. The following example uses the static accessor url to get a default style, then modifies its behavior to include or omit different URL components when formatted(_:) creates the string: let url = URL(string:"https://www.example.com:8080/path/to/endpoint?key=value")! let formatted = url.formatted(.url     .scheme(.never)     .host(.always)     .port(.never)     .path(.always)     .query(.never)) // "www.example.com/path/to/endpoint"

## See Also

### Formatting a URL

- [formatted()](foundation/url/formatted().md)
- [URL.FormatStyle](foundation/url/formatstyle.md)