Adobe ColdFusion 8

Chr

Converts a numeric value to a UCS-2 character.

Returns

A character with the specified UCS-2 character code.

Category

String functions

Function syntax

Chr(number)

See also

Asc

History

ColdFusion MX: Changed Unicode support: ColdFusion supports the Java UCS-2 representation of Unicode characters, up to a value of 65535. (Earlier releases supported 1-255.)

Parameters

Parameter

Description
number

A value (a number in the range 0 to 65535, inclusive)

Usage

The values 0 - 31 are standard, nonprintable codes. For example:

  • Chr(10) returns a linefeed character
  • Chr(13) returns a carriage return character
  • The two-character string Chr(13) & Chr(10) returns a Windows newline

Note: For a complete list of the Unicode characters and their codes, see www.unicode.org/charts/

Example

<!--- If the character string is not empty, output its Chr value. --->
<cfif IsDefined("form.charVals")>
        <cfoutput>#form.charVals# = #Chr(form.charVals)#</cfoutput>
</cfif>

<cfform action="#CGI.script_name#" method="POST">
    <p>Type an integer character code from 1 to 65535<br>
        to see its corresponding character.<br>
    <cfinput type="Text" 
        name="CharVals" 
        range="1,65535" 
        message="Enter an integer from 1 to 65535" 
        validate="integer" 
        required="Yes" 
        size="5" 
        maxlength="5"
        >
<p><input type="Submit" name=""> <input type="RESET">
</cfform>