String.prototype.indexOf()

Zusammenfassung

Die indexOf() Methode gibt den Index der Zeichenkette innerhalb des aufrufenden String Objekts des ersten Vorkommnis des angegebenen Wertes beginnend bei fromIndex. Gibt -1 wenn der Wert nicht gefunden wurde.

Syntax

str.indexOf(searchValue[, fromIndex])

Parameter

searchValue

Ein String der den zu suchenden Wert repräsentiet.

fromIndex

Optional. Die Position, innerhalb des aufrufenden Strings, ab der gesucht werden soll. Dieser kann jeden Integerwert annehmen. Der Standartwert ist 0. Falls fromIndex < 0 wird der gesammte String durchsucht (genauso wenn man 0 übergibt). Wenn fromIndex >= str.length, wird die Methode -1 zurückgeben, außer searchValue ist ein leerer String, dann wird str.length zurückgegeben.

Beschreibung

Die Zeichen in einem String sind von links nach rechts nummeriert. Der index des ersten Zeichens ist 0, und der Indes des letzten Zeichens eines Strings mit Namen stringName ist stringName.length - 1.

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

Groß- und Kleinschreibung

Die indexOf() Methode unterscheidet zwischen Groß- und Kleinschreibung. Zum Beispiel gibt die folgende Zeile -1 zurück:

'Blue Whale'.indexOf('blue'); // returns -1

Vorkommnisse prüfen

Note that '0' doesn't evaluate to true and '-1' doesn't evaluate to false. Therefore, when checking if a specific string exists within another string the correct way to check would be:

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

Beispiele

Beispiel: indexOf() und lastIndexOf()

Die folgenden Beispiele benutzen indexOf() und lastIndexOf() um Werte im String "Brave new world" zu finden.

var anyString = 'Brave new world';

console.log('The index of the first w from the beginning is ' + anyString.indexOf('w'));
// Displays 8
console.log('The index of the first w from the end is ' + anyString.lastIndexOf('w'));
// Displays 10

console.log('The index of "new" from the beginning is ' + anyString.indexOf('new'));
// Displays 6
console.log('The index of "new" from the end is ' + anyString.lastIndexOf('new'));
// Displays 6

Beispiel: indexOf() und Groß- und Kleinschreibung

Das folgende Beispiel definiert zwei Strings. Die Variablen enthalten den selben String, außer dass der zweite String Großbuchstaben enthält. Die erste console.log() Methode zeigt 19. Da die indexOf() Methode Groß- und Kleinschreibung unterscheidet, wird der String"cheddar" im String myCapString nicht gefunden. Deshalb gibt die zweite console.log() method -1 zurück.

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

console.log('myString.indexOf("cheddar") is ' + myString.indexOf('cheddar'));
// Displays 19
console.log('myCapString.indexOf("cheddar") is ' + myCapString.indexOf('cheddar'));
// Displays -1

Example: Using indexOf() to count occurrences of a letter in a string

Das folgende Beispiel setzt count auf die Anzahl der Vorkommnisse des Buchstaben e in dem String str:

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); // displays 4

Spezifikationen

Browserkompatibilität

Links

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