strrpos
strstr
String-Funktionen
PHP Manual

# 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 `start`n 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.

  Wurde`start` übergeben und ist negativ, wird strspn() beginnen `subject` an der `start`n 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.

### Changelog

Version | Beschreibung
--- | ---
4.3.0 | Die Parameter `start` und `length` wurden hinzugefügt.

### 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

strrpos
strstr
String-Funktionen
PHP Manual