String NN 2  IE J1  ECMA 1

Объект String представляет любую собой последовательность из 0 или большего числа символов, которые должны быть обработаны строго как текст (то есть, никаких математических операций не должны применяться). Большая библиотека методов разделена на две категории. Одна категория окружает строку парой тэгов HTML для форматирования объекта HTML. Эти методы используются прежде всего, чтобы помочь инструкциям, которые используют document.write() динамически создать содержание. Вторая категория методов - более традиционный набор для синтаксического анализа строки и манипуляции, которые облегчают извлечение символа и подстроки, изменение и преобразование, начиная от строковых списков и заканчивая массивами JavaScript.

Преобразования других типов в string происходят по следующим правилам:

Исходный тип Результат
Undefined "undefined"
Null "null"
Boolean "true", если аргумент равен true, и "false", если аргумент равен false
Number

текстовое представление числа

Преобразование числа n в строку происходит по следующим правилам:

  • если n равно NaN, то результат "NaN";
  • если n равно +0 или -0, то результат "0";
  • если n отрицательно, то результат будет конкатенацией строки "-" и результата преобразования в строку числа -n;
  • если n равно бесконечности, то результат "Infinity";
  • в остальных случаях пусть m, k и s - такие целые числа, что k >= 1, 10k-1 <= s < 10k, n равно s x 10m-k и k - наименьшее из возможных. Отметим, что k - это количество цифр в десятичном представлении s, что s не делится на 10 и что наименее значимая цифра s может не быть однозначно определенной. Тогда
  • если k <= m <= 21, то результат состоит из k десятичных цифр s (без ведущих нулей), за которыми следуют m-k символов '0';
  • иначе, если 0 < m <= 21, то результат состоит из m старших десятичных цифр s, за которыми следуют десятичная точка '.' и k-m оставшихся десятичных цифр s;
  • иначе, если -6 < m <= 0, то результат состоит из символа '0', за которым следуют десятичная точка '.', -m символов '0' и k десятичных цифр s;
  • иначе, если k = 1, то результат состоит из единственной цифры s, символа 'e', символа плюс '+' или минус '-' в зависимости от того, положительно или отрицательно m-1, за которыми следует десятичное представление числа abs(m-1);
  • иначе результат состоит из старшей десятичной цифры s, за которой следуют десятичная точка '.' и k-1 оставшихся десятичных цифр s, символ 'e', символ плюс '+' или минус '-' в зависимости от того, положительно или отрицательно m-1, за которыми следует десятичное представление числа abs(m-1).
String без изменений
Object результат преобразования значения объекта по умолчанию

Вообще говоря, Вы не должны беспокоиться о явном создании строки вне простого назначения строкового значения в кавычках:

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
o.constructor == Object
a = new Array // или a = [] в JavaScript 1.2
a.constructor == Array
n = new Number(3)
n.constructor == Number

 
Возвращаемое значение:
Целое число.

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.

 
Возвращаемое значение
Строка в пределах элемента А.
 
Параметры
anchorName Строка, использованная как значение атрибута NAME.

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 возвращает пустую строку.

 
Возвращаемое значение
Односимвольная строка. В более новых версиях браузера возвращается пустая строка, если значение параметра указывает на символ вне длины строки.
 
Параметры
positionIndex Отсчитываемое от нуля целое число.

charCodeAt() NN 4  IE J3  ECMA 1
charCodeAt(positionIndex)  
 

Возвращает число по основанию 10, соответствующее значению символа в стандарте Unicode, расположенного в отсчитываемой от нуля индексной, прошедшей как параметр, позиции. Для обычных алфавитно-цифровых символов значения Unicode те же, что и значения ASCII. Значения Unicode находятся в диапазоне от 0 до 65,535. Первые 128 значений Unicode напрямую совпадают с набором ASCII-символов.

 
Возвращаемое значение
Положительное целое число. Возвращается NaN, если значение параметра указывает на символ вне длины строки.
 
Параметры
positionIndex Отсчитываемое от нуля целое число

concat() NN 4  IE J3  ECMA n/a
concat(string2)  
 

Возвращает строку, которая добавляет строку, указанную в качестве параметра в конец текущего строкового объекта. Результаты этого метода те же самые как и связывание строк операторами (+) или (+=) . Ни метод, ни операторы не вставляют пробелы между двумя строковыми компонентами.

 
Возвращаемое значение
Строка
 
