strspn

(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.

Beschreibung

int strspn ( string $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");
?>
ordnet 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.

Parameter-Liste

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.

Rückgabewerte

Gibt die Länge des Abschnittes am Anfang von subject zurück, der vollständig aus in mask angegebenen Zeichen besteht.

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:

int(0)
int(2)
int(1)

Anmerkungen

Hinweis: Diese Funktion ist binary safe.

Siehe auch

  • strcspn() - Ermittelt die Anzahl der nicht übereinstimmenden Zeichen