String  - AS3

Een geheel getal dat het aantal tekens in het opgegeven object String opgeeft.

Omdat alle tekenreeksindexen op nul zijn gebaseerd, is de index van het laatste teken voor elke tekenreeks x gelijk aan x.length - 1.

Maakt een nieuw object String dat naar de opgegeven tekenreeks wordt geïnitialiseerd.

Opmerking: omdat letterlijke tekenreeksen minder overhead gebruiken dan objecten String en doorgaans gemakkelijker te gebruiken zijn, moet u letterlijke tekenreeksen gebruiken in plaats van de klasse String, tenzij u een goede reden hebt om een object String te gebruiken in plaats van een letterlijke tekenreeks.

Retourneert het teken op de positie die door de parameter index is opgegeven. Wanneer index niet een getal van 0 tot string.length - 1 is, wordt een lege tekenreeks geretourneerd.

Deze methode is vergelijkbaar met String.charCodeAt(), maar bij deze methode is de geretourneerde waarde een teken en geen tekencode voor een 16-bits geheel getal.

Parameters

Verwante API-elementen

Retourneert de numerieke Unicode-tekencode van het teken op de opgegeven index. Wanneer index niet een getal van 0 tot string.length - 1 is, wordt NaN geretourneerd.

Deze methode is vergelijkbaar met String.charAt(), maar bij deze methode is de geretourneerde waarde een tekencode voor een 16-bits geheel getal en geen feitelijk teken.

Parameters

Verwante API-elementen

Voegt de aangeboden argumenten aan het einde van het object String toe, waarbij deze indien nodig worden omgezet in tekenreeksen, en retourneert de resulterende tekenreeks. De oorspronkelijke waarde van het bronobject String blijft ongewijzigd.

Parameters

Retourneert een tekenreeks die bestaat uit de tekens die worden vertegenwoordigd door de Unicode-tekencodes in de parameters.

Parameters

Doorzoekt de tekenreeks en retourneert de positie van de eerste gevonden instantie val op of na startIndex binnen de aanroeptekenreeks. Deze index is op nul gebaseerd. Dit betekent dat het eerste teken in een tekenreeks zich op index 0 bevindt en niet op index 1. Wanneer val niet wordt gevonden, retourneert de methode -1.

Parameters

Verwante API-elementen

Doorzoekt de tekenreeks van rechts naar links en retourneert de index van de laatste gevonden val voorafgaand aan startIndex. De index is op nul gebaseerd. Dat betekent dat het eerste teken zich op index 0 bevindt en het laatste teken op string.length - 1. Wanneer val niet wordt gevonden, retourneert de methode -1.

Parameters

Verwante API-elementen

Vergelijkt de sorteervolgorde van twee of meer tekenreeksen en retourneert het resultaat van de vergelijking als een geheel getal. Hoewel deze methode is bedoeld om de vergelijking af te handelen in overeenstemming met specifieke landinstellingen, produceert de implementatie van ActionScript 3.0 geen ander resultaat van andere tekenreeksvergelijkingen zoals de operators gelijk aan (==) of ongelijk aan (!= ). Wanneer de tekenreeksen gelijkwaardig zijn, is de geretourneerde waarde 0. Wanneer de oorspronkelijke tekenreekswaarde voorafgaat aan de tekenreekswaarde die wordt opgegeven door other, is de geretourneerde waarde een negatief geheel getal, waarvan de absolute waarde het aantal tekens vertegenwoordigt dat de twee tekenreekswaarden van elkaar scheidt. Wanneer de oorspronkelijke tekenreekswaarde volgt op other, is de geretourneerde waarde een positief geheel getal, waarvan de absolute waarde het aantal tekens vertegenwoordigt dat de twee tekenreekswaarden van elkaar scheidt.

Parameters

Vergelijkt het opgegeven pattern met de tekenreeks.

Parameters

Verwante API-elementen

Het opgegeven pattern wordt vergeleken met de tekenreeks en er wordt een nieuwe tekenreeks geretourneerd waarin de eerste overeenkomst van pattern wordt vervangen door de inhoud die door repl wordt opgegeven. De parameter pattern kan een tekenreeks of een reguliere expressie zijn. De parameter repl kan een tekenreeks of een functie zijn. Bij een functie wordt de door de functie geretourneerde tekenreeks ingevoegd in plaats van de overeenkomst. De oorspronkelijke tekenreeks wordt niet gewijzigd.

In het volgende voorbeeld wordt alleen de eerste instantie van "sh" (hoofdlettergevoelig) vervangen:

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

In het volgende voorbeeld worden alle instanties van "sh" (hoofdlettergevoelig) vervangen omdat de markering g (global) is ingesteld in de reguliere expressie:

    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.

In het volgende voorbeeld worden alle instanties van "sh" vervangen omdat de markering g (global) is ingesteld in de reguliere expressie en de overeenkomsten niet hoofdlettergevoelig zijn omdat de markering i (ignoreCase) is ingesteld:

    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.

Parameters

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

Verwante API-elementen

Zoekt naar het opgegeven pattern en retourneert de index van de eerste overeenkomende subtekenreeks. Wanneer geen overeenkomende subtekenreeks wordt gevonden, retourneert de methode -1.

Parameters

Verwante API-elementen

Retourneert een tekenreeks die het startIndex-teken en alle tekens tot (niet tot en met) het endIndex-teken bevat. Het oorspronkelijke object String wordt niet gewijzigd. Wanneer de parameter endIndex niet is opgegeven, is het einde van de subtekenreeks het einde van de tekenreeks. Wanneer het door startIndex geïndexeerde teken overeenkomt met het door endIndex geïndexeerde teken of zich rechts van dat teken bevindt, wordt met deze methode een lege tekenreeks geretourneerd.

