[Содержание] [Предыдущая] [Следующая] [Индекс]

String

Объект, представляющий ряд символов в строке.

Основной Объект
Реализовано в Navigator 2.0: Создает объект String только цитируя символы.
Navigator 3.0, LiveWire 1.0: добавлен конструктор String; добавлено свойство prototype; добавлен метод split; добавлена способность передавать строки между сценариями в различных окнах или рамках (в предыдущих выпусках, Вы должны были добавлять пустую строку к строке другого окна, чтобы обратиться к строке)
Navigator 4.0, Netscape Server 3.0: добавлены методы concat, match, replace, search, slice и substr.

Создание

Конструктором String:

new String(string);

Резюме Методов

Примеры

Пример 1: Строковая переменная. Следующее выражение создает строковую переменную:

var last_name = "Schaefer"

Пример 2: Свойства объекта String. Следующие выражения оценивется к 8, "SCHAEFER" и "schaefer":

last_name.length
last_name.toUpperCase()
last_name.toLowerCase()

Пример 3: Доступ к индивидуальным символам в строке. Вы можете думать о строке как о массиве символов. Таким образом, Вы можете обращаться к индивидуальным символам в строке, индексируя этот массив. Например, следующий код:

var myString = "Привет"
document.write ("Первый символ в строке это " + myString[0])

показывает "Первый символ в строке это П"

Пример 4: Передача строки между сценариями в различных окнах или рамках. Следующий код создает две строковые переменные и открывает второе окно:

var lastName = new String("Schaefer")
var firstName = new String ("Jesse")
empWindow=window.open('string2.html','window1','width=300,height=300')

Если источник HTML для второго окна (string2.html) создает две строковые переменные, empLastName и empFirstName, следующий код в первом окне присваивает значения переменным во втором окне:

empWindow.empFirstName=firstName
empWindow.empLastName=lastName

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

alert('empFirstName в empWindow равна ' + empWindow.empFirstName)
alert('empLastName в empWindow равна ' + empWindow.empLastName)

Свойства

length

Длина строки.

Свойство объекта String
Только для чтения
Реализовано в Navigator 2.0, LiveWire 1.0

Примеры

Следующий пример показывает 8 в диалоговом окне Alert:

var x="Netscape"
alert("Длина строки равна " + x.length)

prototype

Представляет прототип для этого класса. Вы можете использовать прототип, чтобы добавлять свойства или методы ко всем образцам класса. Для информации о прототипах, смотрите Function.prototype.

Свойство объекта String
Реализовано в Navigator 3.0, Netscape Server 3.0

anchor

Создает якорь HTML, который используется как адресат гипертекста.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

anchor(nameAttribute)

Параметры

nameAttribute
Строка.

Используйте метод anchor с методами document.write или document.writeln, чтобы программно создавать и отображать якорь в документе. Создайте якорь методом anchor, и затем вызовите write или writeln, чтобы отобразить якорь в документе. В server-side JavaScript, используйте функцию write для отображения якоря.

В синтаксисе, строка text представляет литеральный текст, который Вы хотите, чтобы пользователь видел. Строка nameAttribute представляет атрибут NAME тэга A.

Якоря, созданные методом anchor, добавляются в массив document.anchors.

Примеры

Следующий пример открывает окно msgWindow и создает якорь для оглавления:

var myString="Оглавление"
msgWindow.document.writeln(myString.anchor("contents_anchor"))

Предыдущий пример производит тот же самый вывод, что и следующий код HTML:

<A NAME="contents_anchor">Оглавление</A>

В server-side JavaScript, Вы можете генерировать HTML, вызывая функцию write вместо использования document.writeln.

Смотрите также

String.link

big

Заставляет строку отображаться большим шрифтом, как будто внутри тэга BIG.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

big()

Параметры

Нет.

Описание

Используйте метод big с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует методы объекта String для изменения размера строки:

var worldString="Привет, мир"

document.write(worldString.small())
document.write("<P>" + worldString.big())
document.write("<P>" + worldString.fontsize(7))

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<SMALL>Привет, мир</SMALL>
<P><BIG>Привет, мир</BIG>
<P><FONTSIZE=7>Привет, мир</FONTSIZE>

Смотрите также

String.fontsize, String.small

blink

Заставляет строку мигать, как будто внутри тэга BLINK.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

blink()

Параметры

Нет.

Описание

Используйте метод blink с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует методы объекта String для изменения форматирования строки:

var worldString="Привет, мир"

document.write(worldString.blink())
document.write("<P>" + worldString.bold())
document.write("<P>" + worldString.italics())
document.write("<P>" + worldString.strike())

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<BLINK>Привет, мир</BLINK>
<P><B>Привет, мир</B>
<P><I>Привет, мир</I>
<P><STRIKE>Привет, мир</STRIKE>

bold

Заставляет строку отображаться полужирным шрифтом, как будто внутри тэга B.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

bold()

Параметры

Нет.

Описание

Используйте метод bold с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует методы объекта String для изменения форматирования строки:

