String  - AS3

Eine Ganzzahl, die die Anzahl der Zeichen im angegebenen String-Objekt angibt.

Da alle Stringindizes die Basis null haben, ist die Indexposition für das letzte Zeichen eines x-Strings x.length - 1.

Erstellt ein neues String-Objekt, das mit dem angegebenen String initialisiert wird.

Hinweis: Da Stringliterale weniger Aufwand erfordern als String-Objekte und ihre Verwendung im Allgemeinen einfacher ist, sollten Sie anstatt der String-Klasse immer Stringliterale verwenden, es sei denn, Sie haben einen guten Grund für die Verwendung eines String-Objekts.

Gibt das Zeichen zurück, das sich an der durch den Parameter index angegebenen Position befindet. Wenn index keine Zahl zwischen 0 und string.length - 1 ist, wird ein leerer String zurückgegeben.

Diese Methode ähnelt String.charCodeAt(), es wird jedoch ein ganzzahliger 16-Bit-Zeichencode zurückgegeben und kein Zeichen.

Parameter

Verwandte API-Elemente

Gibt den numerischen Unicode-Zeichencode des Zeichens an der durch index festgelegten Stelle zurück. Wenn index keine Zahl zwischen 0 und string.length - 1 ist, wird NaN zurückgegeben.

Diese Methode ähnelt String.charAt(), es wird jedoch ein ganzzahliger 16-Bit-Zeichencode zurückgegeben und nicht das eigentliche Zeichen.

Parameter

Verwandte API-Elemente

Hängt die angegebenen Argumente ans Ende des String-Objekts an, wobei sie notwendigenfalls in Strings konvertiert werden, und gibt den resultierenden String zurück. Der ursprüngliche Wert des String-Quellobjekts bleibt unverändert.

Parameter

Gibt einen String mit den Zeichen zurück, die den in den Parametern angegebenen Unicode-Zeichencodes entsprechen.

Parameter

Durchsucht den String und gibt die Position des ersten Vorkommens von val nach (einschließlich) startIndex innerhalb des aufrufenden Strings zurück. Diese Indexposition basiert auf Null, d. h., das erste Zeichen in einem String befindet sich an Indexposition 0 und nicht an Indexposition 1. Wenn val nicht gefunden wird, gibt die Methode -1 zurück.

Parameter

Verwandte API-Elemente

Durchsucht den String von rechts nach links und gibt die Indexposition des letzten Vorkommens von val innerhalb des aufrufenden Strings zurück, das vor der startIndex-Position gefunden wurde. Die Indexposition basiert auf null, d. h., das erste Zeichen befindet sich auf Indexposition 0 und das letzte auf string.length - 1. Wenn val nicht gefunden wird, gibt die Methode -1 zurück.

Parameter

Verwandte API-Elemente

Vergleicht die Sortierreihenfolge von zwei oder mehr Strings und gibt das Ergebnis des Vergleichs als Ganzzahl zurück. Obwohl diese Methode dafür konzipiert ist, den Vergleich je nach lokaler Einstellung zu vergleichen, erzeugt die ActionScript 3.0-Implementierung keine anderen Ergebnisse als die Operatoren für Gleichheit (==) oder Ungleichheit (!=) operators. Sind die Strings äquivalent, lautet der Rückgabewert 0. Kommt der ursprüngliche Stringwert vor dem durch other angegebenen Stringwert, ist der Rückgabewert eine negative Ganzzahl, deren absoluter Wert die Anzahl von Zeichen repräsentiert, die die beiden Stringwerte voneinander trennt. Kommt der ursprüngliche Stringwert nach other, ist der Rückgabewert eine positive Ganzzahl, deren absoluter Wert die Anzahl von Zeichen repräsentiert, die die beiden Stringwerte voneinander trennt.

Parameter

Vergleicht das angegebene Muster (pattern) mit dem String.

Parameter

Verwandte API-Elemente

Vergleicht das angegebene pattern mit dem String und gibt einen neuen String zurück, in dem die erste Übereinstimmung mit pattern durch den von repl angegebenen Inhalt ersetzt ist. Der Parameter pattern kann ein String oder ein regulärer Ausdruck sein. Der Parameter repl kann ein String oder eine Funktion sein. Wenn es sich um eine Funktion handelt, wird die Übereinstimmung durch den von der Funktion zurückgegebenen String ersetzt. Der ursprüngliche String wird nicht geändert.

Im folgenden Beispiel wird die erste Instanz von „sh“ ersetzt (wobei Groß-/Kleinschreibung beachtet wird):

    var myPattern:RegExp = /sh/;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // She sells seaschells by the seashore.

Im folgenden Beispiel werden alle Instanzen von „sh“ (bei Beachtung der Groß-/Kleinschreibung) ersetzt, da im regulären Ausdruck das g-Flag (global) gesetzt ist.

    var myPattern:RegExp = /sh/g;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // She sells seaschells by the seaschore.