Parameters

Verwante API-elementen

Splitst een object String op in een array van subtekenreeksen door het te scheiden waar de opgegeven parameter delimiter voorkomt.

Wanneer de parameter delimiter een reguliere expressie is, wordt alleen de eerste overeenkomst op een bepaalde positie van de tekenreeks beschouwd, ook wanneer met terugzoeken een overeenkomende niet-lege subtekenreeks op die positie kon worden gevonden. Bijvoorbeeld:

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

Wanneer de parameter delimiter een reguliere expressie is met groeperende ronde haakjes, worden bij elke overeenkomst van delimiter de resultaten (inclusief ongedefinieerde resultaten) van de groeperende ronde haakjes gesegmenteerd in de uitvoerarray. Bijvoorbeeld

     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."]

Wanneer de parameter limit is opgegeven, krijgt de geretourneerde array niet meer dan het aantal opgegeven elementen.

Wanneer delimiter een lege tekenreeks, een lege reguliere expressie of een reguliere expressie is die overeen kan komen met een lege tekenreeks, wordt elk enkel teken in de tekenreeks uitgevoerd als een element in de array.

Wanneer de parameter delimiter ongedefinieerd is, wordt de gehele tekenreeks opgenomen in het eerste element van de geretourneerde array.

Parameters

Verwante API-elementen

Retourneert een subtekenreeks die bestaat uit de tekens die beginnen bij de opgegeven startIndex en met een lengte opgegeven door len. De oorspronkelijke tekenreeks blijft ongewijzigd.

Parameters

Retourneert een tekenreeks die bestaat uit het teken dat wordt opgegeven door startIndex en alle tekens tot endIndex - 1. Wanneer endIndex niet is opgegeven, wordt String.length gebruikt. Wanneer de waarde van startIndex gelijk is aan de waarde van endIndex, wordt met deze methode een lege tekenreeks geretourneerd. Wanneer de waarde van startIndex hoger is dan de waarde van endIndex, worden de parameters automatisch omgewisseld voordat de functie wordt uitgevoerd. De oorspronkelijke tekenreeks blijft ongewijzigd.

Parameters

Retourneert een kopie van deze tekenreeks, waarbij alle hoofdletters zijn omgezet in kleine letters. De oorspronkelijke tekenreeks blijft ongewijzigd. Hoewel deze methode is bedoeld om de conversie af te handelen in overeenstemming met specifieke landinstellingen, produceert de implementatie van ActionScript 3.0 geen ander resultaat met de methode toLowerCase().

Verwante API-elementen

Retourneert een kopie van deze tekenreeks, waarbij alle kleine letters zijn omgezet in hoofdletters. De oorspronkelijke tekenreeks blijft ongewijzigd. Hoewel deze methode is bedoeld om de conversie af te handelen in overeenstemming met specifieke landinstellingen, produceert de implementatie van ActionScript 3.0 geen ander resultaat met de methode toUpperCase().

Verwante API-elementen

Retourneert een kopie van deze tekenreeks, waarbij alle hoofdletters zijn omgezet in kleine letters. De oorspronkelijke tekenreeks blijft ongewijzigd.

Met deze methode worden alle tekens (niet alleen A-Z) omgezet waarvoor een Unicode-equivalent in kleine letters bestaat:

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

Deze toewijzingen van hoofdletters en kleine letters worden gedefinieerd in de specificaties van de Unicode-tekendatabase

Verwante API-elementen

Retourneert een kopie van deze tekenreeks, waarbij alle kleine letters zijn omgezet in hoofdletters. De oorspronkelijke tekenreeks blijft ongewijzigd.

Met deze methode worden alle tekens (niet alleen a-z) omgezet waarvoor een Unicode-equivalent in hoofdetters bestaat.

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

Deze toewijzingen van hoofdletters en kleine letters worden gedefinieerd in de specificaties van de Unicode-tekendatabase

Verwante API-elementen

Retourneert de primitieve waarde van een instantie String. Deze methode is ontworpen om een object String om te zetten in een primitieve tekenreekswaarde. Omdat Flash automatisch valueOf() aanroept wanneer dit nodig is, hoeft u deze methode zelden expliciet aan te roepen.

1. De constructor voor StringExample declareert diverse lokale instanties van String, die worden geïnitialiseerd met verschillende tekenreeksen en een nieuw object StringHelper.
2. De klasse StringHelper kent de volgende methoden:
   • replace(): hiermee worden de methoden split() en join() van String aangeroepen om een subtekenreeks van de doorgegeven tekenreeks te verwijderen met een nieuwe.
   • trim(): hiermee wordt zowel trimBack() als trimFront() aangeroepen met behulp van de doorgegeven tekenreeksen en wordt de bijgewerkte tekenreeks geretourneerd.
   • trimFront(): hiermee worden alle tekens recursief verwijderd die overeenkomen met de parameter char, te beginnen vanaf de voorkant van de tekenreeks naar achteren toe, tot het eerste teken in de tekenreeks niet overeenkomt met char en wordt de bijgewerkte tekenreeks geretourneerd.
   • trimBack(): hiermee worden alle tekens recursief verwijderd die overeenkomen met de parameter char, te beginnen vanaf de einde van de tekenreeks naar voren toe, tot het laatste teken in de tekenreeks niet overeenkomt met char en wordt de bijgewerkte tekenreeks geretourneerd.
   • stringToCharacter(): hiermee wordt het eerste teken van de tekenreeks die wordt doorgegeven geretourneerd.
3. Vervolgens worden drie tekenreeksen geproduceerd met behulp van de gedeclareerde tekenreeksvariabelen met het aanroepen van de methode replace() die wordt gebruikt om de tweede tekenreeks te produceren en trim() om de derde tekenreeks te produceren.

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);
    }
}