var worldString="Привет, мир" 
document.write(worldString.blink())
document.write("<P>" + worldString.bold())
document.write("<P>" + worldString.italics())
document.write("<P>" + worldString.strike())

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<BLINK>Привет, мир</BLINK>
<P><B>Привет, мир</B>
<P><I>Привет, мир</I>
<P><STRIKE>Привет, мир</STRIKE>

charAt

Возвращает определенный символ из строки.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

charAt(index)

Параметры

index
Целое число от 0 до длины строки минус 1.

Описание

Символы в строке индексируются слева направо. Индекс первого символа - 0, и индекс последнего символа в строке с именем stringName равен stringName.length - 1. Если Вы указываете index вне диапазона, JavaScript возвращает пустую строку.

Примеры

Следующий пример показывает символы в различных местах строки "Brave new world":

var anyString="Brave new world"

document.writeln("Символ с индексом 0 равен " + anyString.charAt(0))
document.writeln("Символ с индексом 1 равен " + anyString.charAt(1))
document.writeln("Символ с индексом 2 равен " + anyString.charAt(2))
document.writeln("Символ с индексом 3 равен " + anyString.charAt(3))
document.writeln("Символ с индексом 4 равен " + anyString.charAt(4))

Эти строки отображают следующее:

Символ с индексом 0 равен B
Символ с индексом 1 равен r
Символ с индексом 2 равен a
Символ с индексом 3 равен v
Символ с индексом 4 равен e

В server-side JavaScript, Вы можетете делать тот же самый вывод, вызывая функцию write вместо использования document.write.

charCodeAt

Возвращает число, указывающее ISO-Latin-1 значение кодировки символа в данном индексе.

Метод объекта String
Реализовано в Navigator 4.0, Netscape Server 3.0

Синтаксис

charCodeAt(index)

Параметры

index
(Факультативный) Целое число от 0 до длины строки минус 1. Значение по умолчанию - 0.

Описание

ISO-Latin-1 кодировка располагается от 0 до 255. От 0 до 127 имеет прямое соответствие с набором символов ASCII.

Пример

Следующий пример возвращает 65, ISO-Latin-1 кодировка для английской A.

"ABC".charCodeAt(0)

concat

Объединяет текст двух строк и возвращает новую строку.

Метод объекта String
Реализовано в Navigator 4.0, Netscape Server 3.0

Синтаксис

concat(string2)

Параметры

string1
Первая строка.

string2
Вторая строка.

Описание

concat объединяет текст из двух строк и возвращает новую строку. Изменения текста в одной строке не воздействуют на другую строку.

Пример

Следующий пример объединяет две строки в новую строку.

<SCRIPT>
str1="The morning is upon us. "
str2="The sun is bright."
str3=str1.concat(str2)
document.writeln(str1)
document.writeln(str2)
document.writeln(str3)
</SCRIPT>

Это записывает:

The morning is upon us.
The sun is bright.
The morning is upon us. The sun is bright.

fixed

Заставляет строку отображаться моноширным шрифтом, как будто в тэге TT.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

fixed()

Параметры

Нет.

Описание

Используйте метод fixed с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует мотод fixed для изменения форматирования строки:

var worldString="Привет, мир"
document.write(worldString.fixed())

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<TT>Привет, мир</TT>

fontcolor

Заставляет строку отображаться определенным цветом, как будто в тэге <FONT COLOR=color>.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

fontcolor(color)

Параметры

color
Строка, отражающая цвет в шестнадцатеричном RGB формате или как строковый литерал. Строковые литералы для цветовых имен перечислены в Приложение B, "Color Values," в Руководстве по JavaScript.

Описание

Используйте метод fontcolor с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используй тефункцию write для отображения строки.

Если Вы представляете color как шестнадцатиричное RGB значение, Вы должны использовать формат rrggbb. Например, шестнадцатиричное RGB значение для оранжево-розового red=FA, green=80 и blue=72, так RGB значение для salmon равно "FA8072".

Метод fontcolor отменяет набор значений fgColor.

Примеры

Следующий пример использует метод fontcolor для изменения цвета строки:

var worldString="Привет, мир"

document.write(worldString.fontcolor("maroon") +
   " является maroon в этой строке")
document.write("<P>" + worldString.fontcolor("salmon") +
   " является оранжево-розовым в этой строке")
document.write("<P>" + worldString.fontcolor("red") +
   " является красным в этой строке")

document.write("<P>" + worldString.fontcolor("8000") +
   " является maroon в шестнадцатиричном значении в этой строке")
document.write("<P>" + worldString.fontcolor("FA8072") +
   " является оранжево-розовым в шестнадцатиричном значении в этой строке")
document.write("<P>" + worldString.fontcolor("FF00") +
   " является красным в шестнадцатиричном значении в этой строке")

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<FONT COLOR="maroon">Привет, мир</FONT> является maroon в этой строке
<P><FONT COLOR="salmon">Привет, мир</FONT> является оранжево-розовым в этой строке
<P><FONT COLOR="red">Привет, мир</FONT> является красным в этой строке