Im folgenden Beispiel werden alle Instanzen von „sh“ ersetzt, da im regulären Ausdruck das g-Flag (global) gesetzt ist, und die Groß-/Kleinschreibung wird nicht beachtet, da das i-Flag (ignorCase) gesetzt ist:

    var myPattern:RegExp = /sh/gi;  
    var str:String = "She sells seashells by the seashore.";
    trace(str.replace(myPattern, "sch"));  
       // sche sells seaschells by the seaschore.

Parameter

var str:String = "flip-flop";
    var pattern:RegExp = /(\w+)-(\w+)/g;
    trace(str.replace(pattern, "$2-$1")); // flop-flip

    var str1:String = "abc12 def34";
    var pattern:RegExp = /([a-z]+)([0-9]+)/;
    var str2:String = str1.replace(pattern, replFN);
    trace (str2);   // 12abc 34def
    
    function replFN():String {
      return arguments[2] + arguments[1];
    }

    {"abc12", "abc", "12", 0, "abc12 def34"}

    {"def34", "def", "34", 6, "abc123 def34"}

Verwandte API-Elemente

Sucht nach dem angegebenen Muster (pattern) und gibt die Indexposition des ersten übereinstimmenden Teilstrings zurück. Gibt es keinen übereinstimmenden Teilstring, gibt die Methode den Wert -1 zurück.

Parameter

Verwandte API-Elemente

Gibt einen String zurück, der das durch startIndex angegebene Zeichen und alle Zeichen bis zu dem durch endIndex angegebenen Zeichen (jedoch nicht einschließlich) enthält. Das ursprüngliche String-Objekt wird nicht geändert. Wenn der Parameter endIndex nicht angegeben wird, endet der Teilstring am Ende des Strings. Wenn das durch startIndex indizierte Zeichen mit dem durch endIndex indizierten Zeichen übereinstimmt oder rechts von diesem liegt, gibt die Methode einen leeren String zurück.

Parameter

Verwandte API-Elemente

Unterteilt ein String-Objekt in ein Array an Teilstrings, und immer dort, wo der Parameter delimiter vorkommt.

Handelt es sich beim Parameter delimiter um einen regulären Ausdruck, wird nur die erste Übereinstimmung an einer bestimmten Position des Strings berücksichtigt, selbst wenn bei einer Rückverfolgung ein nicht leerer Teilstring an dieser Position gefunden werden könnte. Beispiel:

     var str:String = "ab";
     var results:Array = str.split(/a*?/); // results == ["","b"]
     
     results = str.split(/a*/); // results == ["","b"].)

Handelt es sich beim Parameter delimiter um einen regulären Ausdruck mit Klammerausdrücken, so werden die Ergebnisse der Klammerausdrücke (einschließlich etwaiger undefinierter Ergebnisse) jedes Mal dann auf den Ausgabe-Array aufgeteilt, wenn nach delimiter gesucht wird. Beispiel

     var str:String = "Thi5 is a tricky-66 example.";
     var re:RegExp = /(\d+)/;
     var results:Array = str.split(re);
         // results == ["Thi","5"," is a tricky-","66"," example."]

Wird der Parameter limit angegeben, wird der zurückgegebene Array nichts anderes als die angegebene Anzahl an Elementen enthalten.

Wenn delimiter ein leerer String, ein leerer regulärer Ausdruck oder ein regulärer Ausdruck, der einem leeren String entsprechen kann, ist, wird jedes einzelne Zeichen in dem String als ein Element in das Array eingetragen.

Wenn der Parameter delimiter nicht definiert ist, wird der gesamte String in das erste Element des zurückgegebenen Arrays gestellt.

Parameter

Verwandte API-Elemente

Gibt einen Teilstring zurück, der aus den Zeichen besteht, die an dem angegebenen startIndex beginnen und eine durch len festgelegte Länge besitzen. Der ursprüngliche String bleibt unverändert.

Parameter

Gibt einen String zurück, der aus dem von startIndex angegebenen Zeichen und allen Zeichen bis zu endIndex - 1 besteht. Wenn endIndex nicht angegeben ist, wird String.length verwendet. Wenn die Werte von startIndex und endIndex identisch sind, gibt die Methode einen leeren String zurück. Wenn der Wert von startIndex größer ist als der Wert von endIndex, werden die Parameter vor Ausführung der Funktion automatisch ausgetauscht. Der ursprüngliche String bleibt unverändert.

Parameter

Gibt eine Kopie dieses Strings zurück, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden. Der ursprüngliche String bleibt unverändert. Obwohl diese Methode dafür konzipiert ist, die Umwandlung der lokalen Einstellung entsprechend durchzuführen, erzeugt die ActionScript 3.0-Implementierung keine anderen Ergebnisse als die Methode toLowerCase().

