Freigeben über


Zeichenfolgen-Laufzeitfunktionen für X++

Hinweis

Community-Interessensgruppen sind jetzt von Yammer zu Microsoft Viva Engage gewechselt. Um an einer Viva Engage-Community teilzunehmen und an den neuesten Diskussionen teilzunehmen, füllen Sie das Formular "Anfordern des Zugriffs auf Finance and Operations Viva Engage Community" aus , und wählen Sie die Community aus, der Sie beitreten möchten.

In diesem Artikel werden die Zeichenfolgenausführungsfunktionen beschrieben.

Streichholz

Sucht nach einer Zeichenfolge oder einem Ausdruck in einer anderen Zeichenfolge.

int match(str pattern, str text)

Die Parameter

Parameter Description
pattern Die Zeichenfolge oder der Ausdruck, nach der gesucht werden soll.
Text Die zu durchsuchende Zeichenfolge.

Rückgabewert

1 , wenn sich das Muster in der Zeichenfolge befindet; andernfalls 0 (null).

Bemerkungen

Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Die folgenden Sonderzeichen können verwendet werden, um das Muster für den Musterparameter zu erstellen.

  • \: Ein umgekehrter Schrägstrich (\) nullisiert oder escapes, die Sonderbehandlung von Sonderzeichen, sodass ein Sonderzeichen wie ein normaler Buchstabe abgeglichen werden kann. Ein Paar umgekehrter Schrägstrich wird in einen nichtspecialen umgekehrten Schrägstrich übersetzt. Beispiele

    • match("ab$cd","ab$cd"); gibt 0 zurück.
    • match("ab\$cd","ab$cd"); gibt 0 zurück. Der umgekehrte Schrägstrich wird nicht escaped.
    • match("ab\\$cd","ab$cd"); gibt 1 zurück. Das umgekehrte Schrägstrich und das Dollarzeichen werden escaped.
  • < oder ^: Eine linke eckige Klammer (<) oder eine Zirkumflex (^) am Anfang eines Ausdrucks wird verwendet, um dem Anfang einer Zeile zu entsprechen. Beispiele

    • match("<abc","abcdef"); gibt 1 zurück.
    • match("<abc","defabc"); gibt 0 zurück.
    • match("^abc","abcdef"); gibt 1 zurück.
    • match("^abc","defabc"); gibt 0 zurück.
  • > oder $: Eine rechtwinklige Klammer (>) oder ein Dollarzeichen ($) am Ende des Ausdrucks wird verwendet, um dem Ende einer Zeile zu entsprechen. Beispiele

    • match("abc","abcdef>"); gibt 0 zurück.
    • match("abc>","defabc"); gibt 1 zurück.
  • ? oder.: Ein Fragezeichen (?) oder ein Punkt (.) entspricht einem zeichen in derselben Position. Beispiele

    • match("abc.def","abc#def"); gibt 1 zurück.
    • match("colou?r","colouXr"); gibt 1 zurück.
  • :x: Ein Doppelpunkt (:) gibt eine Gruppe von Zeichen an, die übereinstimmen sollen, wie durch das Zeichen angegeben, das unmittelbar folgt.

  • :a: Legt die Übereinstimmung auf Buchstaben fest. Beispiele

    • match("ab:acd","ab#cd"); gibt 0 zurück.
    • match("ab:acd","abxyzcd"); gibt 0 zurück.
    • match("ab:acd","abxcd"); gibt 1 zurück.
  • :d: Legt die Übereinstimmung auf numerische Zeichen fest. Beispiele

    • match("ab:dcd","ab3cd"); gibt 1 zurück.
    • match("ab:dcd","ab123cd"); gibt 0 zurück.
    • match("ab:dcd","abcd"); gibt 0 zurück.
  • :n: Legt die Übereinstimmung auf alphanumerische Zeichen fest. Beispiele

    • match("ab:ncd","ab%cd"); gibt 0 zurück.
    • match("ab:ncd","ab9cd"); gibt 1 zurück.
    • match("ab:ncd","abXcd"); gibt 1 zurück.
  • :LEERZEICHEN: LEERZEICHEN ist das Leerzeichen (" "). Legt die Übereinstimmung auf Leerzeichen, Tabulationen und Steuerelementzeichen fest, z. B. die EINGABETASTE (neue Zeile). Beispiele

    • match("ab: cd","ab cd"); gibt 1 zurück.
    • match("ab: cd","ab\ncd"); gibt 1 zurück.
    • match("ab: cd","ab\tcd"); gibt 1 zurück.
    • match("ab: cd","ab cd"); gibt 0 zurück. Nur der erste Leerraum ist übereinstimmend.
  • *: Ein Ausdruck, auf den ein Sternchen ("*") folgt, erfordert eine Übereinstimmung für Null, ein oder mehrere Vorkommen des vorherigen Ausdrucks. Beispiele

    • match("abc*d";"abd"); gibt 1 zurück.
    • match("abc*d","abcd"); gibt 1 zurück.
    • match("abc*d","abcccd"); gibt 1 zurück.
    • match("abc*d","abxd"); gibt 0 zurück.
  • +: Ein Ausdruck, auf den ein Pluszeichen folgt (+) erfordert eine Übereinstimmung für ein oder mehrere Vorkommen des vorherigen Ausdrucks. Beispiele

    • match("abc+d","abd"); gibt 0 zurück.
    • match("abc+d","abcd"); gibt 1 zurück.
    • match("abc+d","abcccd"); gibt 1 zurück.
    • match("abc+d","abxd"); gibt 0 zurück.
  • -: Ein Ausdruck, auf den ein Minuszeichen folgt (-) erfordert eine Übereinstimmung für Null oder ein Vorkommen des vorherigen Ausdrucks. Mit anderen Worten: Der vorherige Ausdruck ist optional. Beispiele

    • match("colou-r","color"); gibt 1 zurück.
    • match("colou-r","color"); gibt 1 zurück.
  • []: Entspricht einem einzelnen Zeichen mit einem beliebigen Zeichen, das in die Klammern eingeschlossen ist. Ein Zeichenbereich kann durch zwei Zeichen angegeben werden, die durch ein Minuszeichen (-) getrennt sind. [ a-z] gleicht beispielsweise alle Buchstaben zwischen a und z ab, [0-9] entspricht einer Ziffer, und [0-9a-f] entspricht einer hexadezimalen Ziffer. Beispiele

    • match("[abc]","apple"); gibt "1" zurück, da es mit dem "Apfel" übereinstimmt.
    • match("[abc]","kiwi"); gibt 0 zurück, da "kiwi" keine a, b oder c enthält.
    • match("gr[ae]y","grey"); gibt 1 zurück. Dieser Ausdruck entspricht auch "grau".
    • match("gr[ae]y","graey"); gibt 0 zurück, da nur ein Zeichen zwischen "gr" und "y" übereinstimmen.
  • [^]: Wenn das erste Zeichen im Text, der in Klammern eingeschlossen ist, ein Zirkumflex (^) ist, entspricht der Ausdruck allen Zeichen mit Ausnahme der Zeichen, die in die Klammern eingeschlossen sind. Beispiele

    • match("[^bc]at","bat"); gibt 0 zurück.
    • match("[^bc]at","hat"); gibt 1 zurück.
    • match("[^abc]","bat"); gibt 1 zurück. Alles außer a, b oder c wird abgeglichen. Daher wird das t abgeglichen.

