von Centura Team Developer, Gupta bzw. SQLWindows
nNumTokens = SalStrTokenize ( strSource, strStartDel, strEndDel, strTokenArray )
Zerlegt eine Zeichenfolge in Teilstücke entsprechend den angegebenen Start- und Endbegrenzern.
Centura interpretiert das erste Zeichen, das ungleich dem Startbegrenzer ist,
als den Anfang eines Teilstücks und ignoriert alle davor liegenden Startbegrenzer.
Wenn das erste Zeichen, das ungleich dem Startbegrenzer ist, aber gleich dem Endbegrenzer ist,
dann wird dies als STRING_Null - Teilstück interpretiert. Dies ist für Komma
getrennte Teilstücke günstig, wo der Endbegenzer ',' ist. Centura erkennt, daß
"Data1,Data2,,Data4" und ",Data2,Data3,Data4" vier Teilstücke haben, mit je einem,
was STRING_Null ist.
Sobald Centura den Anfang eines Teilstückes findet, interpretiert es alle folgenden
Zeichen, als Elemente dieses Teilstückes, bis es einen Endbegrenzer findet.
Zum Beispiel wenn '!' der Startbegrenzer und '?' der Endbegrenzer ist, so ergibt
die Zeichenfolge 'Abc!Def?Ghi!' die Teilstücke: 'Abc!Def' und 'Ghi!'.
Obwohl das Ausrufezeichen der Startbegrenzer ist, interpretiert Centura sie richtig
als Elemente des Teilstückes.
| Parameter | ||
| String: | StrSource | Die zu zerlegende Zeichenfolge. |
| String: | StrStartDel |
Ein Zeichen, das den Startbegrenzer enthält. Leer ('') bedeutet, daß es keinen Startbegrenzer gibt |
| String: | StrEndDel |
Ein Zeichen, das den Endbegrenzer enthält. Leer ('') bedeutet, daß es keinen Endbegrenzer gibt |
| String Array: | StrTokenArray | Das Feld, daß die Teilstücke von StrSource nach StrStartDel und StrEndDel als Ergebnis des Funktionsaufrufes enthält. |
| Begrenzerzeichen ? = jedes Zeichen ist ein Trenner! Es können keine Text-Stückchen oder ganze Zeichenketten als Trenner (= Delimiter = 'Del') angegeben werden. | ||
| Rückgabewert | ||
| Number: | nNumTokens | Anzahl der gebildeten Teilstücke. Er ist Null (0), wenn kein Teilstück existiert. |
| 1 = SalStrTokenize( 'Hallo', '!', '', as_Teile ) | ||
| as_Teile[0] = Hallo | ||
| 1 = SalStrTokenize('!!Hallo', '!', '', as_Teile ) | ||
| as_Teile[0] = Hallo | ||
| 2 = SalStrTokenize('Abc!Def?Ghi!', '!', '?', as_Teile ) | ||
| as_Teile[0] = Abc!Def | ||
| as_Teile[1] = Ghi! | ||
| 3 = SalStrTokenize( 'data1,data2,,data4', ',', ',', as_Teile ) | ||
| as_Teile[0] = data1 | ||
| as_Teile[1] = data2 | ||
| as_Teile[2] = data4 | ||
| 4 = SalStrTokenize('data1,data2,,data4', '', ',', as_Teile ) | ||
| as_Teile[0] = data1 | ||
| as_Teile[1] = data2 | ||
| as_Teile[2] = STRING_Null | ||
| as_Teile[3] = data4 | ||