Verwandte API-Elemente

Gibt eine Kopie dieses Strings zurück, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden. Der ursprüngliche String bleibt unverändert. Obwohl diese Methode dafür konzipiert ist, die Umwandlung der lokalen Einstellung entsprechend durchzuführen, erzeugt die ActionScript 3.0-Implementierung keine anderen Ergebnisse als die Methode toUpperCase().

Verwandte API-Elemente

Gibt eine Kopie dieses Strings zurück, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden. Der ursprüngliche String bleibt unverändert.

Diese Methode konvertiert alle Zeichen (nicht einfach A–Z), für die es in Unicode Kleinbuchstaben gibt:

     var str:String = " JOSÉ BARÇA";
     trace(str.toLowerCase()); // josé barça

Diese Zuordnungen von Groß- und Kleinbuchstaben sind in der Unicode Character Database-Spezifikation definiert.

Verwandte API-Elemente

Gibt eine Kopie dieses Strings zurück, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden. Der ursprüngliche String bleibt unverändert.

Diese Methode konvertiert alle Zeichen (nicht einfach a–z), für die es in Unicode Großbuchstaben gibt:

     var str:String = "José Barça";
     trace(str.toUpperCase()); // JOSÉ BARÇA

Diese Zuordnungen von Groß- und Kleinbuchstaben sind in der Unicode Character Database-Spezifikation definiert.

Verwandte API-Elemente

Gibt den Grundwert einer String-Instanz zurück. Diese Methode ist dafür konzipiert ein String-Objekt in einen String-Grundwert umzuwandeln. Da Flash-Laufzeitumgebungen, falls notwendig, valueOf() automatisch aufrufen, kommt es selten vor, dass Sie diese Methode explizit aufrufen müssen.

1. Der Konstruktor für StringExample deklariert mehrere lokale String-Instanzen, die mit verschiedenen Strings und einem neuen StringHelper-Objekt initialisiert werden.
2. Das StringHelper-Klasse weist die folgende Methoden auf:
   • replace(): Ruft die split()- und join()-Methoden von String auf, um einen Teilstring des Strings zu entfernen, der mit einem neuen übergeben wurde.
   • trim(): Ruft sowohl trimBack() als auch trimFront() mithilfe der übergebenen Strings auf und gibt den aktualisierten String zurück.
   • trimFront(): Entfernt rekursiv alle Zeichen, die mit dem Parameter char übereinstimmen, und zwar vom Anfang des Strings in Richtung Ende, bis das erste Zeichen im String erreicht ist, das nicht mit char übereinstimmt, und gibt den aktualisierten String zurück.
   • trimBack(): Entfernt rekursiv alle Zeichen, die mit dem Parameter char übereinstimmen, und zwar vom Ende des Strings in Richtung Anfrang, bis das letzte Zeichen im String erreicht ist, das nicht mit char übereinstimmt, und gibt den aktualisierten String zurück.
   • stringToCharacter(): Gibt das erste Zeichen des übergebenen Strings zurück.
3. Anschließend werden drei Strings erstellt, und zwar mithilfe der deklarierten Stringvariablen, mit einem Aufruf der replace()-Methode, um den zweiten String zu erstellen und mit trim(), um den dritten String zu erstellen.

package {
    import flash.display.Sprite;

    public class StringExample extends Sprite {
        public function StringExample() {
            var companyStr:String = new String("     Company X");
            var productStr:String = "Product Z Basic     ";
            var emptyStr:String = " ";
            var strHelper:StringHelper = new StringHelper();

            var companyProductStr:String = companyStr + emptyStr + productStr;
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Basic     '

            companyProductStr = strHelper.replace(companyProductStr, "Basic", "Professional");
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Professional     '

            companyProductStr = strHelper.trim(companyProductStr, emptyStr);
            trace("'" + companyProductStr + "'");    // 'Company X Product Z Professional'
        }
    }
}

class StringHelper {
    public function StringHelper() {
    }

    public function replace(str:String, oldSubStr:String, newSubStr:String):String {
        return str.split(oldSubStr).join(newSubStr);
    }

    public function trim(str:String, char:String):String {
        return trimBack(trimFront(str, char), char);
    }

    public function trimFront(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(0) == char) {
            str = trimFront(str.substring(1), char);
        }
        return str;
    }

    public function trimBack(str:String, char:String):String {
        char = stringToCharacter(char);
        if (str.charAt(str.length - 1) == char) {
            str = trimBack(str.substring(0, str.length - 1), char);
        }
        return str;
    }

    public function stringToCharacter(str:String):String {
        if (str.length == 1) {
            return str;
        }
        return str.slice(0, 1);
    }
}