Параметры
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.
 
Параметры
color Строка, использованная как значение атрибута COLOR.

fontsize() NN 2  IE J1  ECMA n/a
fontSize(size)  
 

Возвращает копию строки между тэгами <FONT>...</FONT>. Значение, прошедшее как параметр, назначено на атрибут SIZE

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

Если Вы специфицируете размер как целое число, Вы устанавливаете размер строки StringName в один из семи предопределённых размеров. Если Вы специфицируете размер как строку, например, "-2", Вы уточняете размер строки StringName относительно размера, установленного в тэге BASEFONT.

 
Возвращаемое значение
Строка в пределах элемента FONT.
 
Параметры
size Строка, использованная как значение атрибута SIZE

fromCharCode() NN 4  IE J3  ECMA n/a
fromCharCode(num1, [, num2,[...numN]])  
 

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

String.fromCharCode(120, 121, 122)

возвратит "xyz".

 
Возвращаемое значение
Строка
 
Параметры
num1...numN Одно или более целочисленных значений без кавычек в списке с разделителями-запятыми.

indexOf() NN 2  IE J1  ECMA 1
indexOf(searchString[, startPositionIndex])  
 

Возвращает отсчитываемое от нуля целое число позиции в пределах текущей строки, соответствующее номеру (индексному) символа, с которого начинается отыскиваемая строка, определённая параметром searchString. Обычно поиск начинается с первого (индекс 0) символа, но Вы можете начать поиск, начиная его позже в строке, определяя дополнительный второй параметр, который является индексным значением того символа, с которого поиск должен начаться. Если нет никакого соответствия, возвращенное значение -1. Это быстрый, обратно совместимый, способ выяснить, содержит ли одна строка другую: Если возвращенное значение -1, тогда Вы знаете, что строка для поиска не найдена. Если возвращенное значение - другое число (точное значение не имеет значения), строка для поиска найдена. Для браузеров Версии 4, поиск объекта исполняет метод String().

 
Возвращаемое значение
Целое число.
 
Параметры
searchString Строка для поиска в текущем строковом объекте
startPositionIndex Отсчитываемое от нуля целое число, указывающее позицию в пределах текущего строкового объекта, с которого начнётся поиск первого параметра

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.

 
Возвращаемое значение
Целое число.
 
Параметры
searchString Строка для поиска в текущем строковом объекте
startPositionIndex Отсчитываемое от нуля целое число, указывающее позицию в пределах текущего строкового объекта, с которого начнётся поиск первого параметра

link() NN 2  IE J1  ECMA n/a
link(URL)  
 

Возвращает копию строки между тэгамиn якоря (<A>). Значение, прошедшее как параметр, назначено на атрибут HREF.

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

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

 
Возвращаемое значение
Строка в пределах элемента A
 
Параметры
URL Значение, назначенное на атрибут HREF.

localeCompare() NN n/a  IE 5.5
any_object.localeCompare(str)  
 

Метод localeCompare сравнивает две строки с учетом национальных установок операционной системы. Он возвращает -1, если примитивное значение объекта меньше строки1, +1, если оно больше строки1, и 0, если эти значения совпадают.

 
Возвращаемое значение
0, +/-1
 
Параметры
str любое строковое выражение

match() NN 4  IE J3  ECMA n/a
match(regexpression)  
 

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

 
Возвращаемое значение
Массив строк.
 
Параметры
regexpression Объект regular expression.

replace( ) NN 4  IE J3  ECMA n/a
replace(regexpression, replaceString)  
 

Возвращает новую строку, которая заканчиваается, когда все соответствия параметру regexpression заменены параметром replaceString. Первоначальная строка остаётся невредима. Замещающая строка replaceString может содержать следующие специальные патэрны замещения:

$$ Вставляет '$'.
$& Вставляет совпавшую подстроку.
$` Вставляет часть строки, предшествующую совпавшей подстроке.
Вставляет часть строки, следующую после совпавшей подстроки.
$n или $nn Где n или nn это десятеричные числа, вставляет подстроку n-ного совпадения в скобках.

Если в качестве второго параметра Вы специфицируете функцию, эта функция вызывается после выполнения совпадения. (использование функции таким способом часто называется лямбда-выражение.)

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

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

 
Возвращаемое значение
Строка
 
Параметры
regexpression Объект regular expression. See the regular expression object for the Синтаксис to create a regular expression object.
replaceString Строка, которая должна заменить соответствие regexpression в текущей строке.

search() NN 4  IE J3  ECMA n/a
search(regexpression)  
 

Возвращает отсчитываемое от нуля индексное значение первого символа в строке, которая соответствует образцу параметра regexpression. Этот метод подобен методу indexOf() , но поиск может выполняться с регулярным выражением в качестве параметра

 
Возвращаемое значение
Целое число.
 
Параметры
regexpression Объект regular expression.

slice() NN 4  IE J3  ECMA n/a
slice(startPositionIndex, endPositionIndex])  
 

Возвращает подстроку текущей строки. Подстрока скопирована с основной строки, начиная с отсчитываемого от нуля индексного значения символа в основной строке (startPositionIndex). Если второй параметр не указан, подстрока простирается на всю основную строку. Дополнительный второй параметр может быть другим отсчитываемым от нуля индексным значением того, где подстрока должна закончиться. Это значение может также быть отрицательным значением, которое рассчитывается от конца строки к началу.

 
Возвращаемое значение
Строка
 
Параметры
startPositionIndex Отсчитываемое от нуля целое число, определяющее индекс первого символа подстроки.
endPositionIndex Отсчитываемое от нуля целое число, определяющее индекс последнего символа подстроки.Отрицательные значения рассчитываются как конец строки.

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 имеет следующие дополнения:

  • Он может принимать регулярное выражение в качестве аргумента, а также фиксированную строку, по которым разделяется строка-объект. Если сепаратор - регулярное выражение, любые имеющиеся скобки вызывают включение подсовпадений в возвращаемый массив.
  • Может принимать ограниченное количество элементов, так что результирующий массив не будет содержать пустые ведомые элементы.
  • Если Вы специфицируете LANGUAGE="JavaScript1.2" в тэге SCRIPT, String.split(" ") делит строку при каждом прогоне одним или более пробельными символами, включая пробелы, табуляцию, прогоны строки и возвраты каретки. Для этого LANGUAGE="JavaScript1.2" обязано быть специфицировано в тэге <SCRIPT>.
 
Возвращаемое значение
Массив.
 
Параметры
delimiter Строка или регулярное выражение, который определяет, где основная строка разделена на элементы массива.
limitInteger Дополнительное целое число, которое ограничивает число элементов, преобразованных в элементы массива. Этот параметр признан только Navigator 4.

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() указывают на начальное и конечное значения индекса позиции в основной строке.

 
Возвращаемое значение
Строка
 
Параметры
startPositionIndex Отсчитываемое от нуля целое число, указывающее позицию в пределах текущего строкового объекта, где начинается копирование символов
length Дополнительное целое число символов, которые нужно извлечь (длина полученной строки)

substring() NN 2  IE J1  ECMA 1
subString(indexA, indexB)  
 

Возвращает копию извлечения из текущей строки. Извлечение начинается в отсчитываемой от нуля индексной позиции текущей строки, как определено первым параметром метода и заканчивается в символе, чей индекс определен вторым параметром. Напротив, параметры метода substr() устанавливают позицию начала основной строки и число символов (длину).

В частности:

  • Если indexA меньше 0, indexA рассматривается как имеющий значение 0.
  • Если indexB больше, чем StringName.length, indexB рассматривается так, как если бы он был StringName.length.
  • Если indexA равен indexB, subString возвращает пустую строку.
  • Если indexB опущен, indexA извлекает символы до конца строки.

В JavaScript 1.2 используется LANGUAGE="JavaScript1.2" в тэге SCRIPT:

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

В JavaScript 1.2 - без LANGUAGE="JavaScript1.2" в тэге SCRIPT:

  • Если indexA больше, чем indexB, JavaScript возвращает подстроку, начинающуюся с indexB и заканчивающуюся indexA - 1.
 
Возвращаемое значение
Строка
 
Параметры
startPositionIndex Отсчитываемое от нуля целое число, указывающее позицию в пределах текущего строкового объекта, где начинается копирование символов
endPositionIndex Отсчитываемое от нуля целое число, указывающее позицию в пределах текущего строкового объекта, где нужно закончить копирование символов

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 возвращает следующие значения:
  • Для встроенного объекта String, toSource возвращает следующую строку, указывающую, что исходный код недоступен:
    function String() {
    [native code]
    }
  • Для экземпляров String или строковых литералов, 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!
Hosted by hive КГБ: Киевская городская библиотека