strAlpha

Kopiert nur die alphanumerischen Zeichen aus einer Zeichenfolge.

str strAlpha(str _text)

Die Parameter

Parameter Description
_Text Die zu kopierende Zeichenfolge.

Rückgabewert

Eine neue Zeichenfolge, die alle alphanumerischen Zeichen aus der angegebenen Zeichenfolge enthält.

Bemerkungen

Beispiel: strAlpha("2+2=5 ist das richtig?") gibt die Zeichenfolge 225isthiscorrect zurück.

Example

static void strAlphaExample(Args _arg)
{
    str s;
    ;
    s = strAlpha("?a*bc123.");
    print s;
    pause;
}

strCmp

Vergleicht zwei Textzeichenfolgen.

int strCmp(str text1, str text2)

Die Parameter

Parameter Description
text1 Die erste Zeichenfolge.
text2 Die zweite Zeichenfolge.

Rückgabewert

0 , wenn die beiden Zeichenfolgen identisch sind, 1 , wenn die erste Zeichenfolge früher sortiert wird, oder -1 , wenn die zweite Zeichenfolge früher sortiert wird.

Bemerkungen

Bei dem von dieser Methode durchgeführten Vergleich wird die Groß-/Kleinschreibung beachtet.

print strCmp("abc", "abc"); //Returns the value 0.
print strCmp("abc", "ABC"); //Returns the value 1.
print strCmp("aaa", "bbb"); //Returns the value -1.
print strCmp("ccc", "bbb"); //Returns the value 1.

