JavaScript метод substring()

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

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

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

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

JavaScript синтаксис:

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

// извлечение символов из строки между двумя заданными индексами
string.substring( start, end);

Версия JavaScript

1.0

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

Параметр	Описание
start	Целое число, которое определяет индекс с которого производится копирование подстроки из исходной строки. Обязательный параметр. Если в качестве значения индекса указывается отрицательное число, undefined, или значение NaN (англ. Not-a-Number, "не число"), то это значение расценивается равным нулю. Если один из параметров больше или равен длине строки, то значение расценивается равным длине строки. Если параметр start равен параметру end, то метод substring() вернет пустую строку. Если параметр start больше параметра end, то метод поменяет их значения местами.
end	Целое число, которое определяет индекс до которого происходит копирование подстроки. Подстрока включает символы указанные до указанного индекса (символ по указанному индексу не включается). Необязательный параметр. Если параметр end не используется, то метод substring() производит копирование символов до конца строки. Если в качестве значения индекса указывается отрицательное число, undefined, или значение NaN (англ. Not-a-Number, "не число"), то это значение расценивается равным нулю, если в этом случае значение параметра start окажется больше параметра end, то метод поменяет их местами.

Параметр

Описание

start

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

end

Целое число, которое определяет индекс до которого происходит копирование подстроки. Подстрока включает символы указанные до указанного индекса (символ по указанному индексу не включается). Необязательный параметр.
Если параметр end не используется, то метод substring() производит копирование символов до конца строки. Если в качестве значения индекса указывается отрицательное число, undefined, или значение NaN (англ. Not-a-Number, "не число"), то это значение расценивается равным нулю, если в этом случае значение параметра start окажется больше параметра end, то метод поменяет их местами.

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

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

string.substring( 0 ); // возвращаемое значение "Hello world"
string.substring( 6 ); // возвращаемое значение "world"
string.substring( 10 ); // возвращаемое значение "d"
string.substring( -10 ); // возвращаемое значение "Hello world"
string.substring( 15 ); // возвращаемое значение ""
string.substring( 0, 0 ); // возвращаемое значение ""
string.substring( 1, 4 ); // возвращаемое значение "ell"
string.substring( 4, 1 ); // возвращаемое значение "ell" (значения параметров меняются местами)
string.substring( 0, 4 ); // возвращаемое значение "Hell"
string.substring( 4, NaN ); // возвращаемое значение "Hell" (NaN расценивается как 0 и значения параметров меняются местами)

JavaScript String