String-Manipulation: Unterschied zwischen den Versionen
Aus Asprova Hilfe
GK (Diskussion | Beiträge) K (GK verschob die Seite String Vorgänge nach String-Manipulation) |
GK (Diskussion | Beiträge) (→Replace( str, start, length, strRepl )) |
||
| (4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | {{DISPLAYTITLE:String | + | {{DISPLAYTITLE:String-Manipulation}} |
<div align="right">Hilfe Nummer: 741510</div> | <div align="right">Hilfe Nummer: 741510</div> | ||
| − | + | <div align="right">[[Interne Funktionen]]</div> | |
| − | <div align="right">[[Formeleditor | + | <div align="right">[[Formeleditor]]</div> |
<hr> | <hr> | ||
| − | |||
| + | Asprova stellt Ihnen die folgenden Funktionen zur Manipulation von Strings (Zeichenketten, Texten) zur Verfügung. | ||
| − | Find( str, strSearch ) | + | == Find( str, strSearch ) == |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="2"|Parameter | |
| − | + | |width="1px"|''str''||Quellstring | |
| − | + | |- | |
| + | |''strSearch''||Zu suchender String | ||
| + | |- | ||
| + | !Rückgabewert | ||
| + | |colspan="2"|Sucht in ''strSearch'' nach ''str''. Wird ''str'' gefunden, so wird TRUE zurückgegeben, sonst FALSE. | ||
|- | |- | ||
| − | | | + | !rowspan="2"|Beispiele |
| + | |<code>Find('abcde','bc')</code>||TRUE | ||
|- | |- | ||
| − | || | + | |<code>Find('abcde','xy')</code>||FALSE |
|- | |- | ||
|} | |} | ||
| − | Rückgabewert | + | == StrStr( str, strSearch ) == |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="2"|Parameter | |
| + | |width="1px"|''str''||Quellstring | ||
| + | |- | ||
| + | |''strSearch''||Zu suchender String | ||
| + | |- | ||
| + | !Rückgabewert | ||
| + | |colspan="2"|Sucht in ''strSearch'' nach ''str''. Wird ''str'' gefunden, so wird dessen Position zurückgegeben, sonst 0. | ||
| + | |- | ||
| + | !rowspan="2"|Beispiele | ||
| + | |<code>StrStr('abcde','bc')</code>||2 | ||
|- | |- | ||
| − | | | + | |<code>StrStr('abcde','xy')</code>||0 |
|- | |- | ||
|} | |} | ||
| − | + | == Left( str, length ) == | |
| − | + | {| class="wikitable" | |
| − | |||
| − | {| | ||
|- | |- | ||
| − | | | + | !rowspan="2"|Parameter |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | |''length''||Integer, Länge des Rückgabewerts |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|Gibt die ersten ''length'' Zeichen von ''str'' zurück. | ||
|- | |- | ||
| − | || | + | !Beispiel |
| + | |<code>Left('abcde',3)</code>||"abc" | ||
|- | |- | ||
|} | |} | ||
| − | + | === LeftB( str, length, flag ) === | |
| − | + | {| class="wikitable" | |
| − | |||
| − | {| | ||
|- | |- | ||
| − | | | + | !rowspan="4"|Parameter |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | |''length''||Integer, Länge des Rückgabewerts in Bytes |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |rowspan="2"|''flag''||0, falls Mehrbytezeichen geteilt werden dürfen |
|- | |- | ||
| − | | | + | |1, falls der Rückgabewert verlängert werden muss, um Mehrbytezeichen komplett zu enthalten |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|Gibt die ersten ''length'' Zeichen von ''str'' zurück. | ||
|- | |- | ||
| − | || | + | !rowspan="2"|Beispiele |
| + | |<span style="white-space: nowrap;"><code>LeftB('あい12うえお34',7,0)</code></span>||"あい12" | ||
|- | |- | ||
| − | | | + | |<code>LeftB('あい12うえお34',7,1)</code>||"あい12う" |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Hinweis |
| + | |colspan="2"|Unterscheidet sich von <code>Left()</code> durch die Unterstützung von [https://docs.microsoft.com/de-de/cpp/c-language/multibyte-and-wide-characters Mehrbytezeichen], die in einigen Sprachen wie Japanisch vorkommen, in denen ein Zeichen für die Kodierung zwei Bytes benötigt. | ||
|- | |- | ||
|} | |} | ||
| − | + | == Right( str, length ) == | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="2"|Parameter | |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | |''length''||Integer, Länge des Rückgabewerts |
|- | |- | ||
| − | | | + | !Rückgabewert |
| − | + | |colspan="2"|Gibt die letzten ''length'' Zeichen von ''str'' zurück. | |
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Beispiel |
| + | |<code>Right('abcde',3)</code>||"cde" | ||
|- | |- | ||
|} | |} | ||
| − | + | === RightB( str, length, flag ) === | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="4"|Parameter | |
| − | + | |width="1px"|''str''||Quellstring | |
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |''length''||Integer, Länge des Rückgabewerts in Bytes |
|- | |- | ||
| − | || | + | |rowspan="2"|''flag''||0, falls Mehrbytezeichen geteilt werden dürfen |
|- | |- | ||
| − | | | + | |1, falls der Rückgabewert verlängert werden muss, um Mehrbytezeichen komplett zu enthalten |
|- | |- | ||
| − | + | !Rückgabewert | |
| − | + | |colspan="2"|Gibt die letzten ''length'' Zeichen von ''str'' zurück. | |
| − | |||
|- | |- | ||
| − | | | + | !rowspan="2"|Beispiele |
| + | |<span style="white-space: nowrap;"><code>RightB('あい12うえお34',7,0)</code></span>||"えお34" | ||
|- | |- | ||
| − | + | |<code>RightB('あい12うえお34',7,1)</code>||"うえお34" | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Hinweis |
| + | |colspan="2"|Unterscheidet sich von <code>Right()</code> durch die Unterstützung von [https://docs.microsoft.com/de-de/cpp/c-language/multibyte-and-wide-characters Mehrbytezeichen], die in einigen Sprachen wie Japanisch vorkommen, in denen ein Zeichen für die Kodierung zwei Bytes benötigt. | ||
|- | |- | ||
|} | |} | ||
| − | + | == Len( str ) == | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !Parameter | |
| − | + | |width="1px"|''str''||Quellstring | |
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|Gibt die Anzahl an Zeichen in ''str'' zurück. | ||
|- | |- | ||
| − | || | + | !Beispiel |
| + | |<code>Len('abcde')</code>||5 | ||
|- | |- | ||
|} | |} | ||
| − | + | === LenB( str ) === | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !Parameter | |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|Gibt die Anzahl an Bytes in ''str'' zurück. | ||
|- | |- | ||
| − | + | !Beispiel | |
| − | + | |<span style="white-space: nowrap;"><code>LenB('あいcde')</code></span>||7 | |
| − | Beispiel | ||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Hinweis |
| + | |colspan="2"|Unterscheidet sich von <code>Len()</code> durch die Unterstützung von [https://docs.microsoft.com/de-de/cpp/c-language/multibyte-and-wide-characters Mehrbytezeichen], die in einigen Sprachen wie Japanisch vorkommen, in denen ein Zeichen für die Kodierung zwei Bytes benötigt. | ||
|- | |- | ||
|} | |} | ||
| − | + | == Mid( str, start, length ) == | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="3"|Parameter | |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | |''start''||Startposition des Rückgabewerts, mindestens 1 |
|- | |- | ||
| − | | | + | |''length''||Integer, Länge des Rückgabewerts |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|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 |
| + | |<code>Mid('abcde',2,3)</code>||"bcd" | ||
|- | |- | ||
| − | || | + | !Hinweis |
| − | + | |colspan="2"| | |
| + | Die erste Position von ''str'' ist 1. | ||
|- | |- | ||
|} | |} | ||
| − | + | == GenStrSerialNum( serialNum, length ) == | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="2"|Parameter | |
| + | |width="1px"|''serialNum''||Seriennummer | ||
|- | |- | ||
| − | | | + | |''length''||Ziffernanzahl der Seriennummer |
|- | |- | ||
| − | | | + | !Rückgabewert |
| − | + | |colspan="2"|Gibt ''serialNum'' als String zurück, der mit führenden Nullen auf ''length'' Zeichen verlängert wird. | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Beispiel |
| + | |<code>GenStrSerialNum(5,3)</code>||"005" | ||
|- | |- | ||
|} | |} | ||
| − | + | == Substitute( str, strSearch, strSubs, index ) == | |
| − | + | {| class="wikitable" | |
| − | |||
| − | {| | ||
|- | |- | ||
| − | | | + | !rowspan="4"|Parameter |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | |''strSearch''||Zu suchender String |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |''strSubs''||Neuer String |
|- | |- | ||
| − | | | + | |''index''||Integer, definiert welcher Treffer ersetzt wird, falls ''strSearch'' in ''str'' mehrfach gefunden wird.<br>Bei negativem Wert wird vom Ende von ''str'' aus nach links gezählt. Bei 0 werden alle Treffer ersetzt |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|Gibt ''str'' zurück, in dem ''strSearch'' mit ''strSubs'' ersetzt wurde. | ||
|- | |- | ||
| − | | | + | !rowspan="4"|Beispiele |
| − | + | |<code>Substitute('abcabc','ab','xy',1)</code>||"xycabc" | |
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |<code>Substitute('abcabc','ab','xy',0)</code>||"xycxyc" |
|- | |- | ||
| − | | | + | |<code>Substitute('abcabc','ab','xy',-1)</code>||"abcxyc" |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |<code>Substitute('aaa','aa','a',0)</code>||"aa" |
|- | |- | ||
|} | |} | ||
| − | + | == Replace( str, start, length, strRepl ) == | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !rowspan="4"|Parameter | |
| − | + | |width="1px"|''str''||Quellstring | |
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |''start''||Startposition der zu ersetzenden Zeichen |
|- | |- | ||
| − | || | + | |''length''||Anzahl der zu ersetzenden Zeichen |
|- | |- | ||
| − | || | + | |''strRepl''||Neuer String |
|- | |- | ||
| − | + | !Rückgabewert | |
| − | + | |colspan="2"|Gibt ''str'' zurück, in dem ab dem ''start''-Zeichen ''length'' Zeichen durch ''strRepl'' ersetzt wurden. | |
| − | Rückgabewert | ||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | !rowspan="3"|Beispiele |
| + | |<code>Replace('abcde',1,1,'xy')</code>||"xybcde" | ||
|- | |- | ||
| − | | | + | |<code>Replace('abcde',1,2,'xy')</code>||"xycde" |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |<code>Replace('abcde',1,3,'xy')</code>||"xyde" |
|- | |- | ||
|} | |} | ||
| − | + | == Lower( str ) == | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | !Parameter | |
| + | |width="1px"|''str''||Quellstring | ||
|- | |- | ||
| − | | | + | !Rückgabewert |
| + | |colspan="2"|Gibt ''str'' in Kleinbuchstaben zurück. | ||
|- | |- | ||
| − | | | + | !rowspan="3"|Beispiele |
| − | + | |<code>Lower('abcde')</code>||"abcde" | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |<code>Lower('Abcde')</code>||"abcde" |
|- | |- | ||
| − | || | + | |<code>Lower('ABCDE')</code>||"abcde" |
|- | |- | ||
|} | |} | ||
| − | + | ; Hinweis : Erst ab Version 16.0 verfügbar. | |
| − | + | == Upper( str ) == | |
| − | {| | + | {| class="wikitable" |
| + | |- | ||
| + | !Parameter | ||
| + | |width="1px"|''str''||Quellstring | ||
| + | |- | ||
| + | !Rückgabewert | ||
| + | |colspan="2"|Gibt ''str'' in Kleinbuchstaben zurück. | ||
|- | |- | ||
| − | | | + | !rowspan="3"|Beispiele |
| + | |<code>Upper('abcde')</code>||"ABCDE" | ||
|- | |- | ||
| − | | | + | |<code>Upper('Abcde')</code>||"ABCDE" |
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|- | |- | ||
| − | | | + | |<code>Upper('ABCDE')</code>||"ABCDE" |
|- | |- | ||
|} | |} | ||
| + | ; Hinweis : Erst ab Version 16.0 verfügbar. | ||
<hr> | <hr> | ||
<div align="right">Hilfe Nummer: 741510</div> | <div align="right">Hilfe Nummer: 741510</div> | ||
Aktuelle Version vom 28. Juli 2020, 14:02 Uhr
Hilfe Nummer: 741510
Asprova stellt Ihnen die folgenden Funktionen zur Manipulation von Strings (Zeichenketten, Texten) zur Verfügung.
Inhaltsverzeichnis
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