array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.str-split.php', 1 => 'str_split', 2 => 'Konvertiert einen String in ein Array', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.str-shuffle.php', 1 => 'str_shuffle', ), 'next' => array ( 0 => 'function.str-starts-with.php', 1 => 'str_starts_with', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/strings/functions/str-split.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_split

(PHP 5, PHP 7, PHP 8)

str_split — Konvertiert einen String in ein Array

Beschreibung

str_split(string $string, int $length = 1): array

Konvertiert 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.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.

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:

Bei einer mehrbytekodierten Zeichenkette zerlegt str_split() die Zeichenkette in Bytes statt in Zeichen. Mit mb_str_split() kann die Zeichenkette in Codepunkte zerlegt werden und mit grapheme_str_split() in Grapheme-Cluster.

Siehe auch