strColSeq

Konvertiert alle Großbuchstaben in Kleinbuchstaben und konvertiert alle Zeichen mit Akzenten in die entsprechenden nicht formatierten Kleinbuchstaben.

str strColSeq(str text)

Die Parameter

Parameter Description
Text Die Zeichenfolge zum Kopieren und Konvertieren von Zeichen aus.

Rückgabewert

Die konvertierte Textzeichenfolge.

Bemerkungen

Die strColSeq-Funktion ist für Abwärtskompatibilitätszwecke vorhanden. Diese Funktion unterstützt nur die Zuordnung für die folgenden westeuropäischen Zeichen:

  • AàáâãäÀÁÂÃÄBCçÇDEèéêëÈÉÊËFGHIìíîïÌÍÎÏKLMNñÑOòóôõöÒÓÔÕÖPQRSTUùúùüÚÙÚÙÜVWXYýÝZæøåÆØÅ
  • aaaaaaabcccdeeeefghiiiiiiiiiiijklmnnnooooooooopqrstuuuuuuuuuvwxyyyz~~Ç~...Ç

Verwenden Sie für Unicode-kompatible Funktionen die Win32 LCMapString-Anwendungsprogrammierschnittstelle (API) über die DLL - und DLLFunc-Klassen .

Example

Im folgenden Beispiel wird abcdeabcde gedruckt.

    static void strColSeqExample(Args _arg)
    {
            ;
            print strColSeq("");
            pause;
    }

strDel

Erstellt eine Kopie einer Zeichenfolge, aus der die angegebene Teilzeichenfolge entfernt wird.

str strDel(str _text, int _position, int _number)

Die Parameter

Parameter Description
_Text Die zu kopierende Zeichenfolge.
_Position Die Position, an der zeichen während des Kopiervorgangs ignoriert werden sollen.
_Zahl Die Anzahl der zu ignorierenden Zeichen. Ein Minuszeichen vor dem _number-Parameter gibt an, dass _number-1 Zeichen vor dem Zeichen bei _position zusammen mit dem Zeichen bei _position entfernt werden sollen.

Rückgabewert

Die verbleibenden Zeichen, die aus der Zeichenfolge kopiert werden.

Bemerkungen

Die StrDel-Funktion ergänzt die Substr-Funktion .

strDel("ABCDEFGH",2,3); //Returns the string "AEFGH".
strDel("ABCDEFGH",4,3); //Returns the string "ABCGH".

strFind

Durchsucht eine Zeichenfolge nach dem ersten Vorkommen eines der angegebenen Zeichen.

int strFind(str _text, str _characters, int _position, int _number)

Die Parameter

Parameter Description
_Text Die zu durchsuchende Zeichenfolge.
_Zeichen Die zu suchden Zeichen.
_Position Die Position in der Zeichenfolge, an der die Suche beginnt.
_Zahl Eine signierte Nummer, die die Richtung der Suche angibt und wie viele Positionen in der Zeichenfolge gesucht werden sollen.

Rückgabewert

Der Wert der Position des ersten Vorkommens eines der angegebenen Zeichen oder 0, wenn keine gefunden wurde.

Bemerkungen

