(PHP 4, PHP 5, PHP 7)
strspn — Ermittelt die Länge des initialen Abschnitts einer Zeichenkette, der ausschließlich aus Zeichen besteht, die in einer übergebenen Maske enthalten sind
$subject
, string $mask
[, int $start
[, int $length
]] ) : int
Ermittelt die Länge des initialen Abschnitts von subject
der ausschließlich Zeichen
aus mask enthält.
Wenn start und length
ausgelassen werden, werden alle Zeichen von subject
untersucht. Wenn sie enthalten sind, ist das Ergebnis das Gleiche wie der
Aufruf strspn(substr($subject, $start, $length),
$mask) (siehe substr
für mehr Informationen).
Die Zeile
<?php
$var = strspn("42 ist die Antwort, was auf die 128. Frage?", "1234567890");
?>
2 der Variable $var zu, da der
String "42" das ist der initiale Abschnitt
des subject das ausschließlich aus Zeichen besteht,
die in der Menge "1234567890" enthalten sind.
subjectDie zu untersuchende Zeichenkette.
maskDie Menge der erlaubten Zeichen.
start
Die Position in subject an der die Suche
startet.
Wurde start übergeben und ist nicht-negativ,
wird strspn()
beginnen subject an der
startn Position zu untersuchen. Zum Beispiel in
der Zeichenkette 'abcdef', das Zeichen an Position
0 ist 'a', das Zeichen an
Position 2 ist 'c' und so weiter.
Wurdestart übergeben und ist negativ, wird
strspn() beginnen subject an
der startn Position vom Ende von
subject zu untersuchen.
length
Die zu untersuchende Länge des Abschnitts
von subject.
Wurde start übergeben und ist nicht-negativ,
werden length Zeichen
von subject nach der Startposition untersucht.
Wurde start übergeben und ist negativ,
wird subject von der Startposition bis zu
length Zeichen vom Ende von
subject untersucht.
Gibt die Länge des Abschnittes am Anfang von subject
zurück, der vollständig aus in mask angegebenen
Zeichen besteht.
Hinweis:
Wird der
startParameter angegeben, dann zählt die zurückgegebene Länge von dieser Position, nicht vom Anfang vonsubject.
Beispiel #1 strspn()-Beispiel
<?php
// subject beginnt nicht mit einem der Zeichen aus mask
var_dump(strspn("foo", "o"));
// Untersuche zwei Zeichen aus subject beginnend bei Offset 1
var_dump(strspn("foo", "o", 1, 2));
// Untersuche ein Zeichen aus subject beginnend bei Offset 1
var_dump(strspn("foo", "o", 1, 1));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
int(0) int(2) int(1)
Hinweis: Diese Funktion ist binary safe.