String  - AS3

Ett heltal som anger hur många tecken det finns i det specificerade String-objektet.

Eftersom alla strängindexvärden är nollbaserade är indexvärdet för det sista tecknet i en sträng x x.length - 1.

Skapar ett nytt String-objekt som initieras till den angivna strängen.

Obs: Eftersom stränglitteraler är kortare än String-objekt och för det mesta lättare att använda, bör du använda stränglitteraler i stället för klassen String om du inte har en god anledning att använda ett String-objekt i stället för en stränglitteral.

Returnerar tecknet som finns på den position som anges av parametern index. Om index inte är ett tal från 0 till string.length - 1 returneras en tom sträng.

Metoden liknar String.charCodeAt() förutom att det returnerade värdet är ett tecken, inte en 16-bitars heltalsteckenkod.

Parametrar

Relaterade API-element

Returnerar den numeriska Unicode-teckenkoden för tecknet vid den angivna index. Om index inte är ett tal från 0 till string.length - 1 returneras NaN.

Metoden liknar String.charAt() förutom att det returnerade värdet är en 16-bitars heltalsteckenkod, inte ett riktigt tecken.

Parametrar

Relaterade API-element

Lägger till de angivna argumenten i slutet av String-objektet, konverterar dem till strängar om det behövs och returnerar den resulterande strängen. String-källobjektets ursprungsvärde ändras inte.

Parametrar

Returnerar en sträng som består av de tecken som representeras av Unicode-teckenkoderna i parametrarna.

Parametrar

Söker i strängen och returnerar positionen för den första förekomsten av val som påträffas vid eller efter startIndex i den anropande strängen. Indexet är nollbaserat, vilket innebär att det första tecknet i en sträng anses ha indexvärdet 0, inte 1. Om val inte hittas returneras -1.

Parametrar

Relaterade API-element

Söker från höger till vänster i strängen och returnerar indexvärdet för den sista förekomsten av val som påträffas före startIndex. Indexet är nollbaserat, vilket innebär att det första tecknet är på indexposition 0 och det sista är på string.length - 1. Om val inte hittas returneras -1.

Parametrar

Relaterade API-element

Jämför sorteringsordningen för två eller fler strängar och returnerar resultatet av jämförelsen som ett heltal. Samtidigt som den här metoden är tänkt att hantera jämförelsen på ett lokaltspecifikt sätt genererar inte implementeringen i ActionScript 3.0 något annat resultat än andra strängjämförelser, till exempel likhets- (==) eller olikhetsoperatorerna (!=). Om strängarna är lika är returvärdet 0. Om ursprungssträngens värde föregår strängvärdet som anges av other är returvärdet ett negativt heltal. Det absoluta värdet representerar det antal tecken som skiljer de två strängvärdena. Om ursprungssträngens värde kommer efter other är returvärdet ett positivt heltal. Det absoluta värdet representerar det antal tecken som skiljer de två strängvärdena.

Parametrar

Matchar det angivna pattern mot strängen.

Parametrar

Relaterade API-element

Matchar det angivna pattern mot strängen och returnerar en ny sträng där den första matchningen av pattern ersätts med innehållet som anges av repl. Parametern pattern kan vara en sträng eller ett reguljärt uttryck. Parametern repl kan vara en sträng eller en funktion. Om det är en funktion infogas strängen som returneras av funktionen i stället för matchningen. Originalsträngen ändras inte.

I följande exempel ersätts endast den första instansen av "sh" (skiftlägeskänslig):

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

I följande exempel ersätts alla instanser av "sh" (skiftlägeskänslig), eftersom flaggan g (global) ställs in i det reguljära uttrycket:

    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.

I följande exempel ersätts alla instanser av "sh", eftersom flaggan g (global) ställs in i det reguljära uttrycket och matchningarna är inte skiftlägeskänsliga eftersom flaggan i (ignoreCase) är inställd:

    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.

Parametrar

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

Relaterade API-element

Söker efter det angivna pattern och returnerar indexvärdet för den första matchande delsträngen. Om det inte finns en matchande delsträng returnerar metoden -1.

Parametrar

Relaterade API-element

Returnerar en sträng som omfattar startIndex-tecknet och alla tecken fram till, men inte inklusive, endIndex-tecknet. Det ursprungliga String-objektet ändras inte. Om parametern endIndex inte anges är slutet av delsträngen strängens slut. Om det tecken som anges av startIndex är samma som eller till höger om det tecken som anges av endIndex returnerar metoden en tom sträng.