Wenn Sie von Anfang bis Ende der Zeichenfolge suchen möchten, verwenden Sie "1 " als Wert des _position-Parameters . Wenn der Wert des _number Parameters negativ ist, durchsucht das System die Anzahl der Zeichen rückwärts von der angegebenen Position. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Hier ist ein Beispiel.

strFind("ABCDEFGHIJ","KHD",1,10); //Returns the value 4 (the position where "D" was found).
strFind("ABCDEFGHIJ","KHD",10,-10); //Returns the value 8 (the position where "H" was found).

Die strFind-Funktion ergänzt die strNFind-Funktion .

strFmt

Formatiert die angegebene Zeichenfolge und ersetzt alle Vorkommen von n durch das nth-Argument.

str strFmt(str _string, ...)

Die Parameter

Parameter Description
_Schnur Die zu formatierenden Zeichenfolgen.

Rückgabewert

Die formatierte Zeichenfolge.

Bemerkungen

Wenn kein Argument für einen Parameter angegeben wird, gibt der Parameter in der Zeichenfolge als "%n" zurück. Die Zeichenfolgenkonvertierung von Werten des realen Typs ist auf zwei Dezimalstellen beschränkt. Werte werden gerundet, nicht abgeschnitten. Die System.String::Format-Methode aus microsoft .NET Framework kann verwendet werden, um mehr Funktionen zu erhalten, wie im Beispiel gezeigt.

Example

static void strFmtExampleJob(Args _arg)
{
    System.Double sysDouble;
    real r = 8.3456789;
    int  i = 42;
    utcDateTime utc = str2DateTime("2008-01-16 13:44:55" ,321); // 321 == YMD.
    str  s;
    ;
    s = strFmt("real = %1, int = %2, utcDateTime = %3, [%4]", r, i, utc);
    info("X1:  " + s);
    //
    sysDouble = r;
    s = System.String::Format("{0:##.####}", sysDouble);
    info("N1:  " + s);
    //
    s = System.String::Format("{0,6:C}", sysDouble); // $
    info("N2:  " + s);
    /**********  Actual Infolog output
    Message (02:16:05 pm)
    X1:  real = 8.35, int = 42, utcDateTime = 1/16/2008 01:44:55 pm, [%4]
    N1:  8.3457
    N2:   $8.35
    **********/
}

strIns

Erstellt eine Zeichenfolge, indem eine Zeichenfolge in eine andere eingefügt wird.

str strIns(str _text1, str _text2, int _position)

Die Parameter

Parameter Description
_text1 Die Zeichenfolge, in die die andere Zeichenfolge eingefügt werden soll.
_text2 Die Zeichenfolge, die in die andere Zeichenfolge eingefügt werden soll.
_Position Die Position, an der das erste Zeichen des _text2-Parameters in der Ausgabezeichenfolge auftreten soll.

Rückgabewert

Die kombinierte Textzeichenfolge.

Bemerkungen

Die strIns-Funktion ergänzt die strDel-Funktion . Wenn der Wert des _position-Parameters größer als die Länge der ursprünglichen Zeichenfolge ist, wird die einzufügende Zeichenfolge an das Ende der ursprünglichen Zeichenfolge angefügt.

strIns("ABFGH","CDE",3); //Returns the string "ABCDEFGH".
strIns("ABCD","EFGH",10); //Returns the string "ABCDEFGH".

strKeep

Erstellt eine Zeichenfolge mit nur den Zeichen aus der ersten Eingabezeichenfolge, die die zweite Eingabezeichenfolge angibt, sollte beibehalten werden.

str strKeep(str _text1, str _text2)

Die Parameter

Parameter Description
_text1 Die Zeichenfolge, die die Zeichen enthält, die zum Erstellen einer Ausgabezeichenfolge verwendet werden können.
_text2 Die Zeichenfolge, die angibt, welche Zeichen für die Ausgabezeichenfolge beibehalten werden sollen.

Rückgabewert

Eine Zeichenfolge der zeichen, die beibehalten werden.

Bemerkungen

