TypedArray.prototype.lastIndexOf()

La méthode lastIndexOf() renvoie le dernier indice (le plus grand) pour lequel un élément donné est trouvé. Si l'élément cherché n'est pas trouvé, la valeur de retour sera -1. Le tableau typé est parcouru dans l'ordre des indices décroissants (de la fin vers le début) à partir de indexDépart. Cette méthode utilise le même algorithme que Array.prototype.lastIndexOf(). Dans le reste de l'article, TypedArray correspond à l'un des types de tableaux typés.

Syntaxe

typedarray.lastIndexOf(élémentRecherché[, indiceDépart = typedarray.length])

Paramètres

élémentRecherché

L'élément qu'on souhaite situer dans le tableau.

indiceDépart

Paramètre optionnel qui représente l'indice à partir duquel parcourir le tableau dans le sens inverse. La valeur par défaut correspond à la longueur du tableau (c'est-à-dire que tout le tableau sera parcouru). Si l'indice est supérieur ou égal à la longueur du tableau typé, tout le tableau typé sera parcouru. Si la valeur est négative, le parcours commencera à length+indiceDépart (le sens de parcours ne change pas). Si l'indice calculé est négatif, la valeur de retour sera -1 et le tableau ne sera pas parcouru.

Valeur de retour

Le dernier indice du tableau typé pour lequel l'élément a été trouvé ou -1 s'il n'a pas été trouvé.

Description

lastIndexOf compare élémentRecherché avec les éléments du tableau typé en utilisant l'égalité stricte (celle utilisée par l'opérateur ===).

Exemples

var uint8 = new Uint8Array([2, 5, 9, 2]);
uint8.lastIndexOf(2);     // 3
uint8.lastIndexOf(7);     // -1
uint8.lastIndexOf(2, 3);  // 3
uint8.lastIndexOf(2, 2);  // 0
uint8.lastIndexOf(2, -2); // 0
uint8.lastIndexOf(2, -1); // 3

Spécifications

Compatibilité des navigateurs

Notes de compatibilité

• À partir de Firefox 47 ((Firefox 47 / Thunderbird 47 / SeaMonkey 2.44)), cette méthode ne renverra plus -0. Ainsi, new Uint8Array([0]).lastIndexOf(0, -0) renverra toujours +0 (cf. bug 1242043).

Voir aussi

• TypedArray.prototype.indexOf()
• Array.prototype.lastIndexOf()