BCD tables only load in the browser
String.prototype.substr(…)
не полностью упразднена (а лишь "удалена из стандартов по вебу"), она считается унаследованной функцией, использование которой лучше избегать там, где это возможно. Она не является частью ядра языка JavaScript и может быть удалена в будущем. Если есть возможность, используйте метод substring()
.Метод substr()
возвращает указанное количество символов из строки, начиная с указанной позиции.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
str.substr(start[, length])
start
- Позиция, с которой начинать извлекать символы. Если передано отрицательное число, она трактуется как
strLength - start
, гдеstrLength
равна длине строки (например, если параметрstart
равен -3, то он трактуется какstrLength - 3
.) length
- Необязательный параметр. Количество извлекаемых символов.
Новая строка, содержащая часть исходной, обрезанной по переданным параметрам.
Параметр start
является индексом символа. Индекс первого символа равен 0, а последнего символа — на один меньше длины строки. Метод substr()
начинает извлекать символы начиная с позиции start
и собирая length
символов (если он не достигнет раньше конца строки, в этом случае будет возвращено меньшее количество символов).
Если параметр start
является положительным и он больше, либо равен длине строки, метод substr()
вернёт пустую строку.
Если параметр start
является отрицательным, метод substr()
использует его как индекс символа, начиная с конца строки. Если параметр start
отрицателен и по модулю больше длины строки, метод substr()
будет использовать 0 в качестве начального индекса. Обратите внимание: описанная обработка отрицательных значений аргумента start
не поддерживается JScript от Microsoft.
Если параметр length
равен нулю или отрицателен, метод substr()
вернёт пустую строку. Если параметр length
опущен, метод substr()
извлечёт все символы до конца строки.
var str = 'абвгдеёжзи';
console.log('(1, 2): ' + str.substr(1, 2)); // '(1, 2): бв'
console.log('(-3, 2): ' + str.substr(-3, 2)); // '(-3, 2): жз'
console.log('(-3): ' + str.substr(-3)); // '(-3): жзи'
console.log('(1): ' + str.substr(1)); // '(1): бвгдеёжзи'
console.log('(-20, 2): ' + str.substr(-20, 2)); // '(-20, 2): аб'
console.log('(20, 2): ' + str.substr(20, 2)); // '(20, 2): '
JScript от Microsoft не поддерживает отрицательные значения для начального индекса. Если вы хотите использовать эту возможность, вы можете использовать следующий код совместимости для обхода этой ошибки:
// only run when the substr() function is broken
if ('ab'.substr(-1) != 'b') {
/**
* Get the substring of a string
* @param {integer} start where to start the substring
* @param {integer} length how many characters to return
* @return {string}
*/
String.prototype.substr = function(substr) {
return function(start, length) {
// call the original method
return substr.call(this,
// did we get a negative start, calculate how much it is from the beginning of the string
// adjust the start parameter for negative value
start < 0 ? this.length + start : start,
length)
}
}(String.prototype.substr);
}
Спецификация |
---|
ECMAScript (ECMA-262) Определение 'String.prototype.substr' в этой спецификации. |
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.