stringLiteral

Optional. Any group of Unicode characters.

String objects can be created implicitly using string literals. String objects created in this fashion (referred to as "primitive" strings) are treated differently from String objects created using the new operator. Although you can read properties and call methods on primitive strings, you cannot create new properties or add methods to them.

Escape sequences can be used in string literals to represent special characters that cannot be used directly in a string, such as the newline character or Unicode characters. At the time a script is compiled, each escape sequence in a string literal is converted into the characters it represents. For additional information, see String Data.

JScript also defines a String data type, which provides different properties and methods from the String object. You cannot create properties or add methods to variables of the String data type, while you can for instances of the String object.

The String object interoperates with String data type (which is the same as the System.String data type). This means that a String object can call the methods and properties of the String data type, and a String data type can call the methods and properties of the String object. For more information, see AllMembers.T:System.String. Furthermore, String objects are accepted by functions that take String data types, and vice versa.

The data type of a String object is Object, not String.

This script demonstrates that although the length property can be read and the toUpperCase method can be called, the custom property myProperty cannot be set on the primitive string:

В	Copy Code
var primStr : Object = "This is a string"; print(primStr.length); // Read the length property. print(primStr.toUpperCase()); // Call a method. primStr.myProperty = 42; // Set a new property. print(primStr.myProperty); // Try to read it back.

The output of this script is:

В	Copy Code
16 THIS IS A STRING undefined

For String objects created with the new statement, custom properties can be set:

В	Copy Code
var newStr : Object = new String("This is also a string"); print(newStr.length); // Read the length property. print(newStr.toUpperCase()); // Call a method. newStr.myProperty = 42; // Set a new property. print(newStr.myProperty); // Try to read it back.

The output of this script is:

В	Copy Code
21 THIS IS ALSO A STRING 42

String Object Properties and Methods

Version 1

Reference

Concepts