<FONT COLOR="8000">Привет, мир</FONT> 
является maroon в шестнадцатиричном значении в этой строке
<P><FONT COLOR="FA8072">Привет, мир</FONT> 
является оранжево-розовым в шестнадцатиричном значении в этой строке
<P><FONT COLOR="FF00">Привет, мир</FONT> 
является красным в шестнадцатиричном значении в этой строке

Используйте метод fontsize с методами write или writeln, чтобы форматировать и отображать строку в документе. В server-side JavaScript, используйте функцию write, чтобы отобразить строку.

Когда Вы определяете size как целое число, Вы устанавливаете размер stringName в одно из 7 определенных размеров. Когда Вы определяете size как строку, такую как "-2", Вы корректируете размер шрифта stringName относительно размера, установленного в тэге BASEFONT.

Примеры

Следующий пример использует методы объекта String для изменения размера строки:

var worldString="Привет, мир"

document.write(worldString.small())
document.write("<P>" + worldString.big())
document.write("<P>" + worldString.fontsize(7))

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<SMALL>Привет, мир</SMALL>
<P><BIG>Привет, мир</BIG>
<P><FONTSIZE=7>Привет, мир</FONTSIZE>

Смотрите также

String.big, String.small

fromCharCode

Возвращает строку, созданную, используя определенную последовательность значений кодировки ISO-Latin-1.

Метод объекта String
Статический
Реализовано в Navigator 4.0, Netscape Server 3.0

Синтаксис

fromCharCode(num1, ..., numN)

Параметры

num1, ..., numN
Последовательность чисел, которые являются значениями кодировки ISO-Latin-1.

Описание

Этот метод возвращает строку, а не объект String.

Так как fromCharCode статический метод String, Вы всегда используете его как String.fromCharCode(), предпочтительнее чем как метод созданного Вами объекта String.

Примеры

Пример 1. Следующий пример возвращает строку "ABC".

String.fromCharCode(65,66,67)

Пример 2. Свойство which событий KeyDown, KeyPress и KeyUp содержит ASCII значение нажатой клавиши, когда событие происходит. Если Вы хотите получить фактический символ, число или символ клавиши, Вы можете использовать fromCharCode. Следующий пример возвращает символ, число или символ клавиши свойства which события KeyPress.

String.fromCharCode(KeyPress.which)

indexOf

Возвращает индекс первого местонахождения заданного значения внутри вызывающего объекта String, начиная поиск с fromIndex, и возвращая -1, если значение не найдено.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

indexOf(searchValue, fromIndex)

Параметры

searchValue
Строка, представляющая искомое значение.

fromIndex
(Факультативный) Индекс внутри вызывающей строки с которого начать поиск. Это может быть любое целое число между 0 и на 1 меньше чем длина строки. Значение по умолчанию - 0.

Описание

Символы в строке индексируются слева направо. Индекс первого символа - 0, и индекс последнего символа строки с именем stringName равен stringName.length - 1.

Если stringName содержит пустую строку (""), indexOf возвращает пустую строку.

Метод indexOf чувствителен к регистру. Например, следующе выражение возвращает -1:

"Blue Whale".indexOf("blue")

Примеры

Пример 1. Следующий пример использует indexOf и lastIndexOf для нахождения значения в строке "Brave new world."

var anyString="Brave new world"

//Выводит 8
document.write("<P>Индекс первого w с начала равен " +
   anyString.indexOf("w"))
//Выводит 10
document.write("<P>Индекс первого w с конца равен " +
   anyString.lastIndexOf("w"))
//Выводит 6
document.write("<P>Индекс 'new' с начала равен " +
   anyString.indexOf("new"))
//Выводит 6
document.write("<P>Индекс 'new' с конца равен " +
   anyString.lastIndexOf("new"))

Пример 2. Следующий пример определяет две строковые переменные. Переменные содержат одну и туже строку за исключением того, что вторая строка содержит прописные буквы. Первый метод writeln отображает 19. Но так как метод indexOf чувствителен к регистру, строка "cheddar" не будет найдена в myCapString, по эутому второй метод writeln выводит -1.

myString="brie, pepper jack, cheddar"
myCapString="Brie, Pepper Jack, Cheddar"
document.writeln('myString.indexOf("cheddar") is ' +
   myString.indexOf("cheddar"))
document.writeln('<P>myCapString.indexOf("cheddar") is ' +
   myCapString.indexOf("cheddar"))

Пример 3. Следующий пример устанавливает count в количество местонахождений символа x в строке str:

count = 0;
pos = str.indexOf("x");
while ( pos != -1 ) {
   count++;
   pos = str.indexOf("x",pos+1);
}

italics

Заставляет строку отображаться курсивным шрифтом, как будто внутри тэга I.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

italics()

Параметры

Нет.

Описание

Используйте метод italics с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует методы объекта String для изменения форматирования строки:

var worldString="Привет, мир"