strKeep("ABBCDDEFGHB","BCD"); //Returns the string "BBCDDB".
strKeep("abcZcba","bc") //Returns the string "bccb".

Die StrKeep-Funktion ergänzt die StrRem-Funktion .

strLen

Berechnet die Länge der angegebenen Zeichenfolge.

int strLen(str text)

Die Parameter

Parameter Description
Text Die Zeichenfolge, mit der die Länge berechnet werden soll.

Rückgabewert

Die Länge der angegebenen Zeichenfolge.

Bemerkungen

strLen("ABC"); //Returns the value 3.
strLen("ABCDEFGHIJ"); //Returns the value 10.

strLine

Ruft eine einzelne Zeile aus einer Zeichenfolge ab, die mehrere Zeilen umfasst.

str strLine(str string, int count)

Die Parameter

Parameter Description
Schnur Eine Zeichenfolge, die mehrere Zeilen umfassen kann.
count Der Offset der zurückzugebenden Linie.

Rückgabewert

Eine kopierte Zeile der Zeichenfolge, die durch den Zeichenfolgenparameter angegeben wird.

Bemerkungen

Die erste Zeile der Zeichenfolge weist einen Offset von 0 auf. Sie können einer Zeichenfolge mehrere Zeilen zuweisen, indem Sie die zeichen\n oder \r\n in die Zeichenfolge einbetten. Darüber hinaus können Sie das At-Zeichen (@) unmittelbar vor dem öffnenden Anführungszeichen verwenden und die EINGABETASTE verwenden, um Teile des Zeichenfolgenwerts über mehrere Zeilen im X++-Code-Editor zu verteilen.

Example

str mytxt = "first-line\nsecond-line\nlast-line";
// Prints "second-line".
print strLine(mytxt,1);
// Prints "last-line".
print strLine(mytxt,2);            

strLTrim

Entfernt führende Leerzeichen aus einer Textzeichenfolge.

str strLTrim(str text)

Die Parameter

Parameter Description
Text Die Zeichenfolge, aus der die führenden Leerzeichen gelöscht werden sollen.

Rückgabewert

Die Zeichenfolgenentsprechung für den Text, aus dem führende Leerzeichen entfernt wurden.

Bemerkungen

Die strLTrim-Funktion ergänzt die strRTrim-Funktion .

Example

// Returns the text string "ABC-DEFG".
strLTrim("   ABC-DEFG");

strLwr

Konvertiert alle Buchstaben in der angegebenen Zeichenfolge in Kleinbuchstaben.

str strLwr(str _text)

Die Parameter

Parameter Description
_Text Die Zeichenfolge, die in Kleinbuchstaben konvertiert werden soll.

Rückgabewert

Eine Kopie der angegebenen Zeichenfolge, die nur Kleinbuchstaben enthält.

Bemerkungen

Die strLwr-Funktion ergänzt die strUpr-Funktion . Die strLwr-Funktion verwendet die LCMapString-Funktion in der Win32-API.

Example

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}

strNFind

Durchsucht einen Teil einer Textzeichenfolge nach dem ersten Vorkommen eines Zeichens, das nicht in der angegebenen Zeichenliste enthalten ist.

int strNFind(str _text, str _characters, int _position, int _number)

Die Parameter

Parameter Description
_Text Die zu durchsuchende Textzeichenfolge.
_Zeichen Die Liste der Zeichen, die von der Suche ausgeschlossen werden sollen.
_Position Die Position in der Zeichenfolge, an der die Suche beginnen soll.
_Zahl Eine signierte Nummer, die die Richtung der Suche und die Anzahl der zu durchsuchenden Positionen angibt. Wenn ein Minuszeichen vor _number steht, durchsucht das System _number Zeichen in umgekehrter Reihenfolge von _position.

Rückgabewert

Die Position des ersten Vorkommens eines Zeichens, das nicht vom _characters-Parameter angegeben wird, oder 0, wenn keine gefunden wurde.

