JavaScript метод substr()

Определение и применение

JavaScript метод substr() позволяет извлечь из строки определенное количество символов, начиная с заданного индекса.

Обращаю Ваше внимание, что метод substr() не изменяет значение строки на которой он был вызван.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
`substr()`	Да	Да	Да	Да	Да	Да

JavaScript синтаксис:

// копирование символов происходит с заданного индекса до конца строки
string.substr( start );

// копирование символов происходит с заданного индекса в количестве, указанном в параметре length
string.substr( start, length );

Версия JavaScript

1.0

Значения параметров

Параметр	Описание
start	Индекс с которого производится копирование символов из исходной строки. Обязательный параметр. Если в качестве значения индекса указывается отрицательное число, то индекс с которого будет произведено копирование символов рассчитывается как длина строки + start. Если начальный индекс больше или равен длине строки, то метод substr() вернет пустую строку. Значение NaN (англ. Not-a-Number, "не число") расценивается равным нулю.
length	Количество символов, которые будут скопированы из исходной строки. Необязательный параметр. Если параметр length не используется, или равен undefined, то метод substr() производит копирование символов до конца строки. Если length является отрицательным числом, то оно считается равным 0. Значение NaN (англ. Not-a-Number, "не число") расценивается равным нулю.

Параметр

Описание

start

Индекс с которого производится копирование символов из исходной строки. Обязательный параметр.
Если в качестве значения индекса указывается отрицательное число, то индекс с которого будет произведено копирование символов рассчитывается как длина строки + start. Если начальный индекс больше или равен длине строки, то метод substr() вернет пустую строку. Значение NaN (англ. Not-a-Number, "не число") расценивается равным нулю.

length

Количество символов, которые будут скопированы из исходной строки. Необязательный параметр. Если параметр length не используется, или равен undefined, то метод substr() производит копирование символов до конца строки. Если length является отрицательным числом, то оно считается равным 0. Значение NaN (англ. Not-a-Number, "не число") расценивается равным нулю.

Пример использования

var str = "Hello world"; // инициализируем строковую переменную

var newString = str.substr( 0 ); // переменная содержит значение "Hello world"
var newString = str.substr( 6 ); // переменная содержит значение "world"
var newString = str.substr( 7, 2 ); // переменная содержит значение "or"
var newString = str.substr( -5 ); // переменная содержит значение "world"
var newString = str.substr( -4, 2 ); // переменная содержит значение "or"
var newString = str.substr( 100 ); // переменная содержит значение "" (пустая строка)
var newString = str.substr( NaN ); // переменная содержит значение "Hello world"

JavaScript String