diff options
author | Florian Merz <me@fiji-flo.de> | 2021-02-11 14:45:12 +0100 |
---|---|---|
committer | Florian Merz <me@fiji-flo.de> | 2021-02-11 14:45:12 +0100 |
commit | cb9e359a51c3249d8f5157db69d43fd413ddeda6 (patch) | |
tree | ae3040d626c3b5717da5bda2af9f0a9ff9bd389f /files/ca/web/javascript/reference/global_objects/string/substr/index.html | |
parent | 8260a606c143e6b55a467edf017a56bdcd6cba7e (diff) | |
download | translated-content-cb9e359a51c3249d8f5157db69d43fd413ddeda6.tar.gz translated-content-cb9e359a51c3249d8f5157db69d43fd413ddeda6.tar.bz2 translated-content-cb9e359a51c3249d8f5157db69d43fd413ddeda6.zip |
unslug ca: move
Diffstat (limited to 'files/ca/web/javascript/reference/global_objects/string/substr/index.html')
-rw-r--r-- | files/ca/web/javascript/reference/global_objects/string/substr/index.html | 156 |
1 files changed, 156 insertions, 0 deletions
diff --git a/files/ca/web/javascript/reference/global_objects/string/substr/index.html b/files/ca/web/javascript/reference/global_objects/string/substr/index.html new file mode 100644 index 0000000000..5fdb1f03b4 --- /dev/null +++ b/files/ca/web/javascript/reference/global_objects/string/substr/index.html @@ -0,0 +1,156 @@ +--- +title: String.prototype.substr() +slug: Web/JavaScript/Referencia/Objectes_globals/String/substr +translation_of: Web/JavaScript/Reference/Global_Objects/String/substr +--- +<div>{{JSRef}}</div> + +<p>El mètode <strong><code>substr()</code></strong> retorna els caràcters d'una cadena començant per la posició especificada fins al nombre especificat de caràcters.</p> + +<h2 id="Sintaxi">Sintaxi</h2> + +<pre class="syntaxbox"><code><var>str</var>.substr(<var>començament</var>[, <var>llargària</var>])</code></pre> + +<h3 id="Paràmetres">Paràmetres</h3> + +<dl> + <dt><code>començament</code></dt> + <dd>Lloc des d'on es comença a extraure els caràcters. Si es dóna un nombre negatiu, se'l tracta com <code>strLength + començament</code> on <code>strLength</code> és la llargària de al cadena (per exemple, si <code>començament</code> és -3 se'l tracta com <code>strLength - 3</code>.)</dd> + <dt><code>llargària</code></dt> + <dd>Opcional. El nombre de caràcter per extraure.</dd> +</dl> + +<h2 id="Descripció">Descripció</h2> + +<p><code>començament</code> is a character index. L'índex del primer caràcter és 0, i l'índex de l'últim caràcter és 1 menys que la llargària de la cadena. <code>substr()</code> comença extraient caràcters a <code>començament</code> i recull els caràcters <code>llargària</code> (llevat que primer s'arribi al final de la cadena, en aquest cas en retornaria menys).</p> + +<p>Si <code>començament</code> és positivu i més gran o igual que la llargària de la cadena, <code>substr()</code> retornarà una cadena buida.</p> + +<p>SI <code>començament</code> és negatiu, <code>substr()</code> l'utilitza com un índex de caràcter des del final de la cadena. Si <code>començament</code> és negatiu i <code>abs(comença,ent)</code> és més gran que la llargària de la cadena, <code>substr()</code> utilitza 0 com a índex d'inici. Nota: El maneig de valors negatius de l'argument <code>començament</code> no està suportat per Microsoft JScript.</p> + +<p>Si <code>llargària</code> és 0 o negatiu, <code>substr()</code> retorna una cadena buida. Si <code>llargària</code> s'omet, <code>substr()</code> extreu els caràcter fins al final de la cadena.</p> + +<h2 id="Exemples">Exemples</h2> + +<h3 id="Utilitzar_substr()">Utilitzar <code>substr()</code></h3> + +<pre class="brush: js">var str = 'abcdefghij'; + +console.log('(1, 2): ' + str.substr(1, 2)); // '(1, 2): bc' +console.log('(-3, 2): ' + str.substr(-3, 2)); // '(-3, 2): hi' +console.log('(-3): ' + str.substr(-3)); // '(-3): hij' +console.log('(1): ' + str.substr(1)); // '(1): bcdefghij' +console.log('(-20, 2): ' + str.substr(-20, 2)); // '(-20, 2): ab' +console.log('(20, 2): ' + str.substr(20, 2)); // '(20, 2): ' +</pre> + +<h2 id="Polyfill">Polyfill</h2> + +<p>Microsoft's JScript no suporta valors negatius per l'índex d'inici. Si desitjes utilitzar aquesta característica, pots utilitzar el codi de compatibilitat següent per evitar aquest error:</p> + +<pre class="brush: js">// només s'executa quan la funció substr() està trencada +if ('ab'.substr(-1) != 'b') { + /** + * Obtenir la subcadena d'una cadena + * @param {integer} start on comença la subcadena + * @param {integer} length quants caràcters s'han de retornar + * @return {string} + */ + String.prototype.substr = function(substr) { + return function(start, length) { + // crida el mètode original + return substr.call(this, + // Si ens dóna un començament negatiu, calcular quant es des de l'inici de la cadena + // adjustar el paràmetre start per valor negatiu + start < 0 ? this.length + start : start, + length) + } + }(String.prototype.substr); +} +</pre> + +<h2 id="Especificacions">Especificacions</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Especificació</th> + <th scope="col">Estat</th> + <th scope="col">Comentaris</th> + </tr> + <tr> + <td>{{SpecName('ES3')}}</td> + <td>{{Spec2('ES3')}}</td> + <td>Definit en l'Annex B de Compatibilitat (informative). Implementat en JavaScript 1.0.</td> + </tr> + <tr> + <td>{{SpecName('ES5.1', '#sec-B.2.3', 'String.prototype.substr')}}</td> + <td>{{Spec2('ES5.1')}}</td> + <td>Definit en l'Annex B de Compatibilitat (informative)</td> + </tr> + <tr> + <td>{{SpecName('ES6', '#sec-string.prototype.substr', 'String.prototype.substr')}}</td> + <td>{{Spec2('ES6')}}</td> + <td>Definit en l'Annex B (normative) per Característiques addiccionals d'ECMAScript per Navegadors Web</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilitat_amb_navegadors">Compatibilitat amb navegadors</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Característica</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Suport bàsic</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Característica</th> + <th>Android</th> + <th>Chrome per Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Suport bàsic</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Vegeu_també">Vegeu també</h2> + +<ul> + <li>{{jsxref("String.prototype.slice()")}}</li> + <li>{{jsxref("String.prototype.substring()")}}</li> +</ul> |