String-Manipulation

Aus Asprova Hilfe
Version vom 7. Januar 2019, 17:19 Uhr von GK (Diskussion | Beiträge) (Überarbeitung und Ergänzung um neue Funktionen)
Wechseln zu: Navigation, Suche
Hilfe Nummer: 741510
Interne Funktionen
Formeleditor

Asprova stellt Ihnen die folgenden Funktionen zur Manipulation von Strings (Zeichenketten, Texten) zur Verfügung.

Find( str, strSearch )

Argumente str Quellstring
strSearch Zu suchender String
Rückgabewert Sucht in strSearch nach str. Wird str gefunden, so wird TRUE zurückgegeben, sonst FALSE.
Beispiele Find('abcde','bc') TRUE
Find('abcde','xy') FALSE

StrStr( str, strSearch )

Argumente str Quellstring
strSearch Zu suchender String
Rückgabewert Sucht in strSearch nach str. Wird str gefunden, so wird dessen Position zurückgegeben, sonst 0.
Beispiele StrStr('abcde','bc') 2
StrStr('abcde','xy') 0

Left( str, length )

Argumente str Quellstring
length Integer, Länge des Rückgabewerts
Rückgabewert Gibt die ersten length Zeichen von str zurück.
Beispiel Left('abcde',3) "abc"

LeftB( str, length, flag )

Argumente str Quellstring
length Integer, Länge des Rückgabewerts in Bytes
flag 0, falls Mehrbytezeichen geteilt werden dürfen
1, falls der Rückgabewert verlängert werden muss, um Mehrbytezeichen komplett zu enthalten
Rückgabewert Gibt die ersten length Zeichen von str zurück.
Beispiele LeftB('あい12うえお34',7,0) "あい12"
LeftB('あい12うえお34',7,1) "あい12う"
Hinweis Unterscheidet sich von Left() durch die Unterstützung von Mehrbytezeichen, die in einigen Sprachen wie Japanisch vorkommen, in denen ein Zeichen für die Kodierung zwei Bytes benötigt.

Right( str, length )

Argumente str Quellstring
length Integer, Länge des Rückgabewerts
Rückgabewert Gibt die letzten length Zeichen von str zurück.
Beispiel Right('abcde',3) "cde"

RightB( str, length, flag )

Argumente str Quellstring
length Integer, Länge des Rückgabewerts in Bytes
flag 0, falls Mehrbytezeichen geteilt werden dürfen
1, falls der Rückgabewert verlängert werden muss, um Mehrbytezeichen komplett zu enthalten
Rückgabewert Gibt die letzten length Zeichen von str zurück.
Beispiele RightB('あい12うえお34',7,0) "えお34"
RightB('あい12うえお34',7,1) "うえお34"
Hinweis Unterscheidet sich von Right() durch die Unterstützung von Mehrbytezeichen, die in einigen Sprachen wie Japanisch vorkommen, in denen ein Zeichen für die Kodierung zwei Bytes benötigt.

Len( str )

Argument str Quellstring
Rückgabewert Gibt die Anzahl an Zeichen in str zurück.
Beispiel Len('abcde') 5

LenB( str )

Argument str Quellstring
Rückgabewert Gibt die Anzahl an Bytes in str zurück.
Beispiel LenB('あいcde') 7
Hinweis Unterscheidet sich von Len() durch die Unterstützung von Mehrbytezeichen, die in einigen Sprachen wie Japanisch vorkommen, in denen ein Zeichen für die Kodierung zwei Bytes benötigt.

Mid( str, start, length )

Argumente str Quellstring
start Startposition des Rückgabewerts, mindestens 1
length Integer, Länge des Rückgabewerts
Rückgabewert Gibt die length Zeichen ab start in str zurück. Ist start größer als die Länge von str, so wird ein leerer String zurückgegeben.
Beispiel Mid('abcde',2,3) "bcd"
Hinweis

Die erste Position von str ist 1.

GenStrSerialNum ( serialNum, length )

Argumente serialNum Seriennummer
length Ziffernanzahl der Seriennummer
Rückgabewert Gibt serialNum als String zurück, der mit führenden Nullen auf length Zeichen verlängert wird.
Beispiel GenStrSerialNum(5,3) "005"

Substitute ( str, strSearch, strSubs, index )

Argumente str Quellstring
strSearch Zu suchender String
strSubs Neuer String
index Integer, definiert welcher Treffer ersetzt wird, falls strSearch in str mehrfach gefunden wird.
Bei negativem Wert wird vom Ende von str aus nach links gezählt. Bei 0 werden alle Treffer ersetzt
Rückgabewert Gibt str zurück, in dem strSearch mit strSubs ersetzt wurde.
Beispiele Substitute('abcabc','ab','xy',1) "xycabc"
Substitute('abcabc','ab','xy',0) "xycxyc"
Substitute('abcabc','ab','xy',-1) "abcxyc"
Substitute('aaa','aa','a',0) "aa"

Replace( str, start, length, strRepl )

Argumente str Quellstring
start Startposition der zu ersetzenden Zeichen
length Anzahl der zu ersetzenden Zeichen
strRepl Neuer String
Rückgabewert Gibt str zurück, in dem ab dem start-Zeichen length Zeichen durch strRepl ersetzt wurden.
Beispiele Replace('abcde',1,1,'xy') "xybcde"
Replace('abcde',1,2,'xy') "xycde"
Replace('abcde',1,3,'xy') "xyde"

Hilfe Nummer: 741510