---
title: ListFormatter
framework: foundation
role: symbol
role_heading: Class
path: foundation/listformatter
---

# ListFormatter

An object that provides locale-correct formatting of a list of items using the appropriate separator and conjunction.

## Declaration

```swift
class ListFormatter
```

## Overview

Overview The list formatter isn’t aware of the context where the formatted string will be used and doesn’t provide capitalization customization of the list items. The formatted result may not be grammatically correct if placed in a sentence, and it should only be used in a standalone manner.

## Topics

### Converting Arrays to Formatted Lists

- [string(from:)](foundation/listformatter/string(from:).md)
- [string(for:)](foundation/listformatter/string(for:).md)
- [localizedString(byJoining:)](foundation/listformatter/localizedstring(byjoining:).md)

### Configuring Formatter Options

- [itemFormatter](foundation/listformatter/itemformatter.md)
- [locale](foundation/listformatter/locale.md)

## Relationships

### Inherits From

- [Formatter](foundation/formatter.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSCoding](foundation/nscoding.md)
- [NSCopying](foundation/nscopying.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)