Глава 3.9. Строки: встроенный объект String(часть3) 

Метод replace

Синтаксис: объект.replace(регвыр,строка)  объект.replace(регвыр,функция)Аргументы: регвыр — регулярное выражение  строка — строковое выражение  функция — имя функции или декларация функцииРезультат: новая строка

Метод replace сопоставляет регулярное выражение регвыр с примитивным  значением строкового объекта и заменяет найденные подстроки другими подстроками. Результатом  является новая строка, которая является копией исходной строки с проведенными заменами. Способ  замены определяется опцией глобального поиска в регвыр  и типом второго аргумента.

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

Если вторым аргументом является строка, то замена каждой найденной подстроки производится  на нее. При этом строка может содержать такие свойства объекта RegExp,  как $1, …, $9,  lastMatch, lastParen,  leftContext и rightContext.  Например, оператор document.write("Вкусные яблоки, сочные яблоки.".replace(/яблоки/g,  "груши")) выведет на экран обозревателя строку Вкусные груши, сочные  груши.

Если вторым аргументом является функция, то замена каждой найденной подстроки производится  вызовом этой функции. Функция имеет следующие аргументы. Первый аргумент — это найденная  подстрока, затем следуют аргументы, соответствующие всем подвыражениям регвыр, заключенным  в круглые скобки, предпоследний аргумент — это позиция найденной подстроки в исходной  строке, считая с нуля, и последний аргумент— это сама исходная строка. Следующий пример  показывает, как с помощью метода replace можно написать функцию преобразования  градусов Фаренгейта в градусы Цельсия. Приведенный сценарий

function myfunc($0,$1) {  return (($1-32) * 5 / 9) + "C";}function f2c(x) {  var s = String(x);  return s.replace(/(\d+(\.\d*)?)F\b/, myfunc);}document.write(f2c("212F"));

выведет на экран обозревателя строку 100C.

Следует помнить, что этот метод изменяет свойства объекта регвыр.

Метод search

Синтаксис: объект.search(регвыр)Аргументы: регвыр — любое регулярное выражениеРезультат: числовое выражение

Метод search сопоставляет регулярное выражение регвыр с примитивным  значением строкового объекта. Результатом сопоставления является позиция первой найденной  подстроки, считая с нуля, или -1, если соответствий нет. При этом опция  глобального поиска в регвыр игнорируется, и свойства регвыр не изменяются.  Примеры:

var src = "Он сказал: <I>Я ухожу</I> и добавил: <I>До свидания</I>.";var n = src.search(/<i>.*?<\/i>/i); // n равно 11

Метод slice

Синтаксис: объект.slice(начало [,конец]?)Аргументы: начало и конец — любые числовые выраженияРезультат: новая строка

Метод slice возвращает подстроку примитивного значения строкового объекта,  от позиции начало до позиции конец, не включая ее. Если конец не  задан, то возвращается подстрока, начиная с позиции начало и до конца исходной строки.

Позиции символов строки нумеруются от нуля до объект.length-1.  Если значение начало отрицательно, то оно заменяется на объект.length+начало.  Если значение конец отрицательно, то оно заменяется на объект.length+конец.  Иными словами, отрицательные аргументы трактуются как смещения от конца строки.

Результатом является строковое значение, а не строковый объект. Например, оператор document.write("ABCDEF".slice(2,-1)) выведет на экран  обозревателя строку CDE.

Метод small

Синтаксис: объект.small()Результат: строковое значение

Метод small возвращает строку, состоящую из примитивного значения строкового  объекта, заключенного в теги <SMALL>…</SMALL>.  Проверки на то, не была ли исходная строка уже заключена в эти теги, не делается. Этот метод  используется совместно с методами document.write и document.writeln для отображения  текста мелким шрифтом. Например, оператор document.write("Мой  текст".small()) выведет на экран обозревателя строку Мой текст.

Метод split

Синтаксис: объект.split(разделитель [,число]?)Аргументы: разделитель — строковое или регулярное выражение  число — числовое выражениеРезультат: массив строк (объект Array)

Метод split разбивает примитивное значение объекта на массив подстрок  и возвращает его. Разбиение на подстроки производится следующим образом. Исходная строка просматривается  слева направо в поисках разделителя. Как только он найден, подстрока от конца предыдущего  разделителя (или от начала строки, если это первое вхождение разделителя) до начала найденного  добавляется в массив подстрок. Таким образом, сам разделитель в текст подстроки не попадает.

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

Разделитель может быть задан либо строкой, либо регулярным выражением. Существует  несколько случаев, требующих особого рассмотрения:

 
• Если разделитель не задан, то результирующий массив состоит из одного элемента,  равного исходной строке.
 
• Если разделитель — пустая строка или регулярное выражение, соответствующее  пустой строке, то результирующий массив состоит из объект.length  элементов, каждый из которых содержит один символ исходной строки.
 
• Если разделитель — регулярное выражение, то очередная подстрока выделяется  всякий раз, когда нашлось соответствие регулярному выражению, и соответствующая подстрока  служит разделителем. Например, оператор var s = "a1b2c3d".split(/\d/);  вернет массив ["a", "b", "c", "d"].
 

В следующем примере регулярное выражение используется для задания тегов  HTML в качестве разделителя. Оператор

document.write("Текст <B>полужирный</B> и <EM>курсивный</EM>".split(/<\/?([^<>]+)>/));

выведет на экран обозревателя строку Текст ,полужирный, и ,курсивный.

Метод strike

Синтаксис: объект.strike()Результат: строковое значение

Метод strike возвращает строку, состоящую из примитивного значения строкового  объекта, заключенного в теги <STRIKE>…</STRIKE>.  Проверки на то, не была ли исходная строка уже заключена в эти теги, не делается. Этот метод  используется совместно с методами document.write и document.writeln для отображения  текста перечеркнутым шрифтом. Например, оператор document.write("Мой текст".strike())  выведет на экран обозревателя строку Мой текст.

Метод sub

Синтаксис: объект.sub()Результат: строковое значение

Метод sub возвращает строку, состоящую из примитивного значения строкового  объекта, заключенного в теги <SUB>…</SUB>.  Проверки на то, не была ли исходная строка уже заключена в эти теги, не делается. Этот метод  используется совместно с методами document.write и document.writeln для отображения  текста как нижнего индекса. Например, оператор document.write("Мой  текст".sub()) выведет на экран обозревателя строку _{Мой текст}.

Метод substr

Синтаксис: объект.substr(позиция [,длина]?)Аргументы: позиция и длина — числовые выраженияРезультат: строковое значение

Метод substr возвращает подстроку примитивного значения строкового объекта,  начинающуюся с данной позиции и содержащую длина символов. Если длина  не задана, то возвращается подстрока, начиная с данной позиции и до конца исходной  строки. Если длина отрицательна или равна нулю, то возвращается пустая строка.

Позиции символов строки нумеруются от нуля до объект.length-1.  Если позиция больше или равна объект.length,  то возвращается пустая строка. Если позиция отрицательна, то она трактуется как смещение  от конца строки, т. е. заменяется на объект.length+позиция.

Примечание. Если позиция отрицательна, то Internet Explorer  ошибочно заменяет ее на 0, поэтому в целях совместимости этот вариант использовать не следует.

Результатом является строковое значение, а не строковый объект. Примеры:

var src = "abcdef";var s1 = src.substr(1, 3); // "bcd"var s2 = src.substr(1); // "bcdef"var s3 = src.substr(-1); // "f", но в MSIE: "abcdef"

Метод substring

Синтаксис: объект.substring(начало [,конец])Аргументы: начало и конец — числовые выраженияРезультат: строковое значение

Метод substring возвращает подстроку примитивного значения строкового объекта,  от позиции начало до позиции конец, не включая ее. Если конец не  задан, то возвращается подстрока, начиная с позиции начало и до конца исходной строки.

Позиции символов строки нумеруются от нуля до объект.length-1.  Отрицательные аргументы или равные NaN заменяются  на нуль; если аргумент больше длины исходной строки, то он заменяется на нее. Если начало  больше конца, то они меняются местами. Если начало равно концу, то  возвращается пустая строка.

Результатом является строковое значение, а не строковый объект. Примеры:

var src = "abcdef";var s1 = src.substring(1, 3); // "bc"var s2 = src.substring(1, -1); // "a"var s3 = src.substring(-1, 1); // "a"

Метод sup

Синтаксис: объект.sup()Результат: строковое значение

Метод sup возвращает строку, состоящую из примитивного значения строкового  объекта, заключенного в теги <SUP>…</SUP>.  Проверки на то, не была ли исходная строка уже заключена в эти теги, не делается. Этот метод  используется совместно с методами document.write и document.writeln для отображения  текста как верхнего индекса. Например, оператор document.write("Мой  текст".sup()) выведет на экран обозревателя строку ^{Мой текст}.

Метод toLocaleLowerCase

Синтаксис: объект.toLocaleLowerCase()Результат: новая строка

Поддержка:  Поддерживается с версии 5.5.   Не поддерживается.

Метод toLocaleLowerCase возвращает новую строку, в которой все буквы исходной  строки заменены на строчные с учетом национальных установок операционной системы. Остальные  символы исходной строки не изменяются. Исходная строка остается прежней. Обычно этот метод возвращает  тот же результат, что и toLowerCase; отличие возможно  только в том случае, если кодировка языка противоречит правилам Unicode по преобразованию прописных  букв в строчные.

Метод toLocaleUpperCase

Синтаксис: объект.toLocaleUpperCase()Результат: новая строка

Поддержка:  Поддерживается с версии 5.5.   Не поддерживается.

Метод toLocaleUpperCase возвращает новую строку, в которой все буквы исходной  строки заменены на прописные с учетом национальных установок операционной системы. Остальные  символы исходной строки не изменяются. Исходная строка остается прежней. Обычно этот метод возвращает  тот же результат, что и toUpperCase; отличие возможно  только в том случае, если кодировка языка противоречит правилам Unicode по преобразованию строчных  букв в прописные.

Метод toLowerCase

Синтаксис: объект.toLowerCase()Результат: новая строка

Метод toLowerCase возвращает новую строку, в которой все буквы исходной строки  заменены на строчные. Остальные символы исходной строки не изменяются. Исходная строка остается  прежней. Например, оператор document.write("объект String".toUpperCase())  выведет на экран обозревателя строку объект string.

Метод toString

Синтаксис: объект.toString()Результат: строковое значение

Метод toString возвращает примитивное значение строкового объекта.

Метод toUpperCase

Синтаксис: объект.toUpperCase()Результат: новая строка

Метод toUpperCase возвращает новую строку, в которой все буквы исходной строки  заменены на прописные. Остальные символы исходной строки не изменяются. Исходная строка остается  прежней. Например, оператор document.write("объект String".toUpperCase())  выведет на экран обозревателя строку ОБЪЕКТ STRING.

Метод valueOf

Синтаксис: объект.valueOf()Результат: строковое значение

Метод valueOf возвращает примитивное значение строкового объекта.