====== 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: =====


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>


**Verwendung einer Zeichenkette als Trennungsmerkmal:** @Rg_Betreff = „Test Erechnung&#xD;&#xA;Zeile 2“

<code>SplitToArray( @Rg_Betreff, '&#xD;&#xA;', true(), true(), true() )</code>


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