diff options
Diffstat (limited to 'files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html')
| -rw-r--r-- | files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html | 191 |
1 files changed, 0 insertions, 191 deletions
diff --git a/files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html b/files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html deleted file mode 100644 index 721fb3c913..0000000000 --- a/files/pt-pt/web/javascript/reference/global_objects/string/indexof/index.html +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: String.prototype.indexOf() -slug: Web/JavaScript/Reference/Global_Objects/String/indexOf -tags: - - JavaScript - - Method - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String/indexOf ---- -<div>{{JSRef}}</div> - -<p>O método <strong><code>indexOf()</code></strong> retorna o indíce da primeira ocorrência do valor especificado no objeto {{jsxref("String")}}, começando a procura a partir de <code>fromIndex</code>. Retorna -1 se o valor não for encontrado.</p> - -<h2 id="Sintaxe">Sintaxe</h2> - -<pre class="syntaxbox"><code><var>str</var>.indexOf(<var>searchValue</var>[, <var>fromIndex</var>]</code>)</pre> - -<h3 id="Parâmetros">Parâmetros</h3> - -<dl> - <dt><code>searchValue</code></dt> - <dd>Uma string com o valor pelo qual se procura.</dd> - <dt><code>fromIndex</code> {{optional_inline}}</dt> - <dd>O ponto da string a partir do qual a procura deverá começar. Pode ter o valor de um qualquer inteiro. O valor por predefinição é 0. Se o <code>fromIndex < 0</code> a procura é feita em toda a string (o mesmo que passar o valor 0). Se <code>fromIndex >= str.length</code>, o método retornará -1, exceção feita quando o valor de <code>searchValue</code> é uma string vazia, nesse caso retorna <code>str.length</code>.</dd> -</dl> - -<h2 id="Descrição">Descrição</h2> - -<p>Os caractéres numa string são indexadas da esquerda para a direita. O índice do primeira caractér é 0, e o índice do último caractér da string, chamado de <code>stringName,</code> é <code>stringName.length - 1</code>.</p> - -<pre class="brush: js">'Blue Whale'.indexOf('Blue'); // retorna 0 -'Blue Whale'.indexOf('Blute'); // retorna -1 -'Blue Whale'.indexOf('Whale', 0); // retorna 5 -'Blue Whale'.indexOf('Whale', 5); // retorna 5 -'Blue Whale'.indexOf('', 9); // retorna 9 -'Blue Whale'.indexOf('', 10); // retorna 10 -'Blue Whale'.indexOf('', 11); // retorna 10 -</pre> - -<h3 id="Case-sensitivity">Case-sensitivity</h3> - -<p>O método <code>indexOf()</code> é sensível a maiúsculas e minúsculas. Por exemplo, a seguinte expressão retorna -1:</p> - -<pre class="brush: js">'Blue Whale'.indexOf('blue'); // retorna -1 -</pre> - -<h3 id="Verificando_ocorrências">Verificando ocorrências</h3> - -<p>Repara que '0' não é avaliado como <code>true</code> e '-1' não é avaliado como <code>false</code>. Sendo assim, a forma correta de verificar se uma string específica existe dentro de outra string deverá ser:</p> - -<pre class="brush: js">'Blue Whale'.indexOf('Blue') !== -1; // true -'Blue Whale'.indexOf('Bloe') !== -1; // false -</pre> - -<h2 id="Exemplos">Exemplos</h2> - -<h3 id="Usando_indexOf()_e_lastIndexOf()">Usando <code>indexOf()</code> e <code>lastIndexOf()</code></h3> - -<p>O seguinte exemplo usa <code>indexOf()</code> e {{jsxref("String.prototype.lastIndexOf()", "lastIndexOf()")}} para localizar valores na string <code>"Brave new world"</code>.</p> - -<pre class="brush: js">var anyString = 'Brave new world'; - -console.log('O índice do primeiro w desde o início é ' + anyString.indexOf('w')); -// imprime 8 -console.log('O índice do primeiro w desde o fim é ' + anyString.lastIndexOf('w')); -// imprime 10 - -console.log('O índice de "new" desde o início é ' + anyString.indexOf('new')); -// imprime 6 -console.log('O índice de "new" desde o fim é ' + anyString.lastIndexOf('new')); -// imprime 6 -</pre> - -<h3 id="indexOf()_e_sensibilidade_a_maiúsculas_e_minúsculas"><code>indexOf()</code> e sensibilidade a maiúsculas e minúsculas</h3> - -<p>O seguinte exemplo define duas variáveis do tipo string. As variáveis contêm a mesma string exceto o facto da segunda string conter as todas as letras maiúsculas. O primeiro método {{domxref("console.log()")}} apresenta 19. Mas porque o método <code>indexOf()</code> é sensível a maiúsculas e minúsculas, a string <code>"cheddar"</code> não é encontrada em <code>myCapString</code>, logo o segundo método <code>console.log()</code> apresenta -1.</p> - -<pre class="brush: js">var myString = 'brie, pepper jack, cheddar'; -var myCapString = 'Brie, Pepper Jack, Cheddar'; - -console.log('myString.indexOf("cheddar") é ' + myString.indexOf('cheddar')); -// imprime 19 -console.log('myCapString.indexOf("cheddar") é ' + myCapString.indexOf('cheddar')); -// imprime -1 -</pre> - -<h3 id="Usando_indexOf()_para_contar_as_ocorrências_de_uma_letra_numa_string">Usando <code>indexOf()</code> para contar as ocorrências de uma letra numa string</h3> - -<p>O seguinte exemplo atribuí à variável <code>count</code> o número de ocorrências da letra 'e' na string <code>str</code>:</p> - -<pre class="brush: js">var str = 'To be, or not to be, that is the question.'; -var count = 0; -var pos = str.indexOf('e'); - -while (pos !== -1) { - count++; - pos = str.indexOf('e', pos + 1); -} - -console.log(count); // imprime 4 -</pre> - -<h2 id="Especificações">Especificações</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Especificação</th> - <th scope="col">Estado</th> - <th scope="col">Comentário</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Definição inicial.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5.4.7', 'String.prototype.indexOf')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-string.prototype.indexof', 'String.prototype.indexOf')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilidade_dos_browsers">Compatibilidade dos browsers</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Funcionalidade</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Suporte básico</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>Funcionalidade</th> - <th>Android</th> - <th>Chrome para Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Suporte básico</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="Ver_também">Ver também</h2> - -<ul> - <li>{{jsxref("String.prototype.charAt()")}}</li> - <li>{{jsxref("String.prototype.lastIndexOf()")}}</li> - <li>{{jsxref("String.prototype.split()")}}</li> - <li>{{jsxref("Array.prototype.indexOf()")}}</li> -</ul> |