一个整数，它指定在所指定的 String 对象中的字符数。

因为所有字符串索引都是从零开始的，所以任何字符串 x 的最后一个字符的索引都是 x.length - 1。

另请参见

创建已初始化为指定字符串的新 String 对象。

注意：由于字符串文本比 String 对象需要的开销少且通常更易于使用，所以，除非有充分的理由要使用 String 对象而不是字符串文本，否则应该使用字符串文本而不是 String 类。

另请参见

返回由参数 index 指定的位置处的字符。 如果 index 不是从 0 到 string.length - 1 之间的数字，则返回一个空字符串。

此方法与 String.charCodeAt() 类似，所不同的是它返回的值是一个字符，而不是 16 位整数字符代码。

参数

另请参见

返回指定 index 处的字符的数值 Unicode 字符代码。 如果 index 不是从 0 到 string.length - 1 之间的数字，则返回 NaN。

此方法与 String.charAt() 类似，所不同的是它返回的值是 16 位整型字符代码，而不是实际的字符。

参数

另请参见

在 String 对象末尾追加补充参数（如果需要，将它们转换为字符串）并返回结果字符串。 源 String 对象的原始值保持不变。

参数

另请参见

返回一个字符串，该字符串由参数中的 Unicode 字符代码所表示的字符组成。

参数

另请参见

搜索字符串，并返回在调用字符串内 startIndex 位置上或之后找到的 val 的第一个匹配项的位置。 此索引从 0 开始，这意味着字符串的第一个字符位于索引 0，而不是索引 1。 如果未找到 val，则该方法返回 -1。

参数

另请参见

从右向左搜索字符串，并返回在 startIndex 之前找到的最后一个 val 匹配项的索引。 此索引从零开始，这意味着第一个字符位于索引 0 处，最后一个字符位于 string.length - 1 处。 如果未找到 val，则该方法返回 -1。

参数

另请参见

比较两个或更多个字符串的排序顺序，并返回整数形式的比较结果。 虽然此方法旨在以特定于区域设置的方式处理比较，但 ActionScript 3.0 实现生成的结果与其它字符串比较的结果相同，例如，等于 (==) 或不等于 (!=) 运算符。 如果字符串相等，则返回值为 0。 如果原始字符串值在 other 指定的字符串值之前，则返回值为负整数，该值的绝对值表示这两个字符串值之间不相同的字符数。 如果原始字符串值在 other 之后，返回值为正整数，该值的绝对值表示这两个字符串值之间不相同的字符数。

参数

将指定的 pattern 与字符串匹配。

参数

另请参见

相对于字符串匹配指定的 pattern 并返回一个新字符串，其中的第一个 pattern 匹配项被替换为 repl 所指定的内容。 pattern 参数可以是字符串或正则表达式。 repl 参数可以是字符串或函数；如果是函数，将插入由该函数返回的字符串以替换匹配项。 未修改原始字符串。

在下面的示例中，仅替换“sh”（区分大小写）的第一个实例：

 var myPattern:RegExp = /sh/;  
 var str:String = "She sells seashells by the seashore.";
 trace(str.replace(myPattern, "sch"));  
    // She sells seaschells by the seashore.

在下面的示例中，替换“sh”（区分大小写）的所有实例，这是因为在正则表达式中设置了 g（全局）标志：

 var myPattern:RegExp = /sh/g;  
 var str:String = "She sells seashells by the seashore.";
 trace(str.replace(myPattern, "sch"));  
    // She sells seaschells by the seaschore.

在下面的示例中，替换“sh”的所有实例，这是因为在正则表达式中设置了 g（全局）标志，并且匹配时不 区分大小写，因为设置了 i（忽略大小写）标志：

 var myPattern:RegExp = /sh/gi;  
 var str:String = "She sells seashells by the seashore.";
 trace(str.replace(myPattern, "sch"));  
    // sche sells seaschells by the seaschore.

参数

var str:String = "flip-flop";
 var pattern:RegExp = /(\w+)-(\w+)/g;
 trace(str.replace(pattern, "$2-$1")); // flop-flip

 var str1:String = "abc12 def34";
 var pattern:RegExp = /([a-z]+)([0-9]+)/;
 var str2:String = str1.replace(pattern, replFN);
 trace(str2);   // 12abc 34def
 
 function replFN():String {
  return arguments[2] + arguments[1];
 }

 {"abc12", "abc", "12", 0, "abc12 def34"}

 {"def34", "def", "34", 6, "abc123 def34"}

另请参见

搜索指定的 pattern 并返回第一个匹配子字符串的索引。 如果没有匹配的子字符串，该方法返回 -1。

参数

另请参见

返回一个字符串，该字符串包括从 startIndex 字符一直到 endIndex 字符（但不包括该字符）之间的所有字符。 不修改原始 String 对象。 如果未指定 endIndex 参数，此子字符串的结尾就是该字符串的结尾。 如果按 startIndex 索引到的字符与按 endIndex 索引到的字符相同或位于后者的右侧，则该方法返回一个空字符串。

参数

另请参见

将 String 对象拆分为一个子字符串数组，方法是在所有出现指定 delimiter 参数的位置进行拆分。

