lSIsCurrency
Description
Determines whether a string is a valid representation of a currency amount in the current locale.
Categories
Related
History
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.
Syntax
LSIsCurrency(string [, locale])
Attributes
| Attribute | Description | Required | Default |
|---|---|---|---|
| locale | Locale to use instead of the locale of the page when processing the function | ||
| string | A currency string or a variable that contains one. |
Returns
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.
Usage
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.
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.
Example
<h3>LSIsCurrency Example</h3>
<cfif IsDefined("FORM.locale")>
<!--- if locale is defined, set locale to that entry --->
<cfset NewLocale = SetLocale(FORM.locale)>
Is the value "<cfoutput>#FORM.myValue#</cfoutput>"
a proper currency value for <cfoutput>#GetLocale()#</cfoutput>?
Answer: <cfoutput>#LSIsCurrency(FORM.myValue)#</cfoutput>
</cfif>
<form action = "LSIsCurrency.cfm">
Select a locale for which you would like to check a currency value:
<!--- check the current locale for server --->
<cfset serverLocale = GetLocale()>