array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.strcspn.php', 1 => 'strcspn', 2 => 'Ermittelt die Anzahl der nicht übereinstimmenden Zeichen', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.strcoll.php', 1 => 'strcoll', ), 'next' => array ( 0 => 'function.strip-tags.php', 1 => 'strip_tags', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/strings/functions/strcspn.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

strcspn

(PHP 4, PHP 5, PHP 7, PHP 8)

strcspn — Ermittelt die Anzahl der nicht übereinstimmenden Zeichen

Beschreibung

strcspn(
    string $string,
    string $characters,
    int $offset = 0,
    ?int $length = null
): int

Gibt die Länge des Anfangssegments von string zurück, bis zu der kein Zeichen aus characters vorkommt.

Wenn die Parameter offset und length weggelassen werden, dann wird string komplett untersucht. Werden sie angegeben, dann ist es gleichwertig zum Aufruf von strcspn(substr($string, $offset, $length), $characters) (für weitere Informationen siehe substr).

Parameter-Liste

string

Die zu untersuchende Zeichenkette.

characters

Die Zeichenkette, die alle nicht erlaubten Zeichen enthält.

offset

Die Position in string, an der die Suche beginnt.

Wird offset angegeben und ist nicht negativ, dann beginnt strcspn()string an der Position offset zu untersuchen. Beispielsweise ist in der Zeichenkette 'abcdef' das Zeichen an Position 0 ein 'a', das Zeichen an Position 2 ein 'c', usw.

Wird offset angegeben und ist negativ, dann beginnt strcspn() string an der Position offset vom Ende von string aus betrachtet zu untersuchen.

length

Die Länge des Segments von string, das untersucht werden soll.

Wird length angegeben und ist nicht negativ, dann werden bis zu length Zeichen von string nach der Anfangsposition untersucht.

Wird length angegeben und ist negativ, dann wird string von der Anfangsposition bis zu length Zeichen vom Ende von string aus betrachtet untersucht.

Rückgabewerte

Gibt die Länge des Anfangssegments von string zurück, das ausschließlich aus Zeichen besteht, die nicht in characters vorkommen.

Hinweis:

Wird der Parameter offset angegeben, zählt die zurückgegebene Länge von dieser Position aus, nicht vom Anfang von string.

Changelog

Version Beschreibung
8.4.0 Wenn vor PHP 8.4.0 characters eine leere Zeichenkette war, wurde die Suche fälschlicherweise beim ersten Null-Byte in string beendet.
8.0.0 length ist jetzt nullable (akzeptiert den null-Wert).

Beispiele

Beispiel #1 strcspn()-Beispiel

<?php
$a = strcspn('banana', 'a');
$b = strcspn('banana', 'abcd');
$c = strcspn('banana', 'z');
$d = strcspn('abcdhelloabcd', 'a', -9);
$e = strcspn('abcdhelloabcd', 'a', -9, -5);

var_dump($a);
var_dump($b);
var_dump($c);
var_dump($d);
var_dump($e);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

int(1)
int(0)
int(6)
int(5)
int(4)

Anmerkungen

Hinweis: Diese Funktion ist binärsicher.

Siehe auch