====== SplitToArray ======

Die Funktion SplitToArray Teilt eine Zeichenkette nach einer Liste von Trennzeichen auf und liefert eine Struktur zurück, welche eine Iteration im RuleSet erlaubt

==== Syntax: ====

<code>SplitToArray ('Zeichenkette','Trennzeichen/Zeichenkette', boolean, boolean, boolean)</code>

Parameter:
  - Zeichenkette die zu splitten ist
  - Trennzeichen oder Zeichenkette, welche(s) die Trennung triggert
  - Leere Werte Entfernen: **true**((default Value))/false
  - Werte trimmen: **true**((default Value))/false
  - Trennzeichen ist ein String: true/**false**((default Value)), falls dieser optionale Parameter verwendet wird, dann kann der zweite Parameter als Zeichenkette angegeben werden und triggert den/die Splitpunkt(e).


===== Beispiel: =====


**Trennung nach Zeichenkette** 

Liefert drei Items, ohne dem letzten Parameter für 'Trennzeichen ist ein String' wären es **vier** Items:
<code>SplitToArray( 'This is a test invoice&#xD;&#xA;&#xD;&#xA;Dagobert Duck&#xD;&#xA;999.999,01', '&#xD;&#xA;', true(), true(), true() )</code>


Liefert zwei Items, ohne dem letzten Parameter für 'Trennzeichen ist ein String' wären es **sechs** Items:
<code>SplitToArray( 'Z1, Z2, Z1, Z1, Z1, Z1', 'Z2', true(), true(), true() )</code>


**Trennung nach Zeichen** 

Das folgende Beispiel liefert fünf Struktureinträge mit Index 0 - 4 und den Werten dazu.
<code>SplitToArray("Paul;Mustermann;Straße 22;99999,Ort", ";,")</code>


Im nächsten Beispiel wird der Wert "Straße 22" zurückgegeben.
<code>SplitToArray("Paul;Mustermann;Straße 22;99999,Ort", ";,")/Items[@Index = 2]/@Value</code>

Ohne Angabe vom dritten parameter, werden Leerwerte entfernt, daher liefert die nächste Anweisung den Wert: "99999"
<code>SplitToArray("Paul;; Straße 22,,;99999,Ort", ";,")/Items[@Index = 2]/@Value</code>

Der folgende "count" liefert: 4
<code>count(SplitToArray("Paul;; Street 22,,;99999,City", ";,")/Items) </code>

Ohne Entfernung von Leerwerte und ohne Trim, durch setzen der Parameter drei und vier auf false, liefert diese Ausführung daher den Wert: " Straße 22"
<code>SplitToArray("Paul;; Straße 22,,;99999,Ort", ";,", false, false)/Items[@Index = 2]/@Value</code>





{{:images:sign_warning.png?nolink|}} Hinweis: [[howtos:buildhierarchwithsplittoarray|]]