String.prototype.lastIndexOf()

La méthode lastIndexOf() renvoie l'indice, dans la chaîne courante, de la dernière occurence de la valeur donnée en argument. Si cette sous-chaîne n'est pas trouvée, la méthode renvoie -1. La recherche s'effectue de la fin vers le début de la chaîne, à partir de indiceDébut.

Syntaxe

str.lastIndexOf(valeurRecherchée[, indiceDébut])

Paramètres

valeurRecherchée

Une chaîne qu'on recherche dans la chaîne courante. Si ce paramètre n'est pas défini et que indiceDébut est utilisé, c'est ce dernier qui sera renvoyé par la fonction.

indiceDébut Facultatif

Paramètre optionnel. L'emplacement, dans la chaîne courante, à partir duquel effectuer la recherche (en partant de la fin de la chaîne et en remontant vers le début). Cela peut être n'importe quel entier. La valeur par défaut est =Infinity. Si indiceDébut > str.length, toute la chaîne sera parcourue. Si indiceDébut < 0,  on aura le même comportement que si indiceDébut valait 0.

Valeur de retour

L'indice de la dernière occurrence de la valeur indiquée, -1 si elle n'est pas trouvée.

Description

Les caractères d'une chaîne de caractères sont indexés de gauche à droite. L'indice du premier caractère vaut 0 et l'indice du dernier caractère vaut maChaîne.length - 1.

'canal'.lastIndexOf('a');     // renvoie 3
'canal'.lastIndexOf('a', 2);  // renvoie 1
'canal'.lastIndexOf('a', 0);  // renvoie -1
'canal'.lastIndexOf('x');     // renvoie -1
'canal'.lastIndexOf('c', -1); // renvoie 0 comme lastIndexOf('c',0)

Sensibilité à la casse

La méthode lastIndexOf() est sensible à la casse. Ainsi, le résultat de l'expression suivante sera -1 :

'Blue Whale, Killer Whale'.lastIndexOf('blue'); // renvoie -1

Exemples

Utiliser indexOf() et lastIndexOf()

Dans l'exemple suivant, on utilise indexOf() et lastIndexOf() pour situer certaines valeurs dans la chaîne "Brave new world".

var maChaîne = 'Brave new world';

console.log('Indice du premier w ' + maChaîne.indexOf('w'));
// Affiche 8
console.log('Indice du dernier w ' + maChaîne.lastIndexOf('w')); 
// Affiche 10

console.log('Indice du premier "new" ' + maChaîne.indexOf('new'));
// Affiche 6
console.log('Indice du dernier "new" ' + maChaîne.lastIndexOf('new'));
// Affiche 6

Spécifications

Compatibilité des navigateurs

Voir aussi

• String.prototype.charAt()
• String.prototype.indexOf()
• String.prototype.split()
• Array.prototype.indexOf()
• Array.prototype.lastIndexOf()