PHP Handbuch
Zurück |  | Weiter

# strpos

(PHP 3, PHP 4, PHP 5)

strpos -- Sucht das erste Vorkommen des Suchstrings

## Beschreibung

int strpos ( string haystack, mixed needle [, int offset] )

Gibt die numerische Position des ersten Vorkommens von `needle` innerhalb der Zeichenkette `haystack` zurück. Anders als strrpos() akzeptiert diese Funktion eine komplette Zeichenkette als `needle`-Parameter und verwendet den gesamten String zur Suche.

Wurde `needle` nicht gefunden, gibt strpos() den boolean-Wert `FALSE` zurück.

Warnung
Diese Funktion kann sowohl das Boolsche `FALSE` zurückliefern, als auch einen nicht-Boolschen Wert, wie zum Beispiel`0` oder "". der von einem einfachen if-Statement als `FALSE` ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die Boolsche Typen. Benutzen Sie deshalb den === Operator um den Rückgabewert dieser Funktion zu überprüfen.

> Anmerkung: Diese Funktion ist binary safe.

Beispiel 1. strpos()-Beispiel:
`<?php $meinString = 'abc'; $findMich = 'a'; $pos = strpos($meinString, $findMich); // Beachten Sie die Verwendung von ===. Ein einfacher Vergleich (==) liefert // nicht das erwartete Ergebnis, da die Position von 'a' die nullte Stelle // (also das erste Zeichen) ist if ($pos === false) { echo "Der Stringg '$findMich' wurde nicht im String '$meinString' gefunden"; } else { echo "Der Stringg '$findMich' wurde im String '$meinString' gefunden"; echo " und steht an Stelle $pos"; } // Wir koennen nach einem Zeichen suchen und dabei alles vor dem Offset ignorieren $newstring = 'abcdef abcdef'; $pos = strpos($newstring, 'a', 1); // $pos = 7, nicht 0 ?>`

Ist `needle` kein String, wird der Parameter in einen Integerwert konvertiert, der dem Ordinalwert des Zeichens entspricht.

Der optionale Parameter `offset` ermöglicht es Ihnen, die Startposition für die Suche innerhalb von `haystack` anzugeben. Die zurück gegebene Positions-Angabe ist dann relativ zum Anfang von `haystack`.

Siehe auch strrpos(), stripos(), strripos(), strrchr(), substr(), stristr() und strstr().

Zurück | Zum Anfang | Weiter
strpbrk | Nach oben | strrchr