Last updated on
Apr 27, 2021 06:02:28 AM GMT
|
Also Applies to ColdFusion
Description
Converts numeric characters that occur at the beginning of a string to a number.
Returns
A number. If conversion fails, returns zero.
Category
Conversion functions, String functions
History
ColdFusion (2018 release): Introduced named parameters.
Function syntax
Val(value)
See also
Parameters
Parameter |
Description |
---|---|
value |
A string or a variable that contains one |
Usage
This function works as follows:
- If TestValue = "234A56?7'", Val(TestValue) returns 234.
- If TestValue = "234'5678'9?'", Val(TestValue) returns 234.
- If TestValue = "BG234", Val(TestValue) returns the value 0, (not an error).
- If TestValue = "0", Val(TestValue) returns the value 0, (not an error).
Example
<cfscript> val1="234A56?7" writeOutput(Val(val1) & "<br/>") val2="234'5678'9?'" writeOutput(Val(val2) & "<br/>") val3="BG234" writeOutput(Val(val3) & "<br/>") val4="0" writeOutput(Val(val4) & "<br/>") </cfscript>