Bemerkungen

Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Um vom Anfang der Zeichenfolge bis zum Ende zu suchen, verwenden Sie den Wert 1 für den parameter _position . Wenn dem Wert des _number Parameters ein Minuszeichen vorangestellt ist, werden die Zeichen in umgekehrter Reihenfolge durchsucht, beginnend mit der Position, die durch den parameter _position angegeben wird.

strNFind("ABCDEFGHIJ","ABCDHIJ",1,10); //Returns the value 5 (the position of "E");
strNFind("CDEFGHIJ","CDEFGIJ",10,-10); //Returns the value 6 (the position of "H").
strNFind("abcdef","abCdef",3,2) //Returns the value 0.
strNFind("abcdef", "abcef",3,2) //Returns the value 4.

Die strNFind-Funktion ergänzt die strFind-Funktion .

strPoke

Überschreibt einen Teil einer Zeichenfolge mit einer anderen Zeichenfolge.

str strPoke(str _text1, str _text2, int _position)

Die Parameter

Parameter Description
_text1 Die ursprüngliche Zeichenfolge.
_text2 Die Zeichenfolge, durch die ein Teil der ursprünglichen Zeichenfolge ersetzt werden soll.
_Position Die Position der ursprünglichen Zeichenfolge, an der die Zeichen ersetzt werden sollen.

Rückgabewert

Die neue Zeichenfolge.

Bemerkungen

Die neue Zeichenfolge kann länger sein als die ursprüngliche Zeichenfolge. Wenn der Wert des _position Parameters jedoch größer als die Länge der Zeichenfolge ist, wird die ursprüngliche Zeichenfolge ohne Ersatz zurückgegeben.

strPoke("12345678","AAA",3); //Returns the string "12AAA678".
strPoke("abcde","4567",4); //Returns the string "abc4567".
strPoke("abcde", "4567", "10"); //Returns the string "abcde".

strPrompt

Fügt eine Zeichenfolge mit der angegebenen Anzahl von Punktzeichen an, gefolgt von einem Doppelpunkt- und Leerzeichen.

str strPrompt(str _string, _int len)

Die Parameter

Parameter Description
_Schnur Die ursprüngliche Zeichenfolge.
_Len Die gewünschte endgültige Länge der Zeichenfolge.

Rückgabewert

Eine Zeichenfolge, die wie eine Aufforderung zur Benutzereingabe aussieht.

Bemerkungen

In atypischen Fällen, in denen der Wert des _len Parameters nur etwas größer als die Länge der ursprünglichen Zeichenfolge ist, wird die höchste Rangfolge zum Hinzufügen des nachgestellten Leerzeichens gegeben. Als Nächstes wird dem Doppelpunkt Vorrang gegeben. Die niedrigste Rangfolge wird den Punkten zugewiesen. Negative Werte für den _len-Parameter geben die mit einem nachfolgenden Leerzeichen angefügte Eingabezeichenfolge zurück.

strPrompt("ab",-1); //Returns "ab ".
strPrompt("ab",3); //Returns "ab ".
strPrompt("ab",4); //Returns "ab: ".
strPrompt("ab",5); //Returns "ab.: ".
strPrompt("ab",6); //Returns "ab..: ".

Example

static void JobStrPromptDemo(Args _args)
{
    // Printed string is "[abc..: ]"
    print "[", strPrompt("abc", 7), "]";
    pause;
}

strRem

Entfernt die Zeichen, die in einer Zeichenfolge angegeben sind, aus einer anderen Zeichenfolge.

str strRem(str text1, str text2)

Die Parameter

Parameter Description
text1 Die Zeichenfolge, aus der Zeichen entfernt werden sollen.
text2 Die Zeichen, die von der Ausgabezeichenfolge ausgeschlossen werden sollen.

Rückgabewert

Der verbleibende Inhalt der ursprünglichen Zeichenfolge.

Bemerkungen

Für diese Funktion wird die Groß-/Kleinschreibung beachtet.

strRem("abcd_abcd","Bc"); //Returns the string "abd_abd".
strRem("ABCDEFGABCDEFG","ACEG"); //Returns the string "BDFBDF".