Parametrar

Relaterade API-element

Delar upp ett String-objekt i en array med delsträngar genom att dela det varje gång den angivna avgränsarparametern delimiter påträffas.

Om parametern delimiter är ett reguljärt uttryck tas endast hänsyn till den första matchningen vid en given position i strängen, även om det går att hitta en delsträngsmatch på den positionen. Till exempel:

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

Om parametern delimiter är ett reguljärt uttryck som innehåller grupparenteser kommer resultaten (inklusive odefinierade resultat) i grupparantesen att delas upp i den resulterande arrayen varje gång delimiter matchas. Till exempel

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

Om parametern limit anges kommer den returnerade arrayen inte ha fler än det angivna antalet element.

Om delimiter är en tom sträng, ett tomt reguljärt uttryck eller ett reguljärt uttryck som kan matcha en tom sträng kommer varje enskilt tecken i strängen att returneras som ett element i arrayen.

Om parametern delimiter är odefinierad placeras hela strängen i det första elementet i arrayen som returneras.

Parametrar

Relaterade API-element

Returnerar en delsträng som består av tecknen från det angivna startIndex och har den längd som anges av len. Originalsträngen ändras inte.

Parametrar

Returnerar en sträng som består av det tecken som anges av startIndex och alla tecken fram till endIndex - 1. Om endIndex inte anges används String.length. Om värdet för startIndex är lika med värdet för endIndex returnerar metoden en tom sträng. Om värdet för startIndex är större än värdet för endIndex byter parametrarna automatiskt plats innan funktionen körs. Originalsträngen ändras inte.

Parametrar

Returnerar en kopia av strängen med alla versaler konverterade till gemener. Originalsträngen ändras inte. Samtidigt som den här metoden är tänkt att hantera konverteringen på ett lokalspecifikt sätt, genererar inte implementeringen i ActionScript 3.0 något annat resultat än metoden toLowerCase().

Relaterade API-element

Returnerar en kopia av strängen med alla gemener konverterade till versaler. Originalsträngen ändras inte. Samtidigt som den här metoden är tänkt att hantera konverteringen på ett lokalspecifikt sätt, genererar inte implementeringen i ActionScript 3.0 något annat resultat än metoden toUpperCase().

Relaterade API-element

Returnerar en kopia av strängen med alla versaler konverterade till gemener. Originalsträngen ändras inte.

Den här metoden konverterar alla tecken (inte bara A–Z) som Unicode har en gemen motsvarighet för:

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

De här skiftlägesmappningarna definieras i specifikationen för Unicode-teckendatabasen.

Relaterade API-element

Returnerar en kopia av strängen med alla gemener konverterade till versaler. Originalsträngen ändras inte.

Den här metoden konverterar alla tecken (inte bara a–z) som Unicode har en versal motsvarighet för:

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

De här skiftlägesmappningarna definieras i specifikationen för Unicode-teckendatabasen.

Relaterade API-element

Returnerar String-instansens primitiva värde Den här metodens syfte är att konvertera ett String-objekt till ett primitivt strängvärde. Eftersom Flash-miljöerna automatiskt anropar valueOf() när det behövs, behöver du oftast inte anropa den här metoden explicit.

1. Konstruktorn för StringExample deklarerar flera lokala String-instanser som initieras med olika strängar och ett nytt StringHelper-objekt.
2. Klassen StringHelper har följande metoder:
   • replace(): anropar metoderna split() och join() i klassen String för att ersätta en delsträng av den sträng som angavs mot en ny.
   • trim(): anropar både trimBack() och trimFront() med strängarna som angavs och returnerar den uppdaterade strängen.
   • trimFront():tar rekursivt bort alla tecken som matchar parametern char med början framifrån i strängen och arbetar sig bakåt mot strängslutet tills det första tecknet i strängen inte matchar char och returnerar den uppdaterade strängen.
   • trimBack(): tar rekursivt bort alla tecken som matchar parametern char med början bakifrån i strängen och arbetar sig framåt mot strängbörjan tills det sista tecknet i strängen inte matchar char och returnerar den uppdaterade strängen.
   • stringToCharacter(): returnerar det första tecknet i den angivna strängen.
3. Därefter skapas tre strängar med de deklarerade strängvariablerna med ett anrop till metoden replace(), som du använder för att skapa en andra sträng och trim() som du använder för att skapa en tredje sträng.

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