如果 delimiter 参数是正则表达式，即使向后跟踪可以找到与该位置匹配的非空子字符串，也仅考虑字符串给定位置处的第一个匹配项。 例如：

  var str:String = "ab";
  var results:Array = str.split(/a*?/); // results == ["","b"]
  
  results = str.split(/a*/); // results == ["","b"].)

如果 delimiter 参数是包含分组圆括号的正则表达式，则每次匹配 delimiter 时，会将分组圆括号的结果（包括任何未定义的结果）连接到输出数组中。 例如

  var str:String = "Thi5 is a tricky-66 example.";
  var re:RegExp = /(\d+)/;
  var results:Array = str.split(re);
      // results == ["Thi","5"," is a tricky-","66"," example."]

如果指定 limit 参数，返回的数组中具有的元素数将不多于指定数目。

如果 delimiter 是空字符串、空正则表达式或者可以匹配空字符串的正则表达式，则字符串中的每一个字符都将输出为数组中的一个元素。

如果未定义 delimiter 参数，则会将整个字符串放入返回的数组的第一个元素中。

参数

另请参见

返回一个子字符串，该子字符串中的字符是通过从指定的 startIndex 开始，按照 len 指定的长度截取所得的。 原始字符串保持不变。

参数

另请参见

返回一个字符串，其中包含由 startIndex 指定的字符和一直到 endIndex - 1 的所有字符。 如果未指定 endIndex，则使用 String.length。 如果 startIndex 的值等于 endIndex 的值，则该方法返回一个空字符串。 如果 startIndex 的值大于 endIndex 的值，则在执行函数之前会自动交换参数。 原始字符串保持不变。

参数

另请参见

返回此字符串的一个副本，其中所有大写的字符均转换为小写字符。 原始字符串保持不变。 虽然此方法旨在以特定于区域设置的方式处理转换，但 ActionScript 3.0 实现生成的结果与 toLowerCase() 方法生成的结果相同。

另请参见

返回此字符串的一个副本，其中所有小写的字符均转换为大写字符。 原始字符串保持不变。 虽然此方法旨在以特定于区域设置的方式处理转换，但 ActionScript 3.0 实现生成的结果与 toUpperCase() 方法生成的结果相同。

另请参见

返回此字符串的一个副本，其中所有大写的字符均转换为小写字符。 原始字符串保持不变。

此方法转换所有存在 Unicode 小写等效项的字符（不仅仅是 A-Z）：

  var str:String = " JOSÉ BARÇA";
  trace(str.toLowerCase()); // josé barça

另请参见

返回此字符串的一个副本，其中所有小写的字符均转换为大写字符。 原始字符串保持不变。

此方法转换所有存在 Unicode 大写等效项的字符（不仅仅是 a-z）：

  var str:String = "José Barça";
  trace(str.toUpperCase()); // JOSÉ BARÇA

另请参见

返回 String 实例的原始值。 此方法旨在将 String 对象转换为原始字符串值。 因为 Flash Player 会在需要时自动调用 valueOf()，所以几乎不需要显式调用此方法。

1. StringExample 的构造函数声明多个局部 String 实例，这些实例可使用不同字符串和一个新的 StringHelper 对象初始化。
2. StringHelper 类具有下列方法：
   • replace()：调用 String 的 split() 和 join() 方法，以删除用新字符串传入的字符串的一个子字符串。
   • trim()：使用传入的字符串调用 trimBack() 和 trimFront()，并返回更新后的字符串。
   • trimFront()：以递归方式删除所有与 char 参数匹配的字符，从字符串的开头开始向后删除，直到字符串中第一个字符与 char 不匹配为止，并返回更新后的字符串。
   • trimBack()：以递归方式删除所有与 char 参数匹配的字符，从字符串的末尾开始向前删除，直到字符串中最后一个字符与 char 不匹配为止，并返回更新后的字符串。
   • stringToCharacter()：返回传入字符串的第一个字符。
3. 然后，使用声明的字符串变量生成了 3 个字符串，其中调用 replace() 方法生成第二个字符串，调用 trim() 生成第 3 个字符串。

package {
    import flash.display.Sprite;

    public class StringExample extends Sprite {
        public function StringExample() {
            var companyStr:String = new String("     Company X");
            var productStr:String = "Product Z Basic     ";
            var emptyStr:String = " ";
            var strHelper:StringHelper = new StringHelper();

            var companyProductStr:String = companyStr + emptyStr + productStr;
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Basic     '

            companyProductStr = strHelper.replace(companyProductStr, "Basic", "Professional");
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Professional     '

            companyProductStr = strHelper.trim(companyProductStr, emptyStr);
            trace("'" + companyProductStr + "'");    // 'Company X Product Z Professional'
        }
    }
}

class StringHelper {
    public function StringHelper() {
    }

    public function replace(str:String, oldSubStr:String, newSubStr:String):String {
        return str.split(oldSubStr).join(newSubStr);
    }

    public function trim(str:String, char:String):String {
        return trimBack(trimFront(str, char), char);
    }

    public function trimFront(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(0) == char) {
            str = trimFront(str.substring(1), char);
        }
        return str;
    }

    public function trimBack(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(str.length - 1) == char) {
            str = trimBack(str.substring(0, str.length - 1), char);
        }
        return str;
    }

    public function stringToCharacter(str:String):String {
        if (str.length == 1) {
            return str;
        }
        return str.slice(0, 1);
    }
}