Diese Funktion ergänzt die StrKeep-Funktion .

strRep

Wiederholt eine Zeichenfolge von Zeichen.

str strRep(str _text, str _number)

Die Parameter

Parameter Description
_Text Die zu wiederholende Zeichenfolge.
_Zahl Die Anzahl der Wiederholungen der Zeichenfolge.

Rückgabewert

Eine neue Zeichenfolge, die den Inhalt der ursprünglichen Zeichenfolge enthält, die die angegebene Anzahl von Malen wiederholt.

Example

Im folgenden Beispiel wird die Textzeichenfolge ABABABABABABAB gedruckt.

static void strRepExample(Args _arg)
{
    str strL;
    ;
    strL = strRep("AB",6);
    print strL;
    pause;
}

strRTrim

Entfernt die nachfolgenden Leerzeichen vom Ende einer Zeichenfolge.

str strRTrim(str _text)

Die Parameter

Parameter Description
_Text Die Zeichenfolge, aus der die nachfolgenden Leerzeichen entfernt werden sollen.

Rückgabewert

Eine Kopie der angegebenen Zeichenfolge, die keine nachfolgenden Leerzeichen enthält.

Bemerkungen

strRTrim("ABC-DEFG- "); //Returns the string "ABC-DEFG-".
strRTrim(" CD "); //Returns " CD".

Die strRTrim-Funktion ergänzt die strLTrim-Funktion .

strScan

Durchsucht eine Textzeichenfolge nach einem Vorkommen einer anderen Zeichenfolge.

int strScan(str _text1, str _text2, int _position, int _number)

Die Parameter

Parameter Description
_text1 Die zu durchsuchende Zeichenfolge.
_text2 Die zu suchde Zeichenfolge.
_Position Die erste Position im _text1 Parameter, an dem ein Vergleich durchgeführt werden soll.
_Zahl Die Anzahl der Positionen im _text1-Parameter , für die der Vergleich wiederholt werden soll. Wenn dem parameter _number ein Minuszeichen vorangestellt ist, durchsucht das System die Anzahl von Zeichen in umgekehrter Reihenfolge von der angegebenen Position.

Rückgabewert

Die Position, an der die angegebene Zeichenfolge in der Zeichenfolge gefunden wurde; andernfalls 0 (null).

Bemerkungen

Bei den Vergleichen wird die Groß-/Kleinschreibung nicht beachtet. Werte für den parameter _position , die kleiner als 1 sind, werden als 1 behandelt. Die Richtung des Scans wird durch das Zeichen gesteuert, das im _number-Parameter angegeben ist. Ein positives Zeichen gibt an, dass jeder aufeinander folgende Vergleich eine Position näher am Ende der Zeichenfolge beginnt. Ein negatives Zeichen gibt an, dass jeder Vergleich eine Position näher am Anfang der Zeichenfolge beginnt.

strScan("ABCDEFGHIJ","DEF",1,10); //Returns the value 4.
strScan ("ABCDEFGHIJ","CDE",10,-10); //Returns the value 3.

strUpr

Konvertiert alle Buchstaben in einer Zeichenfolge in Großbuchstaben.

str strUpr(str _text)

Die Parameter

Parameter Description
_Text Die Zeichenfolge, die in Großbuchstaben konvertiert werden soll.

Rückgabewert

Eine Kopie der angegebenen Zeichenfolge, die nur Kleinbuchstaben enthält.

Bemerkungen

Die StrUpr-Funktion ergänzt die strLwr-Funktion . Die strUpr-Funktion verwendet die FUNKTION LCMapString() in der Win32-API.

Example

Im folgenden Beispiel wird ABCDD55EFGHIJ gedruckt.

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

subStr

Ruft einen Teil einer Zeichenfolge ab.

str subStr(str _text, int _position, int _number)

Die Parameter

Parameter Description
_Text Die ursprüngliche Zeichenfolge.
_Position Die Position in der ursprünglichen Zeichenfolge, an der der abzurufende Teil beginnt.
_Zahl Eine signierte ganze Zahl, die die Richtung und die Anzahl der Positionen angibt, die aus der ursprünglichen Zeichenfolge abgerufen werden sollen. Wenn ein Minuszeichen vor _number steht, wählt das System die Teilzeichenfolge rückwärts von der angegebenen Position aus.