document.write(worldString.blink())
document.write("<P>" + worldString.bold())
document.write("<P>" + worldString.italics())
document.write("<P>" + worldString.strike())

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<BLINK>Привет, мир</BLINK>
<P><B>Привет, мир</B>
<P><I>Привет, мир</I>
<P><STRIKE>Привет, мир</STRIKE>

lastIndexOf

Возвращает индекс последнего местонахождения заданного значения внутри вызывающего объекта String. Вызывающая строка ищет с конца, начиная с fromIndex, и возвращает -1, если ничего не находит.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

lastIndexOf(searchValue, fromIndex)

Параметры

searchValue
Строка, представляющая искомое значение.

fromIndex
(Факультативный) Индекс внутри вызывающей строки, с которого начать поиск. Это может быть любое целое число между 0 и на 1 меньше чем длина строки. Значение по умолчанию на 1 меньше чем длина строки.

Описание

Символы в строке индексируются слева направо. Индекс первого символа равен 0, и индекс последнего символа stringName.length - 1.

Метод lastIndexOf чувствителен к регистру. Например, следующее выражение возвращает -1:

"Blue Whale, Killer Whale".lastIndexOf("blue")

Примеры

Следующий пример использует indexOf и lastIndexOf для нахождения значения в строке "Brave new world."

var anyString="Brave new world"

//Выводит 8
document.write("<P>Индекс первого w с начала равен " +
   anyString.indexOf("w"))
//Выводит 10
document.write("<P>Индекс первого w с конца равен " +
   anyString.lastIndexOf("w"))
//Выводит 6
document.write("<P>Индекс 'new' с начала равен " +
   anyString.indexOf("new"))
//Выводит 6
document.write("<P>Индекс 'new' с конца равен " +
   anyString.lastIndexOf("new"))

В server-side JavaScript, Вы можете делать тот же самый вывод, вызывая функцию write вместо использования document.write.

link

Создает гипертекстовую ссылку HTML, которая запрашивает URL.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

link(hrefAttribute)

Параметры

hrefAttribute
Любая строка, определяющая атрибут HREF тэга A; это должен быть допустимый URL (относительный или абсолютный).

Описание

Используйте метод link, чтобы программно создать гипертекстовую ссылку, и затем вызвать write или writeln, чтобы показать ссылку в документе. В server-side JavaScript, используйте функцию write для отображения ссылки.

Ссылки, созданные методом link, становятся элементами массива links объекта document. Смотрите document.links.

Примеры

Следующий пример показывает слово "Netscape" как гипертекстовую ссылку, которая направляет пользователя к домашней странице Netscape:

var hotText="Netscape"
var URL="http://home.netscape.com"

document.write("Нажмите чтобы перейти к " + hotText.link(URL))

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

Нажмите чтобы перейти к <A HREF="http://home.netscape.com">Netscape</A>

Смотрите также

Anchor

match

Используется, чтобы согласовать регулярное выражение со строкой.

Метод объекта String
Реализовано в Navigator 4.0

Синтаксис

match(regexp)

Параметры

regexp
Имя регулярного выражения. Это может быть имя переменной или литерал.

Описание

Если Вы хотите выполнить глобальное соответствие, или нечувствительное к регистру соответствие, включите g (для глобального) и i (для игнорирования регистра) флаги в регулярное выражение. Они могут быть включены отдельно или вместе. Следующие два примера ниже показывают, как использовать эти флаги с match.

Обратите внимание

Если Вы выполняете соответствие просто, чтобы получить true или false, используйте String.search или регулярное выражение метода test.

Примеры

Пример 1. В следующем примере, match используется, чтобы найти строку 'Chapter' и следующих за ней одной или более цифр, сопровождаемых десятичной точкой и цифрой ноль или болшим количеством раз. Регулярное выражение включает флаг i, по этому регистр игнорируется.

<SCRIPT> 
str = "Для подробной информации, смотрите Chapter 3.4.5.1";
re = /(chapter \d+(\.\d)*)/i; 
found = str.match(re); 
document.write(found); 
</SCRIPT>

Этот возвращенный массив содержит Chapter 3.4.5.1, .1

'Chapter 3.4.5.1' первое соответствие и первое значение взятое из (Chapter \d+(\.\d)*).

'.1' второе значение взятое из (\.\d).

Пример 2. Следующий пример показывает использование глобального и игнорирующего регистр флагов с match.

<SCRIPT> 
str = "abcDdcba"; 
newArray = str.match(/d/gi); 
document.write(newArray); 
</SCRIPT>

Возвращенный массив содержит D, d.

replace

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

Метод объекта String
Реализовано в Navigator 4.0

Синтаксис

replace(regexp, newSubStr)

Параметры

regexp
Имя регулярного выражения. Это может быть имя переменной или литерал.

newSubStr
Строка, чтобы поместить вместо строки, найденной с regexp. Эта строка может включать свойства объекта RegExp -- $1, ..., $9, lastMatch, lastParen, leftContext и rightContext.

Описание

