Contents

sign(strategy:)

Modifies the format style to use the specified sign display strategy for displaying or omitting sign symbols.

Declaration

func sign(strategy: IntegerFormatStyle<Value>.Configuration.SignDisplayStrategy) -> IntegerFormatStyle<Value>

Parameters

  • strategy:

    The sign display strategy to apply to the format style, such as Automatic or Never.

Return Value

An integer format style modified to use the specified sign display strategy.

Discussion

The following example creates a default IntegerFormatStyle for the en_US locale, and a second style that displays a sign for all values except zero. It then applies each style to an array of integers. The formatting that the modified style applies adds the negative (-) or positive (+) sign to all the numbers.

let defaultStyle = IntegerFormatStyle<Int>(locale: Locale(identifier: "en_US"))
let alwaysStyle = defaultStyle.sign(strategy: .always(includingZero: false))
let nums = [-2, -1, 0, 1, 2]
let defaultNums = nums.map { defaultStyle.format($0) } // ["-2", "-1", "0", "1", "2"]
let alwaysNums = nums.map { alwaysStyle.format($0) } // ["-2", "-1", "0", "+1", "+2"]

See Also

Customizing style behavior