format(_:)

Declaration

func format(_ value: Value) -> String

Parameters

• value:

  The floating-point value to format.

Return Value

A string representation of value, formatted according to the style’s configuration.

Discussion

Use this method when you want to create a single style instance and use it to format multiple floating-point values. The following example creates a style that uses the en_US locale, then adds the scientific modifier. It applies this style to all the floating-point values in an array.

let scientificStyle = FloatingPointFormatStyle<Double>(
    locale: Locale(identifier: "en_US"))
    .notation(.scientific)
let nums = [100.1, 1000.2, 10000.3, 100000.4, 1000000.5]
let formattedNums = nums.map { scientificStyle.format($0) } // ["1.001E2", "1.0002E3", "1.00003E4", "1.000004E5", "1E6"]

To format a single floating-point value, use the BinaryFloatingPoint instance method formatted(_:), passing in an instance of FloatingPointFormatStyle, or formatted() to use a default style.