PHP Dokumentation: Function stripos
12. Januar 2010 von werner
stripos
(PHP 5)
stripos — Findet das erste Vorkommen eines Strings, unabhängig von Groß- und Kleinschreibung
Beschreibung
Gibt die numerische Position des ersten Vorkommens von needle innerhalb des Strings haystack zurück.
Im Gegensatz zu strpos() ist stripos() unabhängig von Groß- und Kleinschreibung.
Parameter-Liste
- haystack
Die Zeichenkette, in der gesucht werden soll.
- needle
Beachten Sie, dass needle eine Zeichenkette von einem oder mehreren Zeichen sein kann.
Ist needle kein String, wird der Parameter in einen Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht.
- offset
Der optionale Parameter offset erlaubt Ihnen anzugeben, ab welchem Zeichen in haystack die Suche begonnen werden soll. Die zurückgegebene Position bezieht sich jedoch auf den Anfang von haystack.
Rückgabewerte
Wenn needle nicht gefunden wird, gibt stripos() den boolean-Wert FALSE zurück.
Diese Funktion kann sowohl dasboolsche FALSE zurückliefern, als auch einen nicht-boolschen Wert, wie zumBeispiel 0 oder "", der von einem einfachenif-Statement als FALSE ausgewertet wird. Weitere Informationen entnehmen Siebitte dem Abschnitt über die boolschen Typen. Benutzen Sie deshalbden === Operator,um den Rückgabewert dieser Funktion zu überprüfen.
Beispiele
Beispiel #1 stripos()-Beispiele
<?php
$findmich = 'a';
$meinstring1 = 'xyz';
$meinstring2 = 'ABC';$pos1 = stripos($meinstring1, $findmich);
$pos2 = stripos($meinstring2, $findmich);// 'a' ist natürlich nicht in 'xyz' enthalten
if ($pos1 === false) {
echo "Die Zeichenkette '$findmich' kommt nicht im String '$meinstring1' vor.";
}// Beachten Sie die Verwendung von ===. Ein einfaches == funktioniert nicht wie
// erwartet, da 'a' an Position 0 (also erster!) Stelle steht
if ($pos2 !== false) {
echo "Die Zeichenkette '$findmich' wurde in '$meinstring2' an Position $pos2 gefunden";
}
?>Anmerkungen
Hinweis: Diese Funktion ist binary safe.
Siehe auch
- strpos() – Sucht das erste Vorkommen des Suchstrings
- strrpos() – Findet das letzte Vorkommen eines Zeichens innerhalb einer Zeichenkette
- strrchr() – Sucht das letzte Vorkommen eines Zeichens in einem String
- substr() – Gibt einen Teil eines Strings zurück
- stristr() – Wie strstr, aber unabhängig von Groß- bzw. Kleinschreibung
- strstr() – Findet das erste Vorkommen eines Strings
- strripos() – Findet das letzte Vorkommen der gesuchten Zeichenkette in einem String, unabhängig von Groß- und Kleinschreibung
- str_ireplace() – Groß- und kleinschreibungsunabhängige Version von str_replace