Этот метод не изменяет объект String, который вызвал его; он просто возвращает новую строку.

Если Вы хотите выполнить глобальный поиск и замену, или нечувствительный к регистру поиск, включите флаги g (для глобального) и i (для игнорирования регистра) в регулярное выражение. Они могут быть включены отдельно или вместе. Следующие два примера ниже показывают, как использовать эти флаги с replace.

Примеры

Пример 1. В следующем примере, регулярное выражение включает глобальный и игнорирующий регистр флаги, которое позволяет replace заменить каждое вхождение 'apples' на строку 'oranges.'

<SCRIPT>
re = /apples/gi;
str = "Apples are round, and apples are juicy.";
newstr=str.replace(re, "oranges");
document.write(newstr)
</SCRIPT>

Это печатает "oranges are round, and oranges are juicy."

Пример 2. В следующем примере, регулярное выражение определено в replace и включает флаг игнорирования регистра.

<SCRIPT>
str = "Twas the night before Xmas...";
newstr=str.replace(/xmas/i, "Christmas");
document.write(newstr)
</SCRIPT>

Это печатает "Twas the night before Christmas..."

Пример 3. Следующий сценарий включает слова в строку. Для заменяемого текста, сценарий использует значения свойств $1 и $2.

<SCRIPT LANGUAGE="JavaScript1.2">
re = /(\w+)\s(\w+)/;
str = "John Smith";
newstr = str.replace(re, "$2, $1");
document.write(newstr)
</SCRIPT>

Это печатает "Smith, John".

search

Выполняет поиск соответствия между регулярным выражением и этим объектом String.

Метод объекта String
Реализовано в Navigator 4.0

Синтаксис

search(regexp)

Параметры

regexp
Имя регулярного выражения. Это может быть имя переменной или литерал.

Описание

В случае успеха search возвращает индекс регулярного выражения внутри строки. Иначе, возвращает -1.

Когда Вы хотите знать, найден ли образец в строке использующей search (подобно регулярному выражению метода test); Для подробной информации (но более медленное выполнения) используйте match (подобно регулярному выражению метода exec).

Пример

Следующий пример печатает сообщение, которое зависит от успеха теста.

function testinput(re, str){
   if (str.search(re) != -1)
      midstring = " содержит ";
   else 
      midstring = " несодержит ";
   document.write (str + midstring + re.source);
}

slice

Извлекает часть строки и возвращает новую строку.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

slice(beginslice,endSlice)

Параметры

beginSlice
Нуль-основанный индекс, с которого начинать извлечение.

endSlice
(Факультативный) Нуль-основанный индекс, на котором заканчивать извлечение. Если опущен, slice извлекает до конца строки.

Описание

slice извлекает текст из одной строки и возвращает новую строку. Изменения текста в одной строке не воздействуют на другую строку.

slice извлекает до но не включая endSlice. string.slice(1,4) извлекает со второго до четвертого символа (символы с индексами 1, 2 и 3).

Как отрицательный индекс, endSlice указывает смещение с конца строки. string.slice(2,-1) извлекает с третьего по второй символ с конца строки.

Пример

Следующий пример использует slice для создания новой строки.

<SCRIPT>
str1="The morning is upon us. "
str2=str1.slice(3,-5)
document.write(str2)
</SCRIPT>

Это записывает:

morning is upon

small

Заставляет строку отображаться малым шрифтом, как будто внутри тэга SMALL.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

small()

Параметры

Нет.

Описание

Используйте метод small с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует методы объекта string для изменения размера строки:

var worldString="Привет, мир"

document.write(worldString.small())
document.write("<P>" + worldString.big())
document.write("<P>" + worldString.fontsize(7))

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<SMALL>Привет, мир</SMALL>
<P><BIG>Привет, мир</BIG>
<P><FONTSIZE=7>Привет, мир</FONTSIZE>

Смотрите также

String.big, String.fontsize

split

Разделяет объект String на массив строк, разделяя строку на подстроки.

Метод объекта String
Реализовано в Navigator 3.0, LiveWire 1.0

Синтаксис

split(separator, limit)

Параметры

separator
(Факультативный) Определяет символ, который использовать для разделения строк. separator обрабатывается как строка. Если separator опущен, возвращенный массив содержит один элемент, состоящий из всей строки.

limit
(Факультативный) Целое число, определяющее ограничение числа разделителей, которые будут найдены.

Описание

Метод split вовращает новый массив.

Когда найден, separator удаляется из строки, и подстроки добавляются в массив. Если separator опущен, массив содержит один элемент, состоящий из всей строки.

В Navigator 4.0, Split имеет следующие дополнения:

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

Может потребоваться ограничительный счетчик, чтобы включать конечные пустые элементы в возникающий в результате массив.

Если Вы определяете LANGUAGE="JavaScript1.2" в тэге SCRIPT, в string.split(" ") разделителем будет любое количество символов незаполненного пространства, включая пробелы, символы табуляции, перевод строки и возврат каретки.

Примеры

