Contents

localizedIntegerCurrency(code:locale:)

Creates a regex component that matches a localized currency string, capturing it as an integer value.

Declaration

static func localizedIntegerCurrency(code: Locale.Currency, locale: Locale) -> Self

Parameters

  • code:

    The currency code that indicates the currency symbol or name to match against.

  • locale:

    The locale that specifies formatting conventions to use when matching currency strings.

Return Value

A RegexComponent that matches localized currency substrings as Int instances.

Discussion

This method matches currency substrings in accordance with the provided currency code and locale. For example, the currency code USD matches U.S. dollars, which use the symbol $, and JPY matches Japanese yen, which use the symbol ¥. The locale determines formatting conventions for number separators in the currency value. The regex uses both of these to match currency substrings.

The method truncates fractional parts in currency strings. To match currency strings with fractional parts, use localizedCurrency(code:locale:) instead.

The following example creates a Regex that matches a date and time followed by whitespace and a currency value that uses U.S. dollars and the en_US locale. It then matches this regex against a source string containing a date with this format, some whitespace, and a currency value in dollars.

let enUSLocale = Locale(languageCode: .english, languageRegion: .unitedStates)
let source = "7/31/2022, 5:15:12 AM    $39,739"
let matcher = Regex {
    One(.dateTime(date: .numeric,
                  time: .standard,
                  locale: enUSLocale,
                  timeZone: TimeZone(identifier: "PST")!))
    OneOrMore(.horizontalWhitespace)
    Capture {
        One(.localizedIntegerCurrency(code: Locale.Currency("USD"),
                                      locale: enUSLocale))
    }
}

guard let match = source.firstMatch(of: matcher) else { return }
let currency = match?.1 // currency == 39739

See Also

Matching numeric formats