strspn
(PHP 4, PHP 5, PHP 7, PHP 8)
strspn —
Ermittelt die Länge des initialen Abschnitts einer Zeichenkette, der
ausschließlich aus Zeichen besteht, die in einer übergebenen Maske
enthalten sind
Beschreibung
strspn
( string $string
, string $characters
, int $offset
= 0
, int|null $length
= null
) : int
Wenn offset
und length
ausgelassen werden, werden alle Zeichen von string
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
ordnet
2
der Variable
$var zu, da der
String "42" das ist der initiale Abschnitt des
string
das ausschließlich aus Zeichen besteht, die
in der Menge "1234567890" enthalten sind.
Parameter-Liste
-
string
-
Die zu untersuchende Zeichenkette.
-
characters
-
Die Menge der erlaubten Zeichen.
-
offset
-
Die Position in string
an der die Suche startet.
Wurde offset
übergeben und ist nicht negativ,
beginnt strspn() die Untersuchung von
string
an der offset
'ten
Position. Zum Beispiel ist in der Zeichenkette
'abcdef
' das Zeichen an Position
0
'a
', das Zeichen an Position
2
ist 'c
' usw.
Wurdeoffset
übergeben und ist negativ, beginnt
strspn() die Untersuchung von
string
an der offset
'ten
Position vom Ende von string
aus betrachtet.
-
length
-
Die zu untersuchende Länge des Abschnitts von
string
.
Wurde offset
übergeben und ist nicht-negativ,
werden length
Zeichen
von string
nach der Startposition untersucht.
Wurde offset
übergeben und ist negativ,
wird string
von der Startposition bis zu
length
Zeichen vom Ende von
string
untersucht.
Rückgabewerte
Gibt die Länge des Abschnittes am Anfang von string
zurück, der vollständig aus in characters
angegebenen
Zeichen besteht.
Hinweis:
Wird der offset
-Parameter angegeben, dann zählt die
zurückgegebene Länge von dieser Position, nicht vom Anfang von
string
.
Beispiele
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:
Anmerkungen
Hinweis:
Diese Funktion ist binary safe.
Siehe auch
- strcspn() - Ermittelt die Anzahl der nicht übereinstimmenden Zeichen