diff options
Diffstat (limited to 'files/uk/web/javascript/reference/global_objects/string/substr/index.html')
| -rw-r--r-- | files/uk/web/javascript/reference/global_objects/string/substr/index.html | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/files/uk/web/javascript/reference/global_objects/string/substr/index.html b/files/uk/web/javascript/reference/global_objects/string/substr/index.html new file mode 100644 index 0000000000..265ef1552d --- /dev/null +++ b/files/uk/web/javascript/reference/global_objects/string/substr/index.html @@ -0,0 +1,118 @@ +--- +title: String.prototype.substr() +slug: Web/JavaScript/Reference/Global_Objects/String/substr +tags: + - JavaScript + - String + - метод + - не рекомендований + - рядок +translation_of: Web/JavaScript/Reference/Global_Objects/String/substr +--- +<p>{{JSRef}}</p> + +<div class="warning"><strong>Застереження</strong>: Хоча метод <code>String.prototype.substr(…)</code> не є строго не рекомендованим (як "прибраний з веб-стандартів"), він вважається <strong>застарілим</strong> та не бажаний для використання, коли це можливо. Він не є частиною ядра мови JavaScript та може бути прибраний в майбутньому. За можливості, використовуйте замість нього метод <code><a href="/uk/docs/Web/JavaScript/Reference/Global_Objects/String/substring">substring()</a></code>.</div> + +<p class="seoSummary">Метод <strong><code>substr()</code></strong> повертає частину рядка, що починається з вказаного індекса та продовжується вказану кількість символів.</p> + +<div>{{EmbedInteractiveExample("pages/js/string-substr.html")}}</div> + + + +<h2 id="Синтаксис">Синтаксис</h2> + +<pre class="syntaxbox"><var>str</var>.substr(<var>start</var>[, <var>length]</var>)</pre> + +<h3 id="Параметри">Параметри</h3> + +<dl> + <dt><code>start</code></dt> + <dd>Індекс першого символу, який треба включити у повернений рядок.</dd> + <dt><code>length</code></dt> + <dd>Необов'язковий. Кількість символів, яку треба повернути.</dd> +</dl> + +<h3 id="Значення_що_повертається">Значення, що повертається</h3> + +<p>Новий рядок, що містить вказану частину наданого рядка.</p> + +<h2 id="Опис">Опис</h2> + +<p>Метод <code>substr()</code> вирізає <code>length</code> символів з рядка <code>string</code>, рахуючи з початкового індексу <code>start</code>.</p> + +<p>Якщо <code>start</code> є додатним числом, індекс рахується з початку рядка. Його значення обмежується значенням <code>str.length</code>.<br> + Якщо <code>start</code> є від'ємним числом, індекс рахується з кінця рядка. Його значення обмежується значенням <code>-str.length</code>.<br> + Заувага: У Microsoft JScript від'ємне значення аргументу <code>start</code> не вважається посиланням на кінець рядка.</p> + +<p>Якщо аргумент <code>length</code> пропущений, <code>substr()</code> повертає символи до кінця рядка.<br> + Якщо <code>length</code> дорівнює {{jsxref("undefined")}}, <code>substr()</code> повертає символи до кінця рядка.<br> + Якщо <code>length</code> є від'ємним числом, він вважається рівним 0.</p> + +<p>Для обох, <code>start</code> та <code>length</code>, NaN вважається рівним 0.</p> + +<h2 id="Приклади">Приклади</h2> + +<h3 id="Використання_substr">Використання <code>substr()</code></h3> + +<pre class="brush: js">var aString = 'Mozilla'; + +console.log(aString.substr(0, 1)); // 'M' +console.log(aString.substr(1, 0)); // '' +console.log(aString.substr(-1, 1)); // 'a' +console.log(aString.substr(1, -1)); // '' +console.log(aString.substr(-3)); // 'lla' +console.log(aString.substr(1)); // 'ozilla' +console.log(aString.substr(-20, 2)); // 'Mo' +console.log(aString.substr(20, 2)); // '' +</pre> + +<h2 id="Поліфіл">Поліфіл</h2> + +<p>JScript у Microsoft не підтримує від'ємні значення початкового індекса. Щоб використовувати цю функціональність у JScript, ви можете скористатись наступним кодом:</p> + +<pre class="brush: js">// запускайте тільки якщо функція substr() не працює +if ('ab'.substr(-1) != 'b') { + /** + * Отримати підрядок з рядка + * @param {integer} start де почати підрядок + * @param {integer} length скільки символів повертати + * @return {string} + */ + String.prototype.substr = function(substr) { + return function(start, length) { + // викликаємо початковий метод + return substr.call(this, + // якщо ми отримали від'ємний start, порахувати, скільки це від початку рядка + // відкоригувати параметр start для від'ємного значення + start < 0 ? this.length + start : start, + length) + } + }(String.prototype.substr); +} +</pre> + +<h2 id="Специфікації">Специфікації</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Специфікація</th> + </tr> + <tr> + <td>{{SpecName('ESDraft', '#sec-string.prototype.substr', 'String.prototype.substr')}}</td> + </tr> + </tbody> +</table> + +<h2 id="Сумісність_з_веб-переглядачами">Сумісність з веб-переглядачами</h2> + +<p class="hidden">The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> + +<p>{{Compat("javascript.builtins.String.substr")}}</p> + +<h2 id="Див._також">Див. також</h2> + +<ul> + <li>{{jsxref("String.prototype.slice()")}}</li> + <li>{{jsxref("String.prototype.substring()")}}</li> +</ul> |