f$TextZerlegen (Englisch: f$Splitstring)

Diese Funktion zerlegt eine Zeichenkette in ein Feld. Das Trennzeichen bzw. der Trennstring kann beliebig mitgegeben werden.

Falls Teile der Zeichenkette in " eingeschlossen sind, wird ein Trennstring innerhalb dieses Bereichs ignoriert. Falls ein " im Text enthalten sein soll, so ist dieses mit sich selbst zu maskieren (""). Diese Funktion eignet sich gut, um Dateien, die im CSV Format (beispielsweise aus Excel) geschrieben wurden, zu verarbeiten. Ist der Trennstring in der Zeichenkette nicht enthalten, so wird die gesamte Zeichenkette auf dem 1. Feldindex zurückgegeben.

Syntax:	Anzahl = f$TextZerlegen( Quelltext , NameFeld , Trenner )
	Argument	Typ	Bedeutung
	Quelltext	Zeichenkette	Die zu verarbeitende Zeichenkette
	NameFeld	Zeichenkette	Name eines indizierten Zeichenkettenparameters, auf den das Ergebnis geschrieben wird. Anstelle eines einfach indizierten Parameters kann auch auch ein einfacher Parameter einer einfach indizierten Parametergruppe verwendet werden.
	Trenner	Zeichenkette	Das Trennzeichen bzw. der Trennstring
Ergebnis:	Ganzzahl	Anzahl der aufgeteilten Teilstrings. Wenn das Feld zu klein dimensioniert ist, wird eine negative Anzahl zurückgegeben.
Beispiel:	Text = '1,2,3"" (Zoll),"4 " , 5,6,"a,b",7' Anzahl = f$TextZerlegen(Text,'PG[1].Name',',') Ergebnis: Anzahl = 8 Feldelemente: 1 2 3" (Zoll) 4 gefolgt von einem Leerzeichen 5 6 a,b 7