Function.spliti

Aus PHP-Wiki

spliti — Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks ohne Berücksichtigung von Groß-/Kleinschreibung in ein Array

Beschreibung

array spliti ( string $Suchmuster , string $Zeichenkette [, int $Beschränkung ] )

Zerlegt Zeichenkette anhand eines regulären Ausdrucks in ein Array. Diese Funktion entspricht split() mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet.

Parameter-Liste

Suchmuster

• Regulärer Ausdruck ohne Berücksichtigung der Groß- und Kleinschreibung Wenn Sie eine Zerlegung an Zeichen vornehmen, die in regulären Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie diese entsprechend kennzeichnen. Wenn Sie der Ansicht sind, spliti() (oder, bei diesem Thema, eine andere Regex-Funktion) verhalte sich seltsam, lesen Sie bitte die Datei regex.7, die sich im regex/ Unterverzeichnis ihrer PHP-Distribution befindet. Da sie im manpage-Fomat vorliegt, sollten Sie einen Befehl der Art man /usr/local/src/regex/regex.7 verwenden, um sie zu lesen.

Zeichenkette

• Die zu durchsuchende Zeichenkette

Beschränkung

• Wenn Beschränkung gesetzt wurde, enthält das zurückgegebene Array höchstens Beschränkung Elemente, von denen das letzte den ganzen Rest von Zeichenkette enthält.

Rückgabewerte

Gibt ein Array mit Zeichenketten zurück, die jeweils eine Teilzeichenkette von Zeichenkette sind. Diese Teilzeichenketten entstehen durch Zerlegung von Zeichenkette an den durch den regulären Ausdruck Suchmuster bestimmten Stellen ohne Berücksichtigung der Groß- und Kleinschreibung. Wenn Suchmuster n mal vorkommt, enhält das zurückgegebene Array n+1 Elemente. Kommt Suchmuster zum Beispiel überhaupt nicht vor, wird ein Array mit nur einem Element zurückgegeben. Das gilt natürlich auch, wenn Zeichenkette leer ist. Bei Auftreten eines Fehlers gibt spliti() FALSE zurück.

Beispiele

Dieses Beispiel verwendet 'a' als Trennzeichen um eine Zeichenkette zu zerlegen:

#1 spliti()

<?php
$zeichenkette = "aBBBaCCCADDDaEEEaGGGA";
$stuecke = spliti ("a", $zeichenkette, 5);
print_r($stuecke);
?>

Das oben gezeigte Beispiel erzeugt folgende
Ausgabe:

Array
(
  [0] =>
  [1] => BBB
  [2] => CCC
  [3] => DDD
  [4] => EEEaGGGA
)

Siehe auch

• preg_split()
• split()
• explode()
• implode()