Rückgabewert

Eine Teilzeichenfolge der ursprünglichen Zeichenfolge.

Bemerkungen

Wenn dem Wert des _number Parameters ein Minuszeichen vorangestellt ist, wird die Teilzeichenfolge von der angegebenen Position rückwärts ausgewählt.

subStr("ABCDEFGHIJ",3,5); //Returns the string "CDEFG".
subStr("ABCDEFGHIJ",7,-4); //Returns the string "DEFG".
subStr("abcdef",2,99) //Returns the string "bcdef".
subStr("abcdef",2,3) //Returns the string "bcd".
subStr("abcdef",2,-3); //Returns the string "ab".

strContains

Überprüft, ob textzeichenfolge eine weitere Zeichenfolge enthält.

boolean strContains(str _text, str _potentialContains)

Die Parameter

Parameter Description
_Text Die ursprüngliche Zeichenfolge, in die gesucht werden soll.
_potentialContains Die zu suchde Zeichenfolge.

Rückgabewert

True, wenn die ursprüngliche Zeichenfolge die durchsuchte Zeichenfolge enthält; andernfalls "false".

Bemerkungen

Bei den Vergleichen wird die Groß-/Kleinschreibung nicht beachtet.

strContains("ABCDEFGHIJ","abc"); //Returns true.
strContains("ABCDEFGHIJ","ABC"); //Returns true.
strContains("ABCDEFGHIJ","K"); //Returns false.

strStartsWith

Überprüft, ob die Textzeichenfolge mit einer anderen Zeichenfolge beginnt.

boolean strStartsWith(str _string, str _potentialStart)

Die Parameter

Parameter Description
_Schnur Die ursprüngliche Zeichenfolge, in die gesucht werden soll.
_potentialStart Die potenzielle Zeichenfolge, die sich am Anfang befindet.

Rückgabewert

True, wenn die potenzielle Zeichenfolge der Anfang der ursprünglichen Zeichenfolge ist; andernfalls "false".

Bemerkungen

Bei den Vergleichen wird die Groß-/Kleinschreibung nicht beachtet.

strStartsWith("ABCDEFGHIJ","abc"); //Returns true.
strStartsWith("ABCDEFGHIJ","ABC"); //Returns true.
strStartsWith("ABCDEFGHIJ","B"); //Returns false.

strEndsWith

Überprüft, ob die Textzeichenfolge mit einer anderen Zeichenfolge endet.

boolean strEndsWith(str _string, str _potentialEnd)

Die Parameter

Parameter Description
_Schnur Die ursprüngliche Zeichenfolge, in die gesucht werden soll.
_potentialEnd Die potenzielle Zeichenfolge, die sich am Ende befindet.

Rückgabewert

True, wenn die potenzielle Zeichenfolge die ursprüngliche Zeichenfolge beendet; andernfalls "false".

Bemerkungen

Bei den Vergleichen wird die Groß-/Kleinschreibung nicht beachtet.

strEndsWith("ABCDEFGHIJ","ghij"); //Returns true.
strEndsWith("ABCDEFGHIJ","HIJ"); //Returns true.
strEndsWith("ABCDEFGHIJ","B"); //Returns false.

strLRTrim

Entfernt vor- und abseitige Leerzeichen aus einer Textzeichenfolge.

str strLRTrim(str text)

Die Parameter

Parameter Description
Text Die Zeichenfolge, aus der die vor- und abseitigen Leerzeichen gelöscht werden sollen.

Rückgabewert

Eine Kopie der angegebenen Zeichenfolge, die keine führenden und nachfolgenden Leerzeichen enthält.

Bemerkungen

Die strLRTrim-Funktion ergänzt die StrRTrim - und strLTrim-Funktion .

Example

// Returns the text string "ABC-DEFG".
strLRTrim("   ABC-DEFG   ");