Determines whether a string is a valid representation of a currency amount in the current locale.
True, if the parameter is formatted as a valid currency amount, including the appropriate currency indicator. The return value is True for amounts in the local, international, or none currency formats.
1 | LSIsCurrency (string [, locale]) |
ColdFusion 8: Added the locale parameter.
ColdFusion MX: Changed formatting behavior: this function might return a different result than in earlier releases. This function uses Java standard locale formatting rules on all platforms; the results might vary depending upon the JVM; for example, Sun JVM 1.4.1 requires euro format the local currency if the current locale's country belongs to the Euro Zone.
Parameter |
Description |
---|---|
string |
A currency string or a variable that contains one. |
locale |
Locale to use instead of the locale of the page when processing the function |
For examples of ColdFusion code and output that shows differences between earlier ColdFusion releases and ColdFusion MX in accepting input formats and displaying output, see LSCurrencyFormat.
Note:
If the locale belongs to a Euro zone country and the currency is a correctly formatted euro value for the locale, this function returns True for all JVMs, including Sun 1.3.1. As a result, with 1.3.1-compliant JVMs, the LSIsCurrency function does not ensure that LSParseCurrency returns a value. If a currency uses the older country-specific format for Euro Zone locales, the LSIsCurrency function returns False for newer JVMs, such as Sun 1.4.1 and 1.6, and True for older JVMs, such as Sun 1.3.1.
Note:
To set the default display format of date, time, number, and currency values, use the SetLocale function.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <h3> LSIsCurrency Example</h3> < cfif IsDefined ( "FORM.locale" )> <!--- if locale is defined, set locale to that entry ---> < cfset NewLocale = SetLocale (FORM.locale)> <p>Is the value "<cfoutput>#FORM.myValue#</cfoutput>" a proper currency value for < cfoutput ># GetLocale ()#</ cfoutput >? <p>Answer: < cfoutput ># LSIsCurrency (FORM.myValue)#</ cfoutput > </ cfif > <p><form action = "LSIsCurrency.cfm" > <p>Select a locale for which you would like to check a currency value: <!--- check the current locale for server ---> < cfset serverLocale = GetLocale ()> |