String | NN 2 IE J1 ECMA 1 | ||||||||||||||
Объект String представляет любую собой последовательность из 0 или большего числа символов, которые должны быть обработаны строго как текст (то есть, никаких математических операций не должны применяться). Большая библиотека методов разделена на две категории. Одна категория окружает строку парой тэгов HTML для форматирования объекта HTML. Эти методы используются прежде всего, чтобы помочь инструкциям, которые используют document.write() динамически создать содержание. Вторая категория методов - более традиционный набор для синтаксического анализа строки и манипуляции, которые облегчают извлечение символа и подстроки, изменение и преобразование, начиная от строковых списков и заканчивая массивами JavaScript. Преобразования других типов в string происходят по следующим правилам:
Вообще говоря, Вы не должны беспокоиться о явном создании строки вне простого назначения строкового значения в кавычках: var myString = "howdy" Иногда, однако, полезно создать строковый объект, используя конструктор статического объекта String. Подготовка строковых значений для передачи Java аплетам часто требует этого типа создания строки: var myString = new String("howdy") В отличие от конструктора, свойства prototype и метода fromCharCode(), все свойства и методы предназначены для использования с экземплярами объекта String, скорее чем статического строкового объекта. | |||||||||||||||
Создание строкового объекта
var myValue = "someString" var myValue = new String("someString") |
Свойства:
constructor | JavaScript 1.1, NES 2.0, ECMA-262 |
Чтение/Изменение | |
Специфицирует функцию, которая создаёт прототип объекта. Заметьте, что значением этого свойства является ссылка на саму функцию, а не строка, содержащая имя функции. Все объекты наследуют свойство constructor из своих prototype |
|
Пример:
o = new Object // или o = {} в JavaScript 1.2 |
|
Возвращаемое значение: Целое число. |
length | NN 2 IE J1 ECMA 1 |
Только чтение | |
Число символов в строке. Строковые значения динамически изменяют свою длину, если на них назначены новые значения или привязаны другие строки . | |
Пример:
for (var i = 0; i < myString.length; i++) { ... } | |
Возвращаемое значение: Целое число. |
prototype | NN 3 IE J2 ECMA 1 |
Чтение/Изменение | |
Свойство статического объекта String. Используйте свойство prototype, чтобы назначить новые свойства и методы к будущим экземплярам значения String, созданного в текущем документе. См. для примеров описание свойства Array.prototype.. | |
Пример:
String.prototype.author = "DG" | |
Возвращаемое значение: Любые значения, включая функции. |
Методы:
anchor() | NN 2 IE J1 ECMA n/a | ||
anchor(anchorName) | |||
Возвращает копию строки, внедренной в пределах якоря (между тэгами <A>...</A>). Значение, прошедшее, как параметр, назначается на атрибут NAME. Используйте метод anchor с методами document.write или document.writeln для программного создания и отображения якоря в документе. Создаёт якорь методом anchor, а затем вызывает write или writeln для отображения якоря в документе. В серверном JavaScript используйте функцию write для отображения якоря. В этом синтаксисе текстовая строка представляет литеральный текст, который должен видеть конечный пользователь. Строка nameAttribute представляет атрибут NAME тэга A. Якоря, созданные методом anchor, становятся элементами массива document.anchors. | |||
Возвращаемое значение Строка в пределах элемента А. |
|||
Параметры
|
big() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <BIG>...</BIG>. Используйте метод big с методами write или writeln для форматирования и отображения строки документа. В серверном JavaScript используйте функцию write для отображения строки. | |
Возвращаемое значение Строка в пределах элемента BIG |
|
Параметры None. |
blink() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <BLINK>...</BLINK> Используйте метод blink с методами write или writeln для форматирования и отображения строки документа. В серверном JavaScript используйте функцию write для отображения строки. | |
Возвращаемое значение Строка в пределах элемента BLINK |
|
Параметры None. |
bold() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <B>...</B> Используйте bold с методами write или writeln для форматирования и отображения строки документа. В серверном JavaScript используйте функцию write для отображения строки. | |
Возвращаемое значение Строка в пределах элемента B . |
|
Параметры None. |
charAt() | NN 2 IE J1 ECMA 1 | ||
charAt(positionIndex) | |||
Возвращает отдельный символ строки символов, расположенный в отсчитываемой от нуля индексной позиции, прошедшей как параметр, . Используйте этот метод вместо substring() когда только от строки необходим только один символ в известной позиции. Символы строки индексируются слева направо. Индекс первого символа равен 0, индекс последнего символа строки с названием StringName равен StringName.length - 1. если предоставляемый Вами индекс выходит за рамки этого диапазона, JavaScript возвращает пустую строку. | |||
Возвращаемое значение Односимвольная строка. В более новых версиях браузера возвращается пустая строка, если значение параметра указывает на символ вне длины строки. |
|||
Параметры
|
charCodeAt() | NN 4 IE J3 ECMA 1 | ||
charCodeAt(positionIndex) | |||
Возвращает число по основанию 10, соответствующее значению символа в стандарте Unicode, расположенного в отсчитываемой от нуля индексной, прошедшей как параметр, позиции. Для обычных алфавитно-цифровых символов значения Unicode те же, что и значения ASCII. Значения Unicode находятся в диапазоне от 0 до 65,535. Первые 128 значений Unicode напрямую совпадают с набором ASCII-символов. | |||
Возвращаемое значение Положительное целое число. Возвращается NaN, если значение параметра указывает на символ вне длины строки. |
|||
Параметры
|
concat() | NN 4 IE J3 ECMA n/a | ||
concat(string2) | |||
Возвращает строку, которая добавляет строку, указанную в качестве параметра в конец текущего строкового объекта. Результаты этого метода те же самые как и связывание строк операторами (+) или (+=) . Ни метод, ни операторы не вставляют пробелы между двумя строковыми компонентами. | |||
Возвращаемое значение Строка |
|||
Параметры
|
fixed() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <TT>...</TT> Используйте метод fixed с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write. | |
Возвращаемое значение Строка в пределах элемента TT. |
|
Параметры None. |
fontcolor() | NN 2 IE J1 ECMA n/a | ||
fontColor(color) | |||
Возвращает копию строки между тэгами <FONT>...</FONT>. Значение, прошедшее как параметр, назначено на атрибут COLOR. Используйте метод fontcolor с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write. Если Вы вводите цвет как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные RGB-значения для цвета salmon: red=FA, green=80, blue=72, соответственно, RGB-триплет цвета salmon будет "FA8072". | |||
Возвращаемое значение Строка в пределах элемента FONT. |
|||
Параметры
|
fontsize() | NN 2 IE J1 ECMA n/a | ||
fontSize(size) | |||
Возвращает копию строки между тэгами <FONT>...</FONT>. Значение, прошедшее как параметр, назначено на атрибут SIZE Используйте метод fontsize с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write. Если Вы специфицируете размер как целое число, Вы устанавливаете размер
строки StringName в один из семи предопределённых размеров. Если Вы
специфицируете размер как строку, например, "-2", Вы уточняете
размер строки StringName относительно размера, установленного в тэге
BASEFONT. | |||
Возвращаемое значение Строка в пределах элемента FONT. |
|||
Параметры
|
fromCharCode() | NN 4 IE J3 ECMA n/a | ||
fromCharCode(num1, [, num2,[...numN]]) | |||
Статический метод, который возвращает строку из одного или более символов, чьи значения Unicode пропущены как список с разделителями-запятыми между двумя круглыми скобками. Например, выражение: String.fromCharCode(120, 121, 122) возвратит "xyz". | |||
Возвращаемое значение Строка |
|||
Параметры
|
indexOf() | NN 2 IE J1 ECMA 1 | ||||
indexOf(searchString[, startPositionIndex]) | |||||
Возвращает отсчитываемое от нуля целое число позиции в пределах текущей строки, соответствующее номеру (индексному) символа, с которого начинается отыскиваемая строка, определённая параметром searchString. Обычно поиск начинается с первого (индекс 0) символа, но Вы можете начать поиск, начиная его позже в строке, определяя дополнительный второй параметр, который является индексным значением того символа, с которого поиск должен начаться. Если нет никакого соответствия, возвращенное значение -1. Это быстрый, обратно совместимый, способ выяснить, содержит ли одна строка другую: Если возвращенное значение -1, тогда Вы знаете, что строка для поиска не найдена. Если возвращенное значение - другое число (точное значение не имеет значения), строка для поиска найдена. Для браузеров Версии 4, поиск объекта исполняет метод String(). | |||||
Возвращаемое значение Целое число. | |||||
Параметры
|
italics() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <I>...</I> Используйте метод italics с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write. | |
Возвращаемое значение Строка в пределах элемента I |
|
Параметры None. |
lastIndexOf() | NN 2 IE J1 ECMA 1 | ||||
lastIndexOf(searchString[, startPositionIndex]) | |||||
Возвращает отсчитываемое от нуля целое число позиции в пределах текущей строки, соответствующее номеру (индексному) символа, с которого начинается отыскиваемая строка, определённая параметром searchString. Этот метод работает подобно методу indexOf() , но начинает все исследования с конца строки или некоторой индексной позиции. Даже при том, что метод индексирует с конца строки, параметр startPositionIndex основан на начале строки. Если нет никакого соответствия поиску, возвращенное значение -1. | |||||
Возвращаемое значение Целое число. | |||||
Параметры
|
link() | NN 2 IE J1 ECMA n/a | ||
link(URL) | |||
Возвращает копию строки между тэгамиn якоря (<A>). Значение, прошедшее как параметр, назначено на атрибут HREF. Используйте метод link для создания программно гипертекстовой ссылки, затем вызовите методы write или writeln для отображения ссылки в документе. В серверном JavaScript используйте для отображения строки функцию write. Ссылки, созданные методом link, становятся элементами массива ссылок объекта document. См. document.links. | |||
Возвращаемое значение Строка в пределах элемента A |
|||
Параметры
|
localeCompare() | NN n/a IE 5.5 | ||
any_object.localeCompare(str) | |||
Метод localeCompare сравнивает две строки с учетом национальных установок операционной системы. Он возвращает -1, если примитивное значение объекта меньше строки1, +1, если оно больше строки1, и 0, если эти значения совпадают. |
|||
Возвращаемое значение 0, +/-1 |
|||
Параметры
|
match() | NN 4 IE J3 ECMA n/a | ||
match(regexpression) | |||
Возвращает массив строк в пределах текущей строки, которые соответствуют используемому как параметр регулярному выражению. Например, если Вы передаете регулярное выражение, которое определяет любое число с пятью цифрами, возвращенным значением метода match() был бы массив всех чисел с пятью цифрами (как строки) в основной строке. Свойства статического объекта RegExp находятся под влиянием операции этого метода. | |||
Возвращаемое значение Массив строк. |
|||
Параметры
|
replace( ) | NN 4 IE J3 ECMA n/a | ||||||||||
replace(regexpression, replaceString) | |||||||||||
Возвращает новую строку, которая заканчиваается, когда все соответствия параметру regexpression заменены параметром replaceString. Первоначальная строка остаётся невредима. Замещающая строка replaceString может содержать следующие специальные патэрны замещения:
Если в качестве второго параметра Вы специфицируете функцию, эта функция вызывается после выполнения совпадения. (использование функции таким способом часто называется лямбда-выражение.) В Вашей функции Вы можете динамически генерировать строку, которая замещает совпавшую подстроку. Результат вызова функции используется в качестве замещающего значения. Вложенная функция может использовать совпавшие подстроки для определения
новой строки (newSubStr), которая замещает найденную подстроку. Вы получаете
совпавшие подстроки через параметры Вашей функции. Первый параметр Вашей
функции содержит полную совпавшую подстроку. Следующие n параметров
могут быть использованы для совпадений в скобках, запоминаемых строк
подсовпадений, где n это количество строк подсовпадения в регулярном
выражении. Наконец, последние два параметра это смещение в строке, где
произошло совпадение, и сама строка. | |||||||||||
Возвращаемое значение Строка |
|||||||||||
Параметры
|
search() | NN 4 IE J3 ECMA n/a | ||
search(regexpression) | |||
Возвращает отсчитываемое от нуля индексное значение первого символа в строке, которая соответствует образцу параметра regexpression. Этот метод подобен методу indexOf() , но поиск может выполняться с регулярным выражением в качестве параметра | |||
Возвращаемое значение Целое число. | |||
Параметры
|
slice() | NN 4 IE J3 ECMA n/a | ||||
slice(startPositionIndex, endPositionIndex]) | |||||
Возвращает подстроку текущей строки. Подстрока скопирована с основной строки, начиная с отсчитываемого от нуля индексного значения символа в основной строке (startPositionIndex). Если второй параметр не указан, подстрока простирается на всю основную строку. Дополнительный второй параметр может быть другим отсчитываемым от нуля индексным значением того, где подстрока должна закончиться. Это значение может также быть отрицательным значением, которое рассчитывается от конца строки к началу. | |||||
Возвращаемое значение Строка |
|||||
Параметры
|
small() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <SMALL>...</SMALL>. Используйте метод small с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write. | |
Возвращаемое значение Строка в пределах элемента SMALL |
|
Параметры None. |
split() | NN 4 IE J3 ECMA 1 | ||||
split(delimiter [, limitInteger]) | |||||
Возвращает новый объект массив, чьи элементы - доли текущей строки. Текущая строка разделяется (в соответствии с разделителями, указанные первым параметром метода) на элемены массива, и в каждом экземпляре - строка. Разделитель не становится частью массива. Вы не должны объявлять массив до наполнения результатами метода split(). Например, если строка состоит из списка с имен разделителями-запятыми, Вы можете преобразовать список в массив следующим образом: var listArray = stringList.split(",") В JavaScript 1.2 и позже, split имеет следующие дополнения:
|
|||||
Возвращаемое значение Массив. |
|||||
Параметры
|
strike() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <STRIKE>...</STRIKE> Используйте метод strike с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write. | |
Возвращаемое значение Строка в пределах элемента STRIKE |
|
Параметры None. |
sub() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <SUB>...</SUB>. Используйте метод sub с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для генерации HTML функцию write. | |
Возвращаемое значение Строка в пределах элемента SUB |
|
Параметры None. |
substr() | NN 4 IE J3 ECMA n/a | ||||
substr(startPositionIndex [, length]) | |||||
Возвращает копию извлечения из текущей строки. Извлечение начинается в отсчитываемой от нуля индексной позиции текущей строки (как определено первым параметром метода). Если никакой другой параметр не определён, извлечение продолжается к концу основной строки. Второй параметр может определить целое число символов, которое будет извлечено из основной строки. Напротив, параметры метода substring() указывают на начальное и конечное значения индекса позиции в основной строке. | |||||
Возвращаемое значение Строка |
|||||
Параметры
|
substring() | NN 2 IE J1 ECMA 1 | ||||
subString(indexA, indexB) | |||||
Возвращает копию извлечения из текущей строки. Извлечение начинается в отсчитываемой от нуля индексной позиции текущей строки, как определено первым параметром метода и заканчивается в символе, чей индекс определен вторым параметром. Напротив, параметры метода substr() устанавливают позицию начала основной строки и число символов (длину). В частности:
В JavaScript 1.2 используется LANGUAGE="JavaScript1.2" в тэге SCRIPT:
В JavaScript 1.2 - без LANGUAGE="JavaScript1.2" в тэге SCRIPT:
|
|||||
Возвращаемое значение Строка |
|||||
Параметры
|
sup() | NN 2 IE J1 ECMA n/a |
Возвращает копию строки между тэгами <SUP>...</SUP> Используйте метод sup с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для генерации HTML функцию write. | |
Возвращаемое значение Строка в пределах элемента SUP |
|
Параметры None. |
toLocaleLowerCase(), toLocaleUpperCase() | NN n/a IE 5.5 |
Метод toLocaleLowerCase возвращает новую строку, в которой все буквы исходной строки заменены на строчные с учетом национальных установок операционной системы. Остальные символы исходной строки не изменяются. Исходная строка остается прежней. Обычно этот метод возвращает тот же результат, что и toLowerCase; отличие возможно только в том случае, если кодировка языка противоречит правилам Unicode по преобразованию прописных букв в строчные. Метод toLocaleUpperCase возвращает новую строку, в которой все буквы исходной строки заменены на прописные с учетом национальных установок операционной системы. Остальные символы исходной строки не изменяются. Исходная строка остается прежней. Обычно этот метод возвращает тот же результат, что и toUpperCase; отличие возможно только в том случае, если кодировка языка противоречит правилам Unicode по преобразованию строчных букв в прописные |
|
Возвращаемое значение Строка |
|
Параметры Нет |
toLowerCase(), toUpperCase() | NN 2 IE J1 ECMA 1 |
Возвращает копию текущей строки в нижнем регистре (или в прописных буквах). Если Вы хотите заменить текущую строку откорректированной версией, назначьте результат метода на эту самую строку: myString = myString.toUpperCase() Обычно используют один из этих методов, чтобы создать сравнение двух строк без учета регистра. Это особенно удобно, если одна из сравниваемых строк введена пользователем: if (document.forms[0].entry.value.toLowerCase() == compareValue) { ... } | |
Возвращаемое значение Строка |
|
Параметры Нет |
toSource() | JavaScript 1.3 |
Возвращает строку - исходный код объекта. Это метод обычно вызывается внутренне в JavaScript, а не явно в коде. |
|
Возвращаемое значение Метод toSource возвращает следующие значения:
|
|
Параметры Нет |
toString() | JavaScript 1.1, NES 2.0, ECMA-262 |
Возвращает строку, представляющую специфицированный объект. |
|
Возвращаемое значение Строка |
|
Параметры Нет |
valueOf() | JavaScript 1.1, ECMA-262 |
Возвращает примитивное значение String-объекта. Это значение эквивалентно String.toString. |
|
Возвращаемое значение Строка |
|
Параметры Нет |
HIVE: All information for read only. Please respect copyright! |