blob: f004d4193b5ff8f609a14386cd87e84f6410c9ab [file] [log] [blame]
MG Mud User88f12472016-06-24 23:31:02 +02001SYNOPSIS
Zesstrad59c3892019-11-28 20:53:39 +01002 string * explode(string str, string del)
3 bytes * explode(bytes str, bytes del)
MG Mud User88f12472016-06-24 23:31:02 +02004
5BESCHREIBUNG
6 Liefert ein Feld (Array) mit Zeichenketten (Strings), indem alle
7 Vorkommen von del (delimiter = Trenner) aus str herausgeschnitten
Zesstrad59c3892019-11-28 20:53:39 +01008 werden und so str in mehrere Zeichenketten zerlegt wird. Falls
9 eine Bytefolge uebergeben wurde, so wird diese in gleicher Weise
10 zerschnitten und zurueckgegeben.
MG Mud User88f12472016-06-24 23:31:02 +020011
12 implode(explode(str, del), del) == str ist immer wahr.
13
14BEISPIELE
15 Funktion Rueckgabewert
16 -------------------------------------------------------------------
17 explode(" ab cd ef ", " ") ({ "", "ab", "cd", "ef", "" })
18 explode("abc", "abc") ({ "", "" })
Zesstrad59c3892019-11-28 20:53:39 +010019 explode("", "") ({ "" })
20 explode("", <whatever>) ({ "" })
MG Mud User88f12472016-06-24 23:31:02 +020021 explode("abc", "xyz") ({ "abc" })
22 explode("abc", "") ({ "a", "b", "c" })
23
Zesstrad59c3892019-11-28 20:53:39 +010024GESCHICHTE
MG Mud User88f12472016-06-24 23:31:02 +020025 Zeitpunkt der Aenderung unbekannt.
26 explode(" ab cd ef ", " ") lieferte frueher ({ "ab", "cd", "ef" })
27 anstatt ({ "", "ab", "cd", "ef", "" }), d. h., leere Zeichenketten
28 wurden ignoriert. Das neue Verhalten ist schoener, da nun
29 implode(explode(str, del), del) == str immer wahr ist.
Zesstrad59c3892019-11-28 20:53:39 +010030 Seit 3.5.0 liefert explode("","") ({""}) zurueck, sodass garantiert
31 ist, dass ein nicht-leeres Array geliefert wird.
MG Mud User88f12472016-06-24 23:31:02 +020032
33SIEHE AUCH
Zesstrad59c3892019-11-28 20:53:39 +010034 sscanf(E), extract(E), implode(E), regexplode(E)