Modern String MoneySetLocale

Home › String Library › String Library › MoneySetLocale

MoneySetLocale

Forces the monetary settings to a named locale instead of the user's own. "" means the user's. Returns false if the system does not know the name.

Syntax

MoneySetLocale( localeName ) as boolean

Notes

• Names are platform-spelled: "de-DE" on Windows, "de_DE.UTF-8" on Linux and macOS.
• On Linux glibc only knows locales that have been GENERATED, so a perfectly valid name can still be rejected. That is what the false is for.
• When it returns false the formatter falls back to ., ,, 3;0 repeating, two fraction digits, symbol first, no space and sign before all. A symbol is never invented.
• It rewrites the process-wide snapshot, so it is NOT thread-safe against a concurrent format. Call it at start-up, or while nothing is formatting.
• On Linux and macOS it asks for LC_MONETARY alone, never LC_ALL: widening it would move LC_NUMERIC too, and DecimalFromDouble parses snprintf( "%.14e" ) output, so under a German LC_NUMERIC every double assigned to a MoneyFormat would silently become an invalid Decimal.

Examples

if MoneySetLocale( "de-DE" ) then
    dim as MoneyFormat m = DecimalParse( "-1234.5" ).Value( )
    print m.ToString( )              '' -1.234,50 €
end if

MoneySetLocale( "" )                  '' back to the user's own

---

Library: String Library
Category: String Library
Documented under: Money Formatting