LSParseNumber

Description

Formats a locale-specific string as a number.

Return value

A number that matches the value of the string.

Category

International functions, String functions

Syntax

LSParseNumber(string) 

See also

LSParseDateTime, SetLocale

History

New in ColdFusion MX: This function might return different formatting 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

Usage

This function uses Java standard locale formatting rules on all platforms.

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

Example

<h3>LSParseNumber Example</h3>
<p>LSParseNumber converts a locale-specific string to a number. 
Returns the number matching the value of string. 
<!--- loop through a list of locales and show number values --->
<cfloop LIST = "#Server.Coldfusion.SupportedLocales#"
index = "locale" delimiters = ",">
  <cfset oldlocale = SetLocale(locale)>

  <cfoutput><p><B><I>#locale#</I></B><br>
    #LSNumberFormat(-1234.5678, "_________")#<br>
    #LSNumberFormat(-1234.5678, "_________.___")#<br>
    #LSNumberFormat(1234.5678, "_________")#<br>
    #LSNumberFormat(1234.5678, "_________.___")#<br>    
    #LSNumberFormat(1234.5678, "$_(_________.___)")#<br>    
    #LSNumberFormat(-1234.5678, "$_(_________.___)")#<br>    
    #LSNumberFormat(1234.5678, "+_________.___")#<br>    
    #LSNumberFormat(1234.5678, "-_________.___")#<br>    
    The actual number: 
      #LSParseNumber(LSNumberFormat(1234.5678, "_________"))#<br>
    <hr noshade>
  </cfoutput>
</cfloop>

Comments