Adobe ColdFusion 8

LSIsNumeric

Description

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

Returns

True, if the string represents a number the current locale; False, otherwise.

Category

Decision functions, International functions, String functions

Function syntax

LSIsNumeric(string [, locale])

See also

GetLocale, SetLocale; "Handling data in ColdFusion" in the ColdFusion Developer's Guide

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.

Parameters

Parameter

Description

string

A string or a variable that contains one

locale

Locale to use instead of the locale of the page when processing the function

Usage

To set the default display format of date, time, number, and currency values, use the SetLocale function.

Example

<h3>LSIsNumeric 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 numeric value for <cfoutput>#GetLocale()#</cfoutput>?

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

<p><form action = "LSIsNumeric.cfm">

<p>Select a locale for which to check a numeric value:
...