(PHP 5, PHP 7, PHP 8)
str_split — Konvertiert einen String in ein Array
Konvertiert eine Zeichenkette in ein Array.
string
Die Eingabezeichenkette
length
Maximale Länge eines Teilstücks
Wenn der optionale Parameter length
angegeben wurde,
enthält das zurückgegebene Array Elemente mit der in
length
definierten Länge. Eine Ausnahme bildet das
letzte Teilstück, das kürzer sein kann, wenn die Zeichenkette nicht
gleichmäßig aufgeteilt ist. Der Standardwert von
length
ist 1
, was bedeutet, dass
jeder Abschnitt ein Byte groß ist.
Wenn der Parameter length
kleiner ist als
1
, wird ein ValueError ausgelöst.
Version | Beschreibung |
---|---|
8.2.0 |
Wenn string eine leere Zeichenkette ist, wird
nun ein leeres Array zurückgegeben; davor wurde ein Array mit einer
einzelnen leeren Zeichenkette zurückgegeben.
|
8.0.0 |
Wenn der Parameter length kleiner ist als
1 , wird nun ein ValueError
ausgelöst; davor wurde ein Fehler der Stufe
E_WARNING ausgelöst und die Funktion gab false
zurück.
|
Beispiel #1 Beispiel für die Verwendung von str_split()
<?php
$str = "Hallo Freund";
$arr1 = str_split($str);
$arr2 = str_split($str, 3);
print_r($arr1);
print_r($arr2);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => H [1] => a [2] => l [3] => l [4] => o [5] => [6] => F [7] => r [8] => e [9] => u [10] => n [11] => d ) Array ( [0] => Hal [1] => lo [2] => Fre [3] => und )
Hinweis:
Wenn eine Multibyte-kodierte Zeichenkette vorliegt, trennt str_split() in Bytes anstatt Zeichen. Mit mb_str_split() kann die Zeichenkette in Codepunkte zerlegt werden.