The charVal(...) function has two variations, not counting syntax variations. It is used to get a character given a character code or codepoint value.  A character code, or more formally a codepoint, is the numeric value assigned to each character in a charset.

Syntax:
charVal( character-code )
charVal( character-code, charset-name )
character-code.charVal()
character-code.charVal( charset-name )

 

 

Parameter	Description
character-code	The integer value containing the character code or codepoint of the character to be computed.  If character-code is null, the result of the function will be null.
charset-name	The name of the charset from which to compute the character value.  If the charset-name is null or omitted, then the default is Unicode.

 

Error Results
There are several conditions which can make it impossible to compute a character value from a character code.  In these cases the function result is a message indicating what problem occured.

Result	Description
"INVALID_CHARACTER"	The character code given does not represent a valid character in the charset chosen.  For instance, negative numbers and numbers greater than the size of the charset will have this result.
"INVALID_CODEPOINT"	The character code given does not represent a valid character in Unicode.  Certain ranges of codepoints are marked unused in the Unicode specification.  Also negative numbers and numbers greater than the maximum value of a unsigned 32-bit integer will have this result when no charset is chosen.
"INVALID_CHARSET"	The charset specified is not a valid charset name, or is not a supported charset.  A list of supported character sets can be found in Sun Microsystem's Java documentation.