Méthode indexOf

  • Raccourci de la révision : Référence_de_JavaScript_1.5_Core/Objets_globaux/String/indexOf
  • Titre de la révision : Méthode indexOf sur une chaîne de caractères
  • ID de la révision : 343731
  • Créé :
  • Créateur : tregagnon
  • Version actuelle ? Non
  • Commentaire

Contenu de la révision

Résumé

Retourne pour la chaîne de caractère (String)  sur laquelle a été appelée la méthode, l'index de la première occurence pour la valeur renseignée, en commençant la recherche à partir de fromIndex.

Retourne -1 si aucune valeur n'a été trouvée.

Méthode de String
Implementé dans JavaScript 1.0
Édition ECMAScript ECMAScript 1ère édition

Syntaxe

string.indexOf(searchValue[, fromIndex])

Paramètres

searchValue
La chaîne de caractères à rechercher.
fromIndex
La position dans la chaîne de caractères à partir de laquelle commencer la recherche. Peut être un entier entre 0 et la longueur de la chaîne de caractères. La valeur par défaut est 0.

Description

Les caractères dans une chaîne de caractères sont indexés de la gauche à la droite. L'index du premier caractère est 0. Et l'index du dernier caractère dans une chaîne de caractères appelée stringName est stringName.length - 1.

"Blue Whale".indexOf("Blue");     // retourne  0
"Blue Whale".indexOf("Blute");    // retourne -1
"Blue Whale".indexOf("Whale", 0); // retourne  5
"Blue Whale".indexOf("Whale", 5); // retourne  5
"Blue Whale".indexOf("", 9);      // retourne  9
"Blue Whale".indexOf("", 10);     // retourne 10
"Blue Whale".indexOf("", 11);     // retourne 10

La méthode indexOf est sensible à la casse. Par exemple, l'expression suivante retourne -1 :

"Blue Whale".indexOf("blue") // retourne -1

Notez que '0' n'est pas évalué comme true et que '-1' n'est pas évalué comme false. Ainsi, quand vous testez si une chaîne de caractères existe au sein d'une autre chaîne de caractères, il vous faut procéder de cette façon :

"Blue Whale".indexOf("Blue") != -1; // true
"Blue Whale".indexOf("Bloe") != -1; // false

Exemples

Exemple: Utiliser indexOf et lastIndexOf

L'exemple suivant utilise indexOf et lastIndexOf pour localiser différentes valeurs dans la chaîne de caractères "Brave new world".

var anyString="Brave new world"

document.write(
    "<P>The index of the first w from the beginning is " +
    anyString.indexOf("w")
); // Affiche 8

document.write(
    "<P>The index of the first w from the end is " +
    anyString.lastIndexOf("w")
); // Affiche 10

document.write(
    "<P>The index of 'new' from the beginning is " +
    anyString.indexOf("new")
); // Affiche 6

document.write(
    "<P>The index of 'new' from the end is " +
    anyString.lastIndexOf("new")
); // Affiche 6

Exemple: indexOf et la sensibilité à la casse

L'exemple suivant définit 2 chaînes de caractères. Ces variables contiennent la meme chaîne de caractères sauf que la seconde chaîne de caractères contient des lettres majuscules. La première méthode writeln affiche 19. Mais comme la méthode indexOf est sensible à la casse, la chaîne de caractères "cheddar" n'est pas trouvé dans myCapString, donc la seconde méthode writeln affiche -1.

var myString = "brie, pepper jack, cheddar";
var myCapString = "Brie, Pepper Jack, Cheddar";

document.writeln(
    'myString.indexOf("cheddar") is ' +
    myString.indexOf("cheddar")
);
document.writeln(
    '<P>myCapString.indexOf("cheddar") is ' +
    myCapString.indexOf("cheddar")
);

Exemple: Utiliser indexOf pour compter le nombre d'occurences dans une chaîne de caractères

L'exemple suivant utilise la variable count pour stocker le nombre d'occurences de la lettre x dans la chaîne de caractère str :

var count = 0;
var pos = str.indexOf("x");

while ( pos != -1 ) {
   count++;
   pos = str.indexOf( "x",pos + 1 );
}

Voir aussi

Source de la révision

<h2 id="Summary" name="Summary">Résumé</h2>
<p>Retourne pour la chaîne de caractère (<code>String</code>)&nbsp; sur laquelle a été appelée la méthode, l'index de la première occurence pour la valeur renseignée, en commençant la recherche à partir de <code>fromIndex. </code></p>
<p>Retourne -1 si aucune valeur n'a été trouvée.</p>
<table class="standard-table">
  <thead>
    <tr>
      <th class="header" colspan="2">Méthode de <a href="/en-US/docs/JavaScript/Reference/Global_Objects/String" title="JavaScript/Reference/Global_Objects/String"><code>String</code></a></th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Implementé dans</td>
      <td>JavaScript 1.0</td>
    </tr>
    <tr>
      <td>Édition ECMAScript</td>
      <td>ECMAScript 1ère édition</td>
    </tr>
  </tbody>
</table>
<h2 id="Syntax" name="Syntax">Syntaxe</h2>
<pre class="syntaxbox">
<code><em>string</em>.indexOf(<em>searchValue</em>[, <em>fromIndex</em>]</code>)</pre>
<h3 id="Parameters" name="Parameters">Paramètres</h3>
<dl>
  <dt>
    <code>searchValue</code></dt>
  <dd>
    La chaîne de caractères à rechercher.</dd>
  <dt>
    <code>fromIndex</code></dt>
  <dd>
    La position dans la chaîne de caractères à partir de laquelle commencer la recherche. Peut être un entier entre 0 et la longueur de la chaîne de caractères. La valeur par défaut est 0.</dd>
