String-Manipulation

Aus Asprova Hilfe
(Weitergeleitet von String Vorgänge)
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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

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

LenB( str )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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 )

Parameter 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"

Lower( str )

Parameter str Quellstring
Rückgabewert Gibt str in Kleinbuchstaben zurück.
Beispiele Lower('abcde') "abcde"
Lower('Abcde') "abcde"
Lower('ABCDE') "abcde"
Hinweis 
Erst ab Version 16.0 verfügbar.

Upper( str )

Parameter str Quellstring
Rückgabewert Gibt str in Kleinbuchstaben zurück.
Beispiele Upper('abcde') "ABCDE"
Upper('Abcde') "ABCDE"
Upper('ABCDE') "ABCDE"
Hinweis 
Erst ab Version 16.0 verfügbar.

Hilfe Nummer: 741510