User Guide

LSIsCurrency 605

LSIsCurrency

Description

Determines whether a string is a valid representation of a currency amount in the current locale.

Returns

True, if the parameter is formatted as a valid currency amount, including the appropriate currency

indicator. Returns True for amounts in the local, international, or none currency formats.

See also

GetLocale, SetLocale, LSCurrencyFormat

History

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.

Parameters

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 on page 597.

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

False for newer JVMs, such as Sun 1.4.1 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>

<p>Is the value "<cfoutput>#FORM.myValue#</cfoutput>"

a proper currency value for <cfoutput>#GetLocale()#</cfoutput>?

<p>Answer: <cfoutput>#LSIsCurrency(FORM.myValue)#</cfoutput>

</cfif>

Parameter Description

string A currency string or a variable that contains one.