(PHP 4, PHP 5)
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
]] )
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");
?>
subject das ausschließlich aus Zeichen besteht,
die in der Menge "1234567890" enthalten sind.
subject
Die zu untersuchende Zeichenkette.
mask
Die 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.
| Version | Beschreibung |
|---|---|
| 4.3.0 |
Die Parameter start und length
wurden hinzugefügt.
|
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.