Пример 1. Следующий пример определяет функцию, которая разделяет строку на массив строк, используя определенный разделитель. После разделения строки, функция показывает сообщения, указывающие оригинальную строку (перед разбиением), используемый разделитель, число элементов в массиве и каждый элемент массива.

function splitString (stringToSplit,separator) {
   arrayOfStrings = stringToSplit.split(separator)
   document.write ('<P>The original string is: "' + stringToSplit + '"')
   document.write ('<BR>The separator is: "' + separator + '"')
   document.write ("<BR>The array has " + arrayOfStrings.length + " elements: ")

   for (var i=0; i < arrayOfStrings.length; i++) {
      document.write (arrayOfStrings[i] + " / ")
   }
}

var tempestString="Oh brave new world that has such people in it."
var monthString="Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"

var space=" "
var comma=","

splitString(tempestString,space)
splitString(tempestString)
splitString(monthString,comma)

Этот пример производит следующий вывод:

The original string is: "Oh brave new world that has such people in it."
The separator is: " "
The array has 10 elements: Oh / brave / new / world / that / has / such / people / in / it. /

The original string is: "Oh brave new world that has such people in it."
The separator is: "undefined"
The array has 1 elements: Oh brave new world that has such people in it. /

The original string is: "Jan,Feb,Mar,Apr,May,Jun,Jul,Aug,Sep,Oct,Nov,Dec"
The separator is: ","
The array has 12 elements: Jan / Feb / Mar / Apr / May / Jun / Jul / Aug / Sep / Oct / Nov / Dec /

Пример 2. Рассмотрите следующий сценарий:

<SCRIPT LANGUAGE="JavaScript1.2"> 
str="She sells    seashells \nby   the\n seashore"
document.write(str + "<BR>")
a=str.split(" ")
document.write(a)
</SCRIPT>

С использованием LANGUAGE="JavaScript1.2", этот сценарий производит

"She", "sells", "seashells", "by", "the", "seashore"

Без LANGUAGE="JavaScript1.2", этот сценарий разделяет только одиночными пробелами, создает

"She", "sells", , , , "seashells", "by", , , "the", "seashore"

Пример 3. В следующем примере, split ищет 0 или большее количество пробелов, сопровождаемых точкой с запятой, сопровождаемых 0 или большим количеством пробелов и, когда находит, удаляет пробелы из строки. nameList массив, возвращенный в результате работы split.

<SCRIPT>
names = "Harry  Trump  ;Fred Barney; Helen   Rigby ;  Bill Abel ;Chris Hand ";
document.write (names + "<BR>" + "<BR>");
re = /\s*;\s*/;
nameList = names.split (re);
document.write(nameList);
</SCRIPT>

Это печатает две строки; первая строка печатает первоначальную строку, и вторая строка печатает возникающий в результате массив.

Harry Trump ;Fred Barney; Helen Rigby ; Bill Abel ;Chris Hand
Harry Trump,Fred Barney,Helen Rigby,Bill Abel,Chris Hand

Пример 4. В следующем примере, split ищет 0 или более пробелов в строке и возвращает первые 3 разделителя, которые находит.

<SCRIPT LANGUAGE="JavaScript1.2">
myVar = "  Hello World. How are you doing?    ";
splits = myVar.split(" ", 3);
document.write(splits)
</SCRIPT>

Этот сценарий показывает следующее:

["Hello", "World.", "How"]

strike

Заставляет строку отображаться как перечеркнутый текст, как будто внутри тэга STRIKE.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

strike()

Параметры

Нет.

Описание

Используйте мотод strike с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для отображения строки.

Примеры

Следующий пример использует методы объекта string для изменения формата строки:

var worldString="Привет, мир"

document.write(worldString.blink())
document.write("<P>" + worldString.bold())
document.write("<P>" + worldString.italics())
document.write("<P>" + worldString.strike())

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

<BLINK>Привет, мир</BLINK>
<P><B>Привет, мир</B>
<P><I>Привет, мир</I>
<P><STRIKE>Привет, мир</STRIKE>

sub

Заставляет строку отображаться как нижний индекс, как будто внутри тэга SUB.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

sub()

Параметры

Нет.

Описание

Используйте метод sub с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, используйте функцию write для генерирования HTML.

Примеры

Следующий пример использует методы sub и sup для форматирования строки:

var superText="superscript"
var subText="subscript"

document.write("This is what a " + superText.sup() + " looks like.")
document.write("<P>This is what a " + subText.sub() + " looks like.")

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

This is what a <SUP>superscript</SUP> looks like.
<P>This is what a <SUB>subscript</SUB> looks like.

Смотрите также

String.sup

substr

Возвращает определенное число символов в строке, начиная с определенного индекса.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

substr(start, length)

Параметры

start
Индекс, с которого начинать извлечение символов.

length
(Факультативный) Число извлекаемых символов.

Описание

start символьный индекс. Индекс первого символа равен 0, и индекс последнего символа на 1 меньше чем длина строки. substr начинает извлекать символы с start и извлекает length число символов.

