Das flash.utils-Paket enthält verschiedene Funktionen auf Paketebene zur Ausführung von zeitgesteuerten Code, zum Abrufen von Informationen zu Klassen und Objekten und zum Konvertieren von Escape-Zeichen.
Funktion | Definiert von | ||
---|---|---|---|
Bricht den angegebenen setInterval()-Aufruf ab. | flash.utils | ||
Bricht den angegebenen setTimeout()-Aufruf ab. | flash.utils | ||
Erstellt ein XML-Objekt, das das als Parameter der Methode angegebene ActionScript-Objekt beschreibt. | flash.utils | ||
Gibt in Abhängigkeit vom Wert „System.useCodePage“ eine entweder als UTF-8 oder in der System-Codepage kodierte, mit Escape-Sequenzen versehene Kopie des Eingabestrings zurück. | flash.utils | ||
Gibt einen Verweis auf das Klassenobjekt der im Parameter „name“ angegebenen Klasse zurück. | flash.utils | ||
Gibt den vollständig qualifizierten Klassennamen eines Objekts zurück. | flash.utils | ||
Gibt den vollständig qualifizierten Klassennamen der Basisklasse des im Parameter „value“ angegebenen Objekts zurück. | flash.utils | ||
Wird zur Berechnung der relativen Zeit verwendet. | flash.utils | ||
Führt eine Funktion in bestimmten Intervallen aus (Angabe in Millisekunden). | flash.utils | ||
Führt eine bestimmte Funktion nach der angegebenen Verzögerung aus (Angabe in Millisekunden). | flash.utils | ||
Gibt in Abhängigkeit vom Wert „System.useCodePage“ eine entweder aus UTF-8 oder aus der System-Codepage dekodierte Kopie des Eingabestrings ohne Escape-Sequenzen zurück. | flash.utils |
clearInterval | () | Funktion |
public function clearInterval(id:uint):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Bricht den angegebenen setInterval()
-Aufruf ab.
Parameter
id:uint — Der Bezeichner des setInterval() -Aufrufs, den Sie wie im folgenden Beispiel einer Variablen zuweisen:
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
setInterval()
-Methode ein Zeitintervall erstellt, und die myRepeatingFunction()
-Methode wird in regelmäßigen Intervallen von einer Sekunde aufgerufen.
Bei jedem Aufruf der myRepeatingFunction
-Methode wird der Wert der counter
-Eigenschaft erhöht. Wenn der Wert der stopCount
-Eigenschaft erreicht ist, wird die clearInterval()
-Methode in der intervalId
-Eigenschaft aufgerufen. Hierbei handelt es sich um eine Referenz-ID für das zuvor erstellte Intervall.
package { import flash.display.Sprite; import flash.utils.*; public class ClearIntervalExample extends Sprite { private var intervalDuration:Number = 1000; // duration between intervals, in milliseconds private var intervalId:uint; private var counter:uint = 0; private var stopCount:uint = 3; public function ClearIntervalExample() { intervalId = setInterval(myRepeatingFunction, intervalDuration, "Hello", "World"); } public function myRepeatingFunction():void { trace(arguments[0] + " " + arguments[1]); counter++; if(counter == stopCount) { trace("Clearing Interval"); clearInterval(intervalId); } } } }
clearTimeout | () | Funktion |
public function clearTimeout(id:uint):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Bricht den angegebenen Aufruf von setTimeout()
ab.
Parameter
id:uint — Der Bezeichner des setTimeout() -Aufrufs, den Sie wie im folgenden Beispiel einer Variablen zuweisen:
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
setTimeout()
-Methode eine weitere Methode nach einer angegebenen Verzögerung aufgerufen.
Es wird eine Schleife mit einer Million Durchläufen erstellt. Wenn das System die Anforderung bearbeiten kann, bevor eine zweite Anforderung ihre Gültigkeit verliert, wird durch clearTimeout()
die setTimeout()
-Anforderung gelöscht, und myDelayedFunction()
wird nicht aufgerufen.
package { import flash.display.Sprite; import flash.utils.*; public class ClearTimeoutExample extends Sprite { private var delay:Number = 1000; // delay before calling myDelayedFunction private var intervalId:uint; private var count:uint = 1000000; public function ClearTimeoutExample() { intervalId = setTimeout(myDelayedFunction, delay); startCounting(); } public function startCounting():void { var i:uint = 0; do { if(i == count-1) { clearTimeout(intervalId); trace("Your computer can count to " + count + " in less than " + delay/1000 + " seconds."); } i++; } while(i < count) } public function myDelayedFunction():void { trace("Time expired."); } } }
describeType | () | Funktion |
public function describeType(value:*):XML
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt ein XML-Objekt, das das als Parameter der Methode angegebene ActionScript-Objekt beschreibt. Diese Methode implementiert das Programmierkonzept von reflection für die ActionScript-Programmiersprache.
Wenn der Parameter value
eine Instanz eines bestimmten Typs ist, enthält das zurückgegebene XML-Objekt alle Instanzeigenschaften dieses Typs, jedoch nicht die statischen Eigenschaften. Sie können dies beim Analysieren des XML-Objekts feststellen, indem Sie das Attribut des Tags <type>
isStatic
überprüfen. Dieses Attribut hat den Wert false
, wenn der Parameter value
eine Instanz eines Typs ist.
Um die statischen Eigenschaften eines Typs zu erhalten, müssen Sie als Parameter value
den Typ selbst übergeben. Das zurückgegebene XML-Objekt enthält nicht nur die statischen Eigenschaften des Typs, sondern auch alle entsprechenden Instanzeigenschaften. Die Instanzeigenschaften sind innerhalb eines Tags mit der Bezeichnung <factory>
zusammengefasst und unterscheiden sich so von den statischen Eigenschaften. In diesem Fall hat das Attribut isStatic
des Tags <type>
den Wert true
.
Hinweis: Wenn Sie nur die Vererbungshierarchie eines Objekts überprüfen möchten und die durch describeType()
bereitgestellten weiteren Informationen nicht benötigen, verwenden Sie stattdessen die Funktionen getQualifiedClassName()
und getQualifiedSuperclassName()
.
Die folgende Tabelle beschreibt einige der Tags und Attribute des XML-Objekts, das von describeType()
generiert wurde (alle zurückgegebenen Klassen- und Interfacenamen sind im voll qualifizierten Format):
Tag | Attribut | Beschreibung |
---|---|---|
<type> | Das Haupt-Tag des XML-Objekts. | |
name | Der Name des Datentyps des ActionScript-Objekts. | |
base | Die direkte Superklasse der Definitionsklasse des ActionScript-Objekts. Wenn das ActionScript-Objekt ein Klassenobjekt ist, ist der Wert Class . | |
isDynamic | true , wenn die Definitionsklasse des ActionScript-Objekts dynamisch ist, sonst false . Wenn das ActionScript-Objekt ein Klassenobjekt ist, ist der Wert true , da die Class-Klasse dynamisch ist. | |
isFinal | true , wenn die Definitionsklasse des ActionScript-Objekts final ist, sonst false . | |
isStatic | true , wenn das ActionScript-Objekt ein Klassenobjekt oder eine Konstruktorfunktion ist, sonst false . Dieses Attribut hat die Bezeichnung isStatic , da beim Wert true alle nicht im Tag factory verschachtelten Tags statisch sind. | |
<extendsClass> | Für jede Superklasse der Definitionsklasse des ActionScript-Objekts gibt es ein eigenes extendsClass -Tag. | |
type | Der Name einer Superklasse, die die Definitionsklasse des ActionScript-Objekts erweitert. | |
<implementsInterface> | Für jede von der Definitionsklasse des ActionScript-Objekts oder einer ihrer Superklassen implementierten Schnittstelle gibt es ein eigenes implementsInterface -Tag. | |
type | Der Name einer Schnittstelle, die über die Definitionsklasse des ActionScript-Objekts implementiert wird. | |
<accessor> | Dies ist eine Eigenschaft, die von Funktionen zum Abrufen und Setzen von Werten definiert wird. | |
name | Der Name der accessor-Eigenschaft. | |
access | Die Zugriffsrechte der Eigenschaft. Mögliche Werte sind u. a. readonly , writeonly und readwrite . | |
type | Der Datentyp der Eigenschaft. | |
declaredBy | Die Klasse, die die verknüpften get-/set-Funktionen enthält. | |
<constant> | Eine Konstante ist eine mit der const -Anweisung definierte Eigenschaft. | |
name | Der Name der Konstante. | |
type | Der Datentyp der Konstante. | |
<Methode> | Eine Methode ist eine als Teil einer Klassendefinition deklarierte Funktion. | |
name | Der Name der Methode. | |
declaredBy | Die Klasse, die die Methodendefinition enthält. | |
returnType | Der Datentyp des Rückgabewerts der Methode. | |
<parameter> | Für jeden von einer Methode definierten Parameter gibt es ein eigenes parameter -Tag. Dieses Tag ist immer innerhalb eines <method> -Tags geschachtelt. | |
index | Ein Zahlenwert, der der Position des Parameters in der Parameterliste der Methode entspricht. Der erste Parameter hat den Wert 1. | |
type | Der Datentyp des Parameters. | |
optional | true , wenn der Parameter optional ist, andernfalls false . | |
<variable> | Eine Variable ist eine mit der var -Anweisung definierte Eigenschaft. | |
name | Der Name der Variablen. | |
type | Der Datentyp der Variablen. | |
<factory> | Wenn das ActionScript-Objekt ein Klassenobjekt oder eine Konstruktorfunktion ist, sind alle Instanzeigenschaften und Methoden innerhalb dieses Tags geschachtelt. Wenn das Attribut isStatic des <type> -Tags den Wert true hat, sind alle nicht im <factory> -Tag verschachtelten Eigenschaften und Methoden statisch. Dieses Tag ist nur vorhanden, wenn das ActionScript-Objekt ein Klassenobjekt oder eine Konstruktorfunktion ist. |
Parameter
value:* — Das Objekt, für das eine Typbeschreibung gewünscht wird. Dieser Methode können beliebige ActionScript-Werte übergeben werden, einschließlich aller verfügbaren ActionScript-Typen, Objektinstanzen, Grunddatentypen wie „uint“ und Klassenobjekte.
|
XML — Ein XML-Objekt mit Detailinformationen zu dem als Parameter übergebenen Objekt. Es enthält die folgenden Angaben zum Objekt:
Hinweis: Mit |
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
package { import flash.display.Sprite; import flash.utils.describeType; public class DescribeTypeExample extends Sprite { public function DescribeTypeExample() { var child:Sprite = new Sprite(); var description:XML = describeType(child); trace(description..accessor.@name.toXMLString()); } } }
escapeMultiByte | () | Funktion |
public function escapeMultiByte(value:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt in Abhängigkeit vom Wert „System.useCodePage“ eine entweder als UTF-8 oder in der System-Codepage kodierte, mit Escape-Sequenzen versehene Kopie des Eingabestrings zurück. Durch die Verwendung von „System.useCodePage“ können mit der Laufzeitumgebung auch ältere, in lokalen Codepages kodierte Inhalte wiedergegeben werden, jedoch nur auf Systemen, die diese Codepage verwenden. So werden zum Beispiel als Shift-JIS
kodierte japanische Daten nur unter einem Betriebssystem ordnungsgemäß in Escape-Sequenzen konvertiert und rückkonvertiert, das als Standard-Codepage Japanisch verwendet.
Parameter
value:String — Der mit Escape-Sequenzen zu versehende String.
|
String — Eine mit Escape-Sequenzen versehene Kopie des Eingabestrings. Wenn „System.useCodePage“ den Wert true aufweist, wird zum Umwandeln in Escape-Sequenzen die Codepage des Systems verwendet. Wenn „System.useCodePage“ den Wert false aufweist, wird zum Umwandeln in Escape-Sequenzen die Kodierung UTF-8 verwendet. Zum Beispiel wird der Eingabestring "Crüe" auf allen Systemen in die Zeichenfolge "Cr%C3%BCe" konvertiert, wenn "System.useCodePage" den Wert false aufweist. Wenn "System.useCodePage" den Wert true aufweist und das System die Codepage "Latin" verwendet, wird "Crüe" in "Cr%FCe" umgewandelt. Wenn das System eine andere Codepage verwendet, die nicht den Buchstaben 'ü' enthält, ist das Ergebnis mit hoher Wahrscheinlichkeit "Cr?e". Wenn "System.useCodePage" den Wert true hat, führt das Entfernen der Escape-Sequenzen aus dem Eingabestring "Cr%C3%BCe" je nach System zu unterschiedlichen falschen Ergebnissen, beispielsweise zu "Crüe" auf Systemen mit lateinischer Codepage. Ebenso führt das Entfernen der Escape-Sequenzen aus dem Eingabestring "Cr%FCe" zu "Cre", "Cr?e" oder je nach Codepage zu anderen Varianten, wenn „System.useCodePage“ den Wert false hat.
|
getDefinitionByName | () | Funktion |
public function getDefinitionByName(name:String):Object
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt einen Verweis auf das Klassenobjekt der im Parameter name
angegebenen Klasse zurück.
Parameter
name:String — Der Name einer Klasse.
|
Object — Gibt einen Verweis auf das Klassenobjekt der im Parameter name angegebenen Klasse zurück.
|
Auslöser
ReferenceError — Es ist keine öffentliche Definition mit dem angegebenen Namen vorhanden.
|
Beispiel ( Verwendung dieses Beispiels )
GetDefinitionByNameExample
nacheinander fünf orangefarbene Quadrate erstellt. Dies wird in den folgenden Schritten erreicht:
- Es werden Variablen für die orange Hintergrundfarbe und die Größe von 80 Pixel deklariert, die später für die Zeichnung des Quadrats benötigt werden.
- Im Konstruktor wird die
ClassReference
-Variable vom Typ „Class“ dem Typ „Sprite“ zugewiesen. - Es wird die ClassReference-Instanz
instance
instanziiert. - Da es sich bei
instance
per Referenz um ein Sprite-Objekt handelt, kann ein Quadrat gezeichnet und der Anzeigeliste mit den für Sprite verfügbaren Methoden hinzugefügt werden.
package { import flash.display.DisplayObject; import flash.display.Sprite; import flash.utils.getDefinitionByName; public class GetDefinitionByNameExample extends Sprite { private var bgColor:uint = 0xFFCC00; private var size:uint = 80; public function GetDefinitionByNameExample() { var ClassReference:Class = getDefinitionByName("flash.display.Sprite") as Class; var instance:Object = new ClassReference(); instance.graphics.beginFill(bgColor); instance.graphics.drawRect(0, 0, size, size); instance.graphics.endFill(); addChild(DisplayObject(instance)); } } }
getQualifiedClassName | () | Funktion |
public function getQualifiedClassName(value:*):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den vollständig qualifizierten Klassennamen eines Objekts zurück.
Parameter
value:* — Das Objekt, für das ein vollständig qualifizierter Klassenname gewünscht wird. Dieser Methode können beliebige ActionScript-Werte übergeben werden, einschließlich aller verfügbaren ActionScript-Typen, Objektinstanzen, Grunddatentypen wie „uint“ und Klassenobjekte.
|
String — Ein String mit dem vollständig qualifizierten Klassennamen.
|
Verwandte API-Elemente
getQualifiedSuperclassName | () | Funktion |
public function getQualifiedSuperclassName(value:*):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt den vollständig qualifizierten Klassennamen der Basisklasse des im Parameter value
angegebenen Objekts zurück. Diese Funktion stellt eine schnellere Möglichkeit zum Abrufen des Basisklassennamens dar als describeType()
, gibt jedoch nicht alle der Informationen zurück, die describeType()
liefert.
Nachdem Sie mit dieser Funktion den Namen einer Klasse abgerufen haben, können Sie diesen mit der Funktion getDefinitionByName()
in einen Klassenverweis umwandeln.
Hinweis: Diese Funktion ist auf Instanzhierarchien beschränkt, während die describeType()
-Funktion Klassenobjekthierarchien verwendet, wenn der Parameter value
ein Datentyp ist. Der Aufruf von describeType()
für einen Datentyp gibt die anhand der Klassenobjekthierarchie ermittelte Superklasse zurück. In der Klassenobjekthierarchie erben alle Klassenobjekte von „Class“. Die getQualifiedSuperclassName()
-Funktion ignoriert jedoch die Klassenobjekthierarchie und gibt die Superklasse anhand der vertrauteren Instanzhierarchie zurück. Zum Beispiel gibt der Aufruf von getQualifiedSuperclassName(String)
den Wert Object
zurück, obwohl technisch gesehen das String-Klassenobjekt von „Class“ geerbt wird. Anders ausgedrückt führt der Aufruf mit einer Instanz eines Typs oder mit dem Typ selbst zum selben Ergebnis.
Parameter
value:* — Ein beliebiger Wert.
|
String — Ein vollständig qualifizierter Basisklassenname oder null , wenn keiner vorhanden ist.
|
Verwandte API-Elemente
getTimer | () | Funktion |
public function getTimer():int
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Wird zur Berechnung der relativen Zeit verwendet. Für eine Flash-Laufzeitumgebung, die ActionScript 3.0 verarbeitet, gibt diese Methode die Anzahl der Millisekunden an, die seit dem Start des virtuellen Rechners für ActionScript 3.0 (AVM2) verstrichen sind. Für eine Flash-Laufzeitumgebung, die ActionScript 2.0 verarbeitet, gibt diese Methode die Anzahl der Millisekunden an, die seit dem Beginn der Initialisierung durch die Flash-Laufzeitumgebung verstrichen sind. Flash-Laufzeitumgebungen verwenden zwei virtuelle Rechner für die Verarbeitung von ActionScript. AVM1 ist der virtuelle ActionScript-Recher, der für die Ausführung von ActionScript 1.0 und 2.0 verwendet wird. AVM2 ist der virtuelle ActionScript-Rechner, der für die Ausführung von ActionScript 3.0 verwendet wird. Das Verhalten der getTimer()
-Methode für AVM1 unterscheidet sich vom Verhalten für AVM2.
Informationen zu einem Kalenderdatum (Zeitstempel) finden Sie bei den Angaben zum Date-Objekt.
Rückgabewerteint — Die Anzahl der Millisekunden seit der Initialisierung der Laufzeitumgebung (bei Verarbeitung von ActionScript 2.0) oder seit dem Start des virtuellen Computers (bei Verarbeitung von ActionScript 3.0). Wenn die Laufzeitumgebung die Wiedergabe einer SWF-Datei startet und später eine weitere SWF-Datei geladen wird, stellt der Rückgabewert die Differenz zum Zeitpunkt des Ladens der ersten SWF-Datei dar.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
GetTimerExample
ermittelt und angezeigt, wie viele Millisekunden seit der Initialisierung der Laufzeitumgebung vergangen sind.
package { import flash.utils.getTimer; import flash.display.Sprite; public class GetTimerExample extends Sprite { public function GetTimerExample() { var duration:uint = getTimer(); trace("duration: " + duration); } } }
setInterval | () | Funktion |
public function setInterval(closure:Function, delay:Number, ... arguments):uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Führt eine Funktion in bestimmten Intervallen aus (Angabe in Millisekunden).
Anstelle der setInterval()
-Methode empfiehlt es sich, ein Timerobjekt mit dem angegebenen Intervall zu erstellen und als Parameter repeatCount
den Wert 0 (endlose Wiederholung) zu verwenden.
Wenn Sie die clearInterval()
-Methode verwenden möchten, um den setInterval()
-Aufruf zu stornieren, weisen Sie den setInterval()
-Aufruf einer Variablen zu (die die clearInterval()
-Funktion später referenzieren wird). Wenn Sie die clearInterval()
-Funktion nicht aufrufen, um den setInterval()
-Aufruf zu stornieren, wird das Objekt, das die setTimeout-Schließfunktion enthält, nicht im Garbagekollektor abgelegt.
Parameter
closure:Function — Der Name der auszuführenden Funktion. Der Name darf keine Anführungszeichen oder Klammern sowie keine Parameter der aufzurufenden Funktion enthalten. Verwenden Sie beispielsweise functionName und nicht functionName() oder functionName(param) .
| |
delay:Number — Das Intervall in Millisekunden.
| |
... arguments — Eine optionale Liste von Parametern, die an die closure-Funktion übergeben werden.
|
uint — Eindeutiger numerischer Bezeichner für den in Intervallen auszuführenden Prozess. Verwenden Sie diesen Bezeichner, um den Prozess abzubrechen, indem Sie die clearInterval() -Methode aufrufen.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
setInterval()
-Methode ein Zeitintervall erstellt, und die myRepeatingFunction()
-Methode wird in regelmäßigen Intervallen von einer Sekunde aufgerufen.
package { import flash.display.Sprite; import flash.utils.*; public class SetIntervalExample extends Sprite { private var intervalDuration:Number = 1000; // duration between intervals, in milliseconds public function SetIntervalExample() { var intervalId:uint = setInterval(myRepeatingFunction, intervalDuration, "Hello", "World"); } public function myRepeatingFunction():void { trace(arguments[0] + " " + arguments[1]); } } }
setTimeout | () | Funktion |
public function setTimeout(closure:Function, delay:Number, ... arguments):uint
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Führt eine bestimmte Funktion nach der angegebenen Verzögerung aus (Angabe in Millisekunden).
Anstatt diese Methode zu verwenden, empfiehlt es sich, ein Timerobjekt mit dem angegebenen Intervall zu erstellen und als repeatCount
-Parameter den Wert 1 (einmalige Ausführung) zu verwenden.
Wenn Sie die clearTimeout()
-Methode verwenden möchten, um den setTimeout()
-Aufruf zu stornieren, weisen Sie dem setTimeout()
-Aufruf eine Variable zu (die die clearTimeout()
-Funktion später referenziert). Wenn Sie die clearTimeout()
-Funktion nicht aufrufen, um den setTimeout()
-Aufruf zu stornieren, wird das Objekt, das die setTimeout-Schließfunktion enthält, nicht im Garbagekollektor abgelegt.
Parameter
closure:Function — Der Name der auszuführenden Funktion. Der Name darf keine Anführungszeichen oder Klammern sowie keine Parameter der aufzurufenden Funktion enthalten. Verwenden Sie beispielsweise functionName und nicht functionName() oder functionName(param) .
| |
delay:Number — Die Verzögerung in Millisekunden, bis die Funktion ausgeführt wird.
| |
... arguments — Eine optionale Liste von Parametern, die an die closure-Funktion übergeben werden.
|
uint — Eindeutiger numerischer Bezeichner für den in Intervallen auszuführenden Prozess. Verwenden Sie diesen Bezeichner, um den Prozess abzubrechen, indem Sie die clearTimeout() -Methode aufrufen.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
setTimeout()
-Methode eine weitere Methode nach einer angegebenen Verzögerung aufgerufen.
package { import flash.display.Sprite; import flash.utils.*; public class SetTimeoutExample extends Sprite { private var delay:Number = 1000; // delay before calling myDelayedFunction public function SetTimeoutExample() { var intervalId:uint = setTimeout(myDelayedFunction, delay, "Hello", "World"); } public function myDelayedFunction():void { trace(arguments[0] + " " + arguments[1]); } } }
unescapeMultiByte | () | Funktion |
public function unescapeMultiByte(value:String):String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt in Abhängigkeit vom Wert „System.useCodePage“ eine entweder aus UTF-8 oder aus der System-Codepage dekodierte Kopie des Eingabestrings ohne Escape-Sequenzen zurück. Durch die Verwendung von „System.useCodePage“ können mit der Laufzeitumgebung auch ältere, in lokalen Codepages kodierte Inhalte wiedergegeben werden, jedoch nur auf Systemen, die diese Codepage verwenden. So werden zum Beispiel als Shift-JIS
kodierte japanische Daten nur unter einem Betriebssystem ordnungsgemäß in Escape-Sequenzen konvertiert und rückkonvertiert, das als Standard-Codepage Japanisch verwendet.
Parameter
value:String — Der mit Escape-Sequenzen versehene String, der rückkonvertiert werden soll.
|
String — Eine Kopie des Eingabestrings ohne Escape-Sequenzen. Wenn „System.useCodePage“ den Wert true aufweist, wird zum Umwandeln der Escape-Sequenzen die Codepage des Systems verwendet. Wenn „System.useCodePage“ den Wert false aufweist, werden die Escape-Sequenzen aus der Kodierung UTF-8 rückkonvertiert. Wenn der Eingabestring beispielsweise "Crüe" und „System.useCodePage“ false ist, ist das Ergebnis auf allen Systemen "Crüe". Wenn „System.useCodePage“ true und der Eingabestring "CR%FCe" ist und das System eine lateinische Codepage verwendet, ist das Ergebnis ebenfalls "CRüe". Wenn die Escape-Sequenzen in "CR%C3%BCe" entfernt werden und „System.useCodePage“ auf true gesetzt ist, entstehen auf verschiedenen Systemen verschiedene unerwünschte Ergebnisse, wie z. B. "Crüe" auf einem lateinischen System. Ebenso führt das Entfernen der Escape-Sequenzen aus dem Eingabestring "Cr%FCe" zu "Cre", "Cr?e" oder je nach Codepage zu anderen Varianten, wenn „System.useCodePage“ den Wert false hat.
|
Tue Jun 12 2018, 10:19 AM Z