toString

Converts a value to a string.
Lucee parses numbers with one decimal place.
complex object types can only be used in combination with the member syntax.

toString(any_value [, encoding]) → returns string

Member Function Syntax

any_value.toString()

  1. CFDocs
  2. Functions
  3. String Functions
  4. toString
  5. CF4.5+
  6. Lucee
  7. BL 1.0.0+
  8. 0 Issue
  9. Edit
See Also:   Val   NumberFormat

Argument Reference

any_value any
Required

Value to convert to a string

encoding string

The character encoding (character set) of the string.

The default value is the encoding of the page on which the function is called.
Values:
  • utf-8
  • iso-8859-1
  • windows-1252
  • us-ascii
  • shift_jis
  • iso-2022-jp
  • euc-jp
  • euc-kr
  • big5
  • euc-cn
  • utf-16

Examples
Sample code invoking the toString function 

base64Value = toBase64( "stringValue" );
binaryValue = toBinary( base64Value );
stringValue = toString( binaryValue );
writeOutput(stringValue);

Expected Result: Expected Result: stringValue

s = {
    "a": "1",
    "b":"2"
};
writeOutput(toString(s));

Expected Result: {a={1},b={2}}

CF number toString as a method
CAUTION: While CF returns an integer (42), Lucee returns a double (42.0), that's because while CF stores the value as java.lang.Integer (CF 2018+) resp. java.lang.String (CF 2016+), Lucee calls this method on java.lang.Double.

num = 42;
writeOutput(num.toString());

Expected Result: 42

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub