String  - AS3

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

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

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

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

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

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

参数

相关 API 元素

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

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

参数

相关 API 元素

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

参数

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

参数

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

参数

相关 API 元素

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

参数

相关 API 元素

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

参数

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

参数

相关 API 元素

相对于字符串匹配指定的 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"}

相关 API 元素

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

参数

相关 API 元素

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

参数

相关 API 元素

将 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 参数，则会将整个字符串放入返回的数组的第一个元素中。

参数

相关 API 元素

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

参数

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

参数

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

相关 API 元素

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

相关 API 元素

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

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

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

Unicode 字符数据库规范中对这些条件映射进行了定义。

相关 API 元素

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

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

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

Unicode 字符数据库规范中对这些条件映射进行了定义。

相关 API 元素

返回 String 实例的原始值。此方法旨在将 String 对象转换为原始字符串值。因为 Flash 运行时可在必要时自动调用 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);
    }
}