Skip to content

Initializer

init(locale:)

iOS 15.0+ iPadOS 15.0+ Mac Catalyst 15.0+ macOS 12.0+ tvOS 15.0+ watchOS 8.0+
Creates a floating-point format style that uses the given locale.
init(locale: Locale = .autoupdatingCurrent)

Parameters

locale

The locale to use when formatting or parsing floating-point values. Defaults to Locale.autoupdatingCurrent.

Discussion

Create a FloatingPointFormatStyle when you intend to apply a given style to multiple floating-point values. The following example creates a style that uses the en_US locale, which uses three-based grouping and comma separators. It then applies this style to all the Double values in an array.

let enUSstyle = FloatingPointFormatStyle<Double>(locale: Locale(identifier: "en_US"))
let nums = [100.1, 1000.2, 10000.3, 100000.4, 1000000.5]
let formattedNums = nums.map { enUSstyle.format($0) } // ["100.1", "1,000.2", "10,000.3", "100,000.4", "1,000,000.5"]

To format a single value, you can use the BinaryFloatingPoint instance method formatted(_:), passing in an instance of FloatingPointFormatStyle.