String  - AS3

Целое число, определяющее количество символов в заданном объекте String.

Поскольку все индексы строк начинаются с нуля, индекс последнего символа любой строки x равняется x.length - 1.

Создает новый объект String, инициализированный для заданной строки.

Примечание. Поскольку строковые литералы используют меньше служебной информации, чем объекты String, и их обычно проще применять, необходимо использовать строковые литералы вместо класса String, если нет весомой причины выбрать объект String вместо строкового литерала.

Возвращает символ в позиции, заданной параметром индекса. Если index не является числом от 0 до string.length - 1, возвращается пустая строка.

Этот метод напоминает String.charCodeAt(), за исключением того, что возвращаемое значение является символом, а не 16-разрядным целочисленным кодом символа.

Параметры

Связанные элементы API

Возвращает числовой код символа Юникод для символа в заданном индексе. Если индекс не является числом от 0 до string.length - 1, возвращается NaN.

Этот метод напоминает метод String.charAt(),, за исключением того, что возвращаемое значение является 16-разрядным целочисленным кодом символа, а не фактическим символом.

Параметры

Связанные элементы API

Добавляет переданные аргументы к концу объекта String, при необходимости преобразуя их в строки, затем возвращает получившуюся строку. Первоначальное значение исходного объекта String остается неизменным.

Параметры

Возвращает строку с символами, представленными в параметрах кодами Юникод.

Параметры

Выполняет поиск строки и возвращает позицию первого вхождения параметра val, обнаруженного после элемента startIndex (включая этот элемент), в пределах вызывающей строки. Этот индекс начинается с нуля. Это означает, что первый символ в строке имеет индекс 0, а не 1. Если значение val не найдено, метод возвращает «-1».

Параметры

Связанные элементы API

Выполняет поиск строки справа налево и возвращает индекс последнего вхождения параметра val, обнаруженного перед элементом startIndex. Этот индекс начинается с нуля. Это означает, что первый символ имеет индекс 0, а последний – string.length - 1. Если значение val не найдено, метод возвращает -1.

Параметры

Связанные элементы API

Сравнивает порядок сортировки двух или более строк и возвращает результат сравнения в виде целого числа. Хотя этот метод предназначен для проведения регионального сравнения, реализация ActionScript 3.0 не приводит к появлению другого результата при сравнении других строк, например, операторов равенства (==) или неравенства (! =). Если строки эквивалентны, возвращается значение 0. Если исходное строковое значение предшествует строковому значению, указанному в параметре other, возвращается отрицательное целое число, абсолютное значение которого отражает количество символов, разделяющих два этих строковых значения. Если исходное строковое следует за параметром other, возвращается положительное целое число, абсолютное значение которого отражает количество символов, разделяющих два этих строковых значения.

Параметры

Сопоставляет заданный pattern со строкой.

Параметры

Связанные элементы API

Сопоставляет заданный шаблон со строкой и возвращает новую строку, в которой первое совпадение шаблона заменяется содержимым, заданным параметром 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 (global):

    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 (global), а совпадения не зависят от регистра, так как установлен флаг i (ignoreCase):

    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

Выполняет поиск заданного шаблона и возвращает индекс первой совпадающей подстроки. Если совпадающей подстроки нет, метод возвращает -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

Возвращает копию этой строки с преобразованием всех прописных символов в строчные. Исходная строка не менялась.

Этот метод преобразует все символы (не только в диапазоне от A до Z), для которых существуют строчные эквиваленты в Юникоде:

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

Соответствия регистров определены в спецификации Базы данных символов Юникод.

Связанные элементы API

Возвращает копию этой строки с преобразованием всех строчных символов в прописные. Исходная строка не менялась.

Этот метод преобразует все символы (не только в диапазоне от A до Я), для которых существуют прописные эквиваленты в Юникоде:

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

Соответствия регистров определены в спецификации Базы данных символов Юникод.

Связанные элементы API

Возвращает элементарное значение экземпляра String. Этот метод разработан для преобразования объекта String в элементарное строковое значение. Поскольку среда выполнения Flash автоматически вызывает при необходимости valueOf(), вызывать этот метод образом приходится нечасто.

1. Конструктор для StringExample объявляет несколько локальных экземпляров String, которые инициализируются с помощью различных строк и нового объекта StringHelper.
2. Класс StringHelper имеет ряд методов.
   • replace(): вызывает методы split() и join() класса String, чтобы удалить подстроку строки, переданную с новой подстрокой.
   • trim(): вызывает одновременно методы trimBack() и trimFront() с помощью переданных строк и возвращает обновленную строку.
   • trimFront(): рекурсивно удаляет все символы, которые совпадают с параметром char, начиная с переднего конца строки назад вплоть до первого символа в строке, не совпадающего с параметром char, и возвращает обновленную строку.
   • trimBack(): рекурсивно удаляет все символы, которые совпадают с параметром char, начиная с заднего конца строки вперед вплоть до последнего символа в строке, не совпадающего с параметром char и возвращает обновленную строку.
   • stringToCharacter(): возвращает первый символ переданной строки.
3. Затем создаются три строки с помощью объявленных строковых переменных с вызовом метода replace(), использованного для создания второй строки, и метода trim() для создания третьей строки.

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);
    }
}