Если start положительный и больше либо равен длине строки, substr не возвращает символов.

Если start отрицательный, substr использует его как символьный индекс с конца строки. Если start отрицательный и abs(start) больше чем длина строки, substr использует 0 как начальный индекс.

Если length равен 0 или отрицательный, substr не возвращает символов. Если length опущен, start извлекает символы до конца строки.

Пример

Рассмотрите следующий сценарий:

<SCRIPT LANGUAGE="JavaScript1.2">

str = "abcdefghij"
document.writeln("(1,2): ", str.substr(1,2))
document.writeln("(-2,2): ", str.substr(-2,2))
document.writeln("(1): ", str.substr(1))
document.writeln("(-20, 2): ", str.substr(1,20))
document.writeln("(20, 2): ", str.substr(20,2))

</SCRIPT>

Этот сценарий показывает:

(1,2): bc
(-2,2): ij
(1): bcdefghij
(-20, 2): bcdefghij
(20, 2):

Смотрите также

substring

substring

Возвращает подмножество объекта String.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

substring(indexA, indexB)

Параметры

indexA
Целое число между 0 и на 1 меньше чем длина строки.

indexB
Целое число между 0 и на 1 меньше чем длина строки.

Описание

substring извлекает символы из indexA до но не включая indexB. В частности:

Если indexA меньше чем 0, indexA обрабатывается, как будто он равен 0.

Если indexB больше чем stringName.length, indexB обрабатывается, как будто он равен stringName.length.

Если indexA равен indexB, substring возвращает пустую строку.

Если indexB опущен, indexA извлекает символы до конца строки.

Использование LANGUAGE="JavaScript1.2" в тэге SCRIPT,

Если indexA больше indexB, JavaScript производит ошибку времени выполнения (недостаточно памяти).

Без LANGUAGE="JavaScript1.2",

Если indexA больше indexB, JavaScript возвращает подстроку начиная с indexB и заканчивая indexA - 1.

Примеры

Пример 1. Следующий пример использует substring для отображения символов строки "Netscape":

var anyString="Netscape"

//Отображает "Net"
document.write(anyString.substring(0,3))
document.write(anyString.substring(3,0))
//Отображает "cap"
document.write(anyString.substring(4,7))
document.write(anyString.substring(7,4))
//Отображает "Netscap"
document.write(anyString.substring(0,7))
//Отображает "Netscape"
document.write(anyString.substring(0,8))
document.write(anyString.substring(0,10))

Пример 2. Следующий пример заменяет подстроку внутри строки. Он заменяет и индивидуальные символы и подстроки. Обращение к функции в конце примера заменяет строку "Brave New World" на "Brave New Web".

function replaceString(oldS,newS,fullS) {
// Заменяет oldS на newS в строке fullS
   for (var i=0; i<fullS.length; i++) {
      if (fullS.substring(i,i+oldS.length) == oldS) {
         fullS = fullS.substring(0,i)+newS+fullS.substring(i+oldS.length,fullS.length)
      }
   }
   return fullS
}

replaceString("World","Web","Brave New World")

Пример 3. С использованием LANGUAGE="JavaScript1.2", следующий сценарий производит ошибку времени выполнения (недостаточно памяти).