</dl>
<h2 id="Description" name="Description">Description</h2>
<p>Les caractères dans une chaîne de caractères sont indexés de la gauche à la droite. L'index du premier caractère est 0. Et l'index du dernier caractère dans une chaîne de caractères appelée <code>stringName</code> est <code>stringName.length - 1.</code></p>
<pre class="brush: js">
"Blue Whale".indexOf("Blue");     // retourne  0
"Blue Whale".indexOf("Blute");    // retourne -1
"Blue Whale".indexOf("Whale", 0); // retourne  5
"Blue Whale".indexOf("Whale", 5); // retourne  5
"Blue Whale".indexOf("", 9);      // retourne  9
"Blue Whale".indexOf("", 10);     // retourne 10
"Blue Whale".indexOf("", 11);     // retourne 10</pre>
<p>La méthode <code>indexOf</code> est sensible à la casse. Par exemple, l'expression suivante retourne -1 :</p>
<pre class="brush: js">
"Blue Whale".indexOf("blue") // retourne -1
</pre>
<p>Notez que '<code>0</code>' n'est pas évalué comme<code> true</code> et que '<code>-1</code>' n'est pas évalué comme <code>false</code>. Ainsi, quand vous testez si une chaîne de caractères existe au sein d'une autre chaîne de caractères, il vous faut procéder de cette façon :</p>
<pre class="brush: js">
"Blue Whale".indexOf("Blue") != -1; // true
"Blue Whale".indexOf("Bloe") != -1; // false</pre>
<h2 id="Examples" name="Examples">Exemples</h2>
<h3 id="Example:_Using_indexOf_and_lastIndexOf" name="Example:_Using_indexOf_and_lastIndexOf">Exemple: Utiliser <code>indexOf</code> et <code>lastIndexOf</code></h3>
<p>L'exemple suivant utilise indexOf et lastIndexOf pour localiser différentes valeurs dans la chaîne de caractères "<code>Brave new world</code>".</p>
<pre class="brush: js">
var anyString="Brave new world"

document.write(
    "&lt;P&gt;The index of the first w from the beginning is " +
    anyString.indexOf("w")
); // Affiche 8

document.write(
    "&lt;P&gt;The index of the first w from the end is " +
    anyString.lastIndexOf("w")
); // Affiche 10

document.write(
    "&lt;P&gt;The index of 'new' from the beginning is " +
    anyString.indexOf("new")
); // Affiche 6

document.write(
    "&lt;P&gt;The index of 'new' from the end is " +
    anyString.lastIndexOf("new")
); // Affiche 6
</pre>
<h3 id="Example:_indexOf_and_case-sensitivity" name="Example:_indexOf_and_case-sensitivity">Exemple: <code>indexOf</code> et la sensibilité à la casse</h3>
<p>L'exemple suivant définit 2 chaînes de caractères. Ces variables contiennent la meme chaîne de caractères sauf que la seconde chaîne de caractères contient des lettres majuscules. La première méthode <code>writeln</code> affiche 19. Mais comme la méthode <code>indexOf</code> est sensible à la casse, la chaîne de caractères "<code>cheddar</code>" n'est pas trouvé dans <code>myCapString</code>, donc la seconde méthode <code>writeln</code> affiche -1.</p>
<pre class="brush: js">
var myString = "brie, pepper jack, cheddar";
var myCapString = "Brie, Pepper Jack, Cheddar";

document.writeln(
    'myString.indexOf("cheddar") is ' +
    myString.indexOf("cheddar")
);
document.writeln(
    '&lt;P&gt;myCapString.indexOf("cheddar") is ' +
    myCapString.indexOf("cheddar")
);</pre>
<h3 id="Example:_Using_indexOf_to_count_occurrences_of_a_letter_in_a_string" name="Example:_Using_indexOf_to_count_occurrences_of_a_letter_in_a_string">Exemple: Utiliser <code>indexOf</code> pour compter le nombre d'occurences dans une chaîne de caractères</h3>
<p>L'exemple suivant utilise la variable <code>count</code> pour stocker le nombre d'occurences de la lettre <code>x</code> dans la chaîne de caractère <code>str</code> :</p>
<pre class="brush: js">
var count = 0;
var pos = str.indexOf("x");

while ( pos != -1 ) {
   count++;
   pos = str.indexOf( "x",pos + 1 );
}</pre>
<h2 id="See_also" name="See_also">Voir aussi</h2>
<ul>
  <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/charAt" title="JavaScript/Reference/Global_Objects/String/charAt">String.charAt</a></li>
  <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/lastIndexOf" title="JavaScript/Reference/Global_Objects/String/lastIndexOf">String.lastIndexOf</a></li>
  <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/split" title="JavaScript/Reference/Global_Objects/String/split">String.split</a></li>
  <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/indexOf" title="JavaScript/Reference/Global Objects/Array/indexOf">Array.indexOf</a></li>
</ul>
<!-- languages({
"es": "es/Referencia_de_JavaScript_1.5/Objetos_globales/String/indexOf",
"ja": "ja/JavaScript/Reference/Global_Objects/String/indexOf",
"pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/String/indexOf"
}) -->
Revenir à cette révision