---
title: "uppercased(with:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/nsstring/uppercased(with:)"
---

# uppercased(with:)

Returns a version of the string with all letters converted to uppercase, taking into account the specified locale.

## Declaration

```swift
func uppercased(with locale: Locale?) -> String
```

## Parameters

- `locale`: The locale. For strings presented to users, pass the current locale ([doc://com.apple.foundation/documentation/Foundation/NSLocale doc://com.apple.foundation/documentation/Foundation/NSLocale/current]). To use the system locale, pass nil.

## Return Value

Return Value An uppercase string using the locale.

## See Also

### Changing Case

- [lowercased](foundation/nsstring/lowercased.md)
- [localizedLowercase](foundation/nsstring/localizedlowercase.md)
- [lowercased(with:)](foundation/nsstring/lowercased(with:).md)
- [uppercased](foundation/nsstring/uppercased.md)
- [localizedUppercase](foundation/nsstring/localizeduppercase.md)
- [capitalized](foundation/nsstring/capitalized.md)
- [localizedCapitalized](foundation/nsstring/localizedcapitalized.md)
- [capitalized(with:)](foundation/nsstring/capitalized(with:).md)