---
title: "grouping(_:)"
framework: foundation
role: symbol
role_heading: Instance Method
path: "foundation/decimal/formatstyle/grouping(_:)"
---

# grouping(_:)

Modifies the format style to use the specified grouping.

## Declaration

```swift
func grouping(_ group: Decimal.FormatStyle.Configuration.Grouping) -> Decimal.FormatStyle
```

## Parameters

- `group`: The grouping to apply to the format style.

## Return Value

Return Value A decimal format style modified to use the specified grouping.

## Discussion

Discussion The following example creates a default Decimal.FormatStyle for the en_US locale, and a second style that never uses grouping. It then applies each style to an array of decimal values. The formatting that the modified style applies eliminates the three-digit grouping usually performed for the en_US locale. let defaultStyle = FloatingPointFormatStyle<Double>(locale: Locale(identifier: "en_US")) let neverStyle = defaultStyle.grouping(.never) let nums = [100.1, 1000.2, 10000.3, 100000.4, 1000000.5] let defaultNums = nums.map { defaultStyle.format($0) } // ["100.1", "1,000.2", "10,000.3", "100,000.4", "1,000,000.5"] let neverNums = nums.map { neverStyle.format($0) } // ["100.1", "1000.2", "10000.3", "100000.4", "1000000.5"]

## See Also

### Customizing style behavior

- [decimalSeparator(strategy:)](foundation/decimal/formatstyle/decimalseparator(strategy:).md)
- [locale(_:)](foundation/decimal/formatstyle/locale(_:).md)
- [notation(_:)](foundation/decimal/formatstyle/notation(_:).md)
- [precision(_:)](foundation/decimal/formatstyle/precision(_:).md)
- [rounded(rule:increment:)](foundation/decimal/formatstyle/rounded(rule:increment:).md)
- [scale(_:)](foundation/decimal/formatstyle/scale(_:).md)
- [sign(strategy:)](foundation/decimal/formatstyle/sign(strategy:).md)
- [Decimal.FormatStyle.Configuration](foundation/decimal/formatstyle/configuration.md)
- [NumberFormatStyleConfiguration](foundation/numberformatstyleconfiguration.md)