JavaScript метод substr()

JavaScript String

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

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


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


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

МетодChrome
Chrome
Firefox
Firefox
Opera
Opera
Safari
Safari
Internet Explorer
IExplorer
Microsoft Edge
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, "не число") расценивается равным нулю.

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

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