str_split
(PHP 5, PHP 7, PHP 8)
str_split — Konvertiert einen String in ein Array
Beschreibung
$string, int $length = 1): arrayKonvertiert eine Zeichenkette in ein Array.
Parameter-Liste
-
string -
Die Eingabezeichenkette.
-
length -
Maximale Länge eines Teilstücks.
Rückgabewerte
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.
Fehler/Exceptions
Wenn der Parameter length kleiner ist als
1, wird ein ValueError ausgelöst.
Changelog
| Version | Beschreibung |
|---|---|
| 8.0.0 |
Wenn der Parameter length kleiner ist als
1, wird nun ein ValueError
ausgelöst; vorher wurde ein Fehler der Stufe
E_WARNING ausgelöst und die Funktion gab false
zurück.
|
Beispiele
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
)
Anmerkungen
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.
Siehe auch
- mb_str_split() - Given a multibyte string, return an array of its characters
- chunk_split() - Zerlegt einen String in Teile gleicher Länge
- preg_split() - Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks
- explode() - Teilt eine Zeichenkette anhand einer Zeichenkette
- count_chars() - Gibt Informationen über die in einem String enthaltenen Zeichen zurück
- str_word_count() - Liefert Informationen über in einem String verwendete Worte
- for