<SCRIPT LANGUAGE="JavaScript1.2">
str="Netscape"
document.write(str.substring(0,3);
document.write(str.substring(3,0);
</SCRIPT>

Без LANGUAGE="JavaScript1.2", вышеупомянутый сценарий печатает

Net Net

Во втором write, индексы меняются.

Смотрите также

substr

sup

Заставляет строку отображаться как верхний индекс, как будто внутри тэга SUP.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

sup()

Параметры

Нет.

Описание

Используйте метод sup с методами write или writeln для форматирования и отображения строки в документе. В server-side JavaScript, испльзуйте функцию write для генерации HTML.

Примеры

Следующий пример использует методы sub и sup для форматирования строки:

var superText="superscript"
var subText="subscript"

document.write("This is what a " + superText.sup() + " looks like.")
document.write("<P>This is what a " + subText.sub() + " looks like.")

Предыдущий пример производит тот же самый вывод, как и следующий код HTML:

This is what a <SUP>superscript</SUP> looks like.
<P>This is what a <SUB>subscript</SUB> looks like.

Смотрите также

String.sub

toLowerCase

Возвращает значение вызывающей строки, преобразованное в нижний регистр.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

toLowerCase()

Параметры

Нет.

Описание

Метод toLowerCase возвращает значение строки, преобразованное в нижний регистр. toLowerCase не воздействует на значение строки непосредственно.

Примеры

Следующий пример показывает строку в нижнем регистре "alphabet":

var upperText="ALPHABET"
document.write(upperText.toLowerCase())

Смотрите также

String.toUpperCase

toUpperCase

Возвращает значение вызывающей строки, преобразованное в верхний регистр.

Метод объекта String
Реализовано в Navigator 2.0, LiveWire 1.0

Синтаксис

toUpperCase()

Параметры

Нет.

Описание

Метод toUpperCase возвращает значение строки, преобразованное в верхний регистр. toUpperCase не воздействует на значение строки непосредственно.

Примеры

Следующий пример отображает строку "ALPHABET":

var lowerText="alphabet"
document.write(lowerText.toUpperCase())

Смотрите также

String.toLowerCase

[Содержание] [Предыдущая] [Следующая] [Индекс]

Последняя Модификация: 10/31/97 12:30:31

Все мессаги сюда:yanich@inbox.ru

`length`	Отражает длину строки.
`prototype`	Позволяет добавлять свойства к объекту `String`.

`anchor`	Создает якорь HTML, который используется как адресат гипертекста.
`big`	Заставляет строку отображаться большим шрифтом, как будто внутри тэга `BIG`.
`blink`	Заставляет строку мигать, как будто внутри тэга `BLINK`.
`bold`	Заставляет строку отображаться, как внутри тэга `B`.
`charAt`	Возвращает символ в определенном индексе.
`charCodeAt`	Возвращает число, указывающее ISO-Latin-1 значение кодировки символа в данном индексе.
`concat`	Объединяет текст двух строк и возвращает новую строку.
`fixed`	Заставляет строку отображаться моноширинным шрифтом, как будто внутри тэга `TT`.
`fontcolor`	Заставляет строку отображаться определенным цветом, как будто внутри тэга `<FONT COLOR=color>`.
`fontsize`	Заставляет строку отображаться с определенным размером шрифта, как будто внутри тэга `<FONT SIZE=size>`.
`fromCharCode`	Возвращает строку из определенной последовательности чисел, которые являются ISO-Latin-1 значениями кодировки.
`indexOf`	Возвращает индекс первого местонахождения заданного значения внутри вызывающего объекта `String`.
`italics`	Заставляет строку быть курсивной, как будто внутри тэга `I`.
`lastIndexOf`	Возвращает индекс последнего местонахождения заданного значения внутри вызывающего объекта `String`.
`link`	Создает гипертекстовую ссылку HTML, которая требует URL.
`match`	Используется, чтобы согласовать регулярное выражение со строкой.
`replace`	Используется, чтобы найти соответствие между регулярным выражением и строкой, и заменить согласованную подстроку на новую подстроку.
`search`	Выполняет поиск соответствия между регулярным выражением и определенной строкой.
`slice`	Извлекает часть строки и возвращает новую строку.
`small`	Заставляет строку отображаться маленьким шрифтом, как будто внутри тэга `SMALL`.
`split`	Разделяет объект `String` на массив строк, разделяя строку на подстроки.
`strike`	Заставляет строку отображаться как перечеркнутый текст, как будто внутри тэга `STRIKE`.
`sub`	Заставляет строку отображаться как нижний индекс, как будто внутри тэга `SUB`.
`substr`	Возвращает определенное количество символов в строке, начиная с определенного индекса.
`substring`	Возвращает символы в строке между двумя индексами в строку.
`sup`	Заставляет строку отображаться как верхний индекс, как будто внутри тэга `SUP`.
`toLowerCase`	Возвращает вызывающее строковое значение, преобразованное в нижний регистр.
`toUpperCase`	Возвращает вызывающее строковое значение, преобразованное в верхний регистр.

Свойство объекта	`String`
Только для чтения
Реализовано в	Navigator 2.0, LiveWire 1.0

Метод объекта	`String`
Реализовано в	Navigator 2.0, LiveWire 1.0

string1	Первая строка.
string2	Вторая строка.

Метод объекта	`String`
Статический
Реализовано в	Navigator 4.0, Netscape Server 3.0

searchValue	Строка, представляющая искомое значение.
fromIndex	(Факультативный) Индекс внутри вызывающей строки с которого начать поиск. Это может быть любое целое число между 0 и на 1 меньше чем длина строки. Значение по умолчанию - 0.

regexp	Имя регулярного выражения. Это может быть имя переменной или литерал.
newSubStr	Строка, чтобы поместить вместо строки, найденной с `regexp`. Эта строка может включать свойства объекта `RegExp` -- `$1, ..., $9`, `lastMatch`, `lastParen`, `leftContext` и `rightContext`.

beginSlice	Нуль-основанный индекс, с которого начинать извлечение.
endSlice	(Факультативный) Нуль-основанный индекс, на котором заканчивать извлечение. Если опущен, `slice` извлекает до конца строки.

separator	(Факультативный) Определяет символ, который использовать для разделения строк. `separator` обрабатывается как строка. Если `separator` опущен, возвращенный массив содержит один элемент, состоящий из всей строки.
limit	(Факультативный) Целое число, определяющее ограничение числа разделителей, которые будут найдены.

start	Индекс, с которого начинать извлечение символов.
length	(Факультативный) Число извлекаемых символов.

indexA	Целое число между 0 и на 1 меньше чем длина строки.
indexB	Целое число между 0 и на 1 меньше чем длина строки.