| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| |
| Licensed to the Apache Software Foundation (ASF) under one or more |
| contributor license agreements. See the NOTICE file distributed with |
| this work for additional information regarding copyright ownership. |
| The ASF licenses this file to You under the Apache License, Version 2.0 |
| (the "License"); you may not use this file except in compliance with |
| the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, software |
| distributed under the License is distributed on an "AS IS" BASIS, |
| WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| See the License for the specific language governing permissions and |
| limitations under the License. |
| |
| --> |
| <apiPackage xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" id="__Global__" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiPackage/apiPackage "><apiName class="- topic/title reference/title apiRef/apiName ">__Global__</apiName><apiDetail class="- topic/body reference/refbody apiRef/apiDetail "/><apiClassifier languages="" id="globalClassifier:VerifyError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">VerifyError</apiName><shortdesc class="- topic/shortdesc "> |
| Die VerifyError-Klasse repräsentiert einen Fehler, der auftritt, wenn eine SWF-Datei angetroffen wird, die ungültig ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein VerifyError-Fehler wird ausgelöst, wenn eine ungültige oder beschädigte SWF-Datei angetroffen wird. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die VerifyError-Klasse repräsentiert einen Fehler, der auftritt, wenn eine SWF-Datei angetroffen wird, die ungültig ist. |
| |
| </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.display.xml#Loader" class="- topic/link "><linktext class="- topic/linktext ">Loader-Klasse</linktext></link></related-links><apiConstructor id="VerifyError:VerifyError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">VerifyError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues VerifyError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die mit dem VerifyError-Objekt verknüpfte Meldung. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues VerifyError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:ArgumentError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">ArgumentError</apiName><shortdesc class="- topic/shortdesc "> |
| Die ArgumentError-Klasse repräsentiert einen Fehler, der auftritt, wenn die in einer Funktion angegebenen Argumente nicht den für diese Funktion definierten Argumenten entsprechen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein ArgumentError-Fehler wird ausgelöst, wenn die bei einem Funktionsaufruf bereitgestellten Parameterwerte nicht den Parametern entsprechen, die für diese Funktion definiert wurden. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die ArgumentError-Klasse repräsentiert einen Fehler, der auftritt, wenn die in einer Funktion angegebenen Argumente nicht den für diese Funktion definierten Argumenten entsprechen. Dieser Fehler tritt beispielsweise auf, wenn eine Funktion mit der falschen Anzahl an Argumenten, einem Argument mit falschem Datentyp oder ein unzulässiges Argument aufgerufen wird. |
| |
| </apiDesc><example conref="examples\ArgumentErrorExample.as" class="- topic/example "> Dieses Beispiel veranschaulicht, wie ein <codeph class="+ topic/ph pr-d/codeph ">RangeError</codeph>-Fehler erzeugt und in einer<codeph class="+ topic/ph pr-d/codeph ">try..catch</codeph>-Anweisung verarbeitet wird. Die Funktion <codeph class="+ topic/ph pr-d/codeph ">println()</codeph> nimmt als Argument einen String entgegen; da aber zwei Strings bereitgestellt werden, wird der Fehler ausgelöst. In der Regel würde der Compiler einen solchen Fehler erfassen, aufgrund der <codeph class="+ topic/ph pr-d/codeph ">this[]</codeph>-Syntax in der <codeph class="+ topic/ph pr-d/codeph ">try</codeph>-Anweisung wird jedoch die Compilersyntax, mit der auf diese Funktion geprüft wird, umgangen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ArgumentErrorExample extends Sprite { |
| public function ArgumentErrorExample() { |
| println("Hello World"); |
| |
| try { |
| this["println"]("Hello", "World"); |
| } |
| catch(e:ArgumentError) { |
| trace(e); |
| } |
| } |
| |
| public function println(str:String):void { |
| trace(str); |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><apiConstructor id="ArgumentError:ArgumentError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">ArgumentError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues ArgumentError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der mit dem Fehler verknüpft ist. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues ArgumentError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:QName" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">QName</apiName><shortdesc class="- topic/shortdesc "> |
| |
| QName-Objekte repräsentieren qualifizierte Namen von XML-Elementen und -Attributen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">QName |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| |
| QName-Objekte repräsentieren qualifizierte Namen von XML-Elementen und -Attributen. Jedes QName-Objekt besitzt einen lokalen Namen und einen Namespace-URI (Uniform Resource Identifier, einheitlichen Ressourcenbezeichner). Ist der Wert des Namespace-URI <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, entspricht das QName-Objekt einem beliebigen Namespace. Verwenden Sie den QName-Konstruktor, um ein neues QName-Objekt zu erstellen, bei dem es sich entweder um eine Kopie eines anderen QName-Objekts handelt oder um ein neues QName-Objekt mit dem <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> eines Namespace-Objekts und dem <codeph class="+ topic/ph pr-d/codeph ">localName</codeph> eines QName-Objekts. |
| |
| |
| <p class="- topic/p ">E4X-spezifische Methoden können QName-Objekte anstelle von Strings verwenden. E4X-Methoden sind in den Klassen QName, Namespace, XML und XMLList zu finden. Diese E4X-Methoden, die einen String akzeptieren, können stattdessen auch ein QName-Objekt annehmen. Durch diese Austauschbarkeit ist es möglich, dass die Namespace-Unterstützung beispielsweise mit der Methode <codeph class="+ topic/ph pr-d/codeph ">XML.child()</codeph> funktioniert. </p> |
| |
| <p class="- topic/p ">Die QName-Klasse implementiert (zusammen mit den Klassen XML, XMLList und Namespace) leistungsstarke Standards zur XML-Verarbeitung, die in der Spezifikation ECMA-357, Edition 2: „ECMAScript for XML (E4X)“ definiert sind.</p> |
| |
| <p class="- topic/p ">Wenn ein qualifizierter Bezeichner ausgewertet wird, ergibt sich ein QName-Objekt. Wird das QName-Objekt eines XML-Elements angegeben ohne einen Namespace zu identifizieren, wird die <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft des verknüpften QName-Objekts auf den globalen Standardnamespace gesetzt. Wird das QName-Objekt eines XML-Attributs angegeben ohne einen Namespace zu identifizieren, wird die <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft auf einen leeren String gesetzt.</p> |
| |
| </apiDesc><example conref="examples\QNameExample.as" class="- topic/example "> Im folgenden Beispiel sehen Sie, wie eine QName-Instanz erstellt und damit XML-Elemente ausgewählt werden. Es werden zwei Möglichkeiten zum Erstellen einer QName-Instanz gezeigt: |
| <ol class="- topic/ol "><li class="- topic/li ">Erstellen Sie eine Namespace-Instanz, und übergeben Sie sie dann an den QName-Konstruktor. Dieser Ansatz ist zu empfehlen, wenn Sie die <codeph class="+ topic/ph pr-d/codeph ">Namespace.prefix</codeph>-Eigenschaft später für andere Zwecke verwenden möchten.</li><li class="- topic/li ">Erstellen Sie eine QName-Instanz und verwenden Sie einen einfachen Stringwert für den <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Parameter im QName-Konstruktor.</li></ol> |
| <p class="- topic/p "> |
| Dieser Code bewirkt Folgendes: |
| </p> |
| <ol class="- topic/ol "><li class="- topic/li ">Definiert eine XML-Variable namens <codeph class="+ topic/ph pr-d/codeph ">rssXML</codeph>.</li><li class="- topic/li ">Erstellt ein neues Namespace-Objekt mit dem Präfix <codeph class="+ topic/ph pr-d/codeph ">dc</codeph>.</li><li class="- topic/li ">Erstellt ein neues QName-Objekt mithilfe des Namespace-Objekts und dem lokalen Namen <codeph class="+ topic/ph pr-d/codeph ">creator</codeph>.</li><li class="- topic/li ">Ruft die <codeph class="+ topic/ph pr-d/codeph ">showDescendants()</codeph>-Methode auf, die mithilfe der <codeph class="+ topic/ph pr-d/codeph ">XML.descendants()</codeph>-Methode eine XMLList-Instanz abruft. Diese Instanz enthält alle untergeordneten Elemente, deren qualifizierte Namen mit der gegebenen QName-Instanz übereinstimmen.</li><li class="- topic/li ">Zeigt den qualifizierten Namen und den Textwert jedes aufgelisteten Elements mithilfe einer <codeph class="+ topic/ph pr-d/codeph ">for each</codeph>-Schleife an.</li><li class="- topic/li ">Erstellt ein weiteres QName-Objekt und verwendet einen Stringwert für den Parameter <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> sowie den lokalen Namen <codeph class="+ topic/ph pr-d/codeph ">date</codeph>.</li><li class="- topic/li ">Ruft die <codeph class="+ topic/ph pr-d/codeph ">showDescendants()</codeph>-Methode erneut auf, um den Namen und den Textwert der untergeordneten Elemente anzuzeigen.</li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package |
| { |
| import flash.display.Sprite; |
| |
| public class QNameExample extends Sprite |
| { |
| public function QNameExample() |
| { |
| var rssXML:XML = <rdf:RDF |
| xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
| xmlns="http://purl.org/rss/1.0/" |
| xmlns:dc="http://purl.org/dc/elements/1.1/"> |
| <channel rdf:about="http://www.xml.com/cs/xml/query/q/19"> |
| <title>Test RSS</title> |
| <link>http://www.adobe.com/</link> |
| <description>This is a test RSS document.</description> |
| <language>en-us</language> |
| <items> |
| <rdf:Seq> |
| <rdf:li rdf:resource="http://www.adobe.com/devnet/flash/"/> |
| <rdf:li rdf:resource="http://www.adobe.com/devnet/flex/"/> |
| </rdf:Seq> |
| </items> |
| </channel> |
| <item rdf:about="http://www.adobe.com/devnet/flash/"> |
| <title>Flash Developer Center</title> |
| <link>http://www.adobe.com/devnet/flash/</link> |
| <description>Welcome to the Flash Developer Center</description> |
| <dc:creator>Adobe</dc:creator> |
| <dc:date>2005-08-08</dc:date> |
| </item> |
| <item rdf:about="http://www.adobe.com/devnet/flex/"> |
| <title>Flex Developer Center</title> |
| <link>http://www.adobe.com/devnet/flex/</link> |
| <description>Welcome to the Flex Developer Center</description> |
| <dc:creator>Adobe</dc:creator> |
| <dc:date>2005-10-16</dc:date> |
| </item> |
| </rdf:RDF>; |
| |
| var dcNamespace:Namespace = new Namespace("dc", "http://purl.org/dc/elements/1.1/"); |
| var creatorQName:QName = new QName(dcNamespace, "creator"); |
| trace(creatorQName.uri); // http://purl.org/dc/elements/1.1/ |
| trace(creatorQName.localName); // creator |
| |
| showDescendants(rssXML, creatorQName); |
| |
| var dateQName:QName = new QName("http://purl.org/dc/elements/1.1/", "date"); |
| trace(dateQName.uri); // http://purl.org/dc/elements/1.1/ |
| trace(dateQName.localName); // date |
| |
| showDescendants(rssXML, dateQName); |
| } |
| |
| public function showDescendants(xmlData:XML, qualifiedName:QName):void |
| { |
| var decendantList:XMLList = xmlData.descendants(qualifiedName); |
| |
| for each (var element:XML in decendantList) |
| { |
| trace(element.name()); // the fully qualified name, |
| // like "http://purl.org/dc/elements/1.1/::creator" |
| trace(element); // the simple text value of each element, like "Adobe" |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#XML" class="- topic/link "><linktext class="- topic/linktext ">XML</linktext></link><link href="#XMLList" class="- topic/link "><linktext class="- topic/linktext ">XMLList</linktext></link><link href="#Namespace" class="- topic/link "><linktext class="- topic/linktext ">Namespace</linktext></link><link href="http://www.ecma-international.org/publications/standards/Ecma-357.htm" class="- topic/link "><linktext class="- topic/linktext ">Spezifikation ECMA-357, Edition 2: „ECMAScript for XML (E4X)“</linktext></link></related-links><apiConstructor id="QName:QName_0" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">QName</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein QName-Objekt, das eine Kopie eines anderen QName-Objekts ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><internal>(pdehaan) i changed first param from "name" to "uri" as the previous naming was very confusing |
| </internal></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">qname</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">QName</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das zu kopierende QName-Objekt. Objekte eines anderen Typs werden in einen String konvertiert, der dann der <codeph class="+ topic/ph pr-d/codeph ">localName</codeph>-Eigenschaft des neuen QName-Objekts zugewiesen wird. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein QName-Objekt, das eine Kopie eines anderen QName-Objekts ist. Wenn der an den Konstruktor übergebene Parameter ein QName-Objekt ist, wird eine Kopie des QName-Objekts erstellt. Handelt es sich bei dem Parameter aber nicht um ein QName-Objekt, wird der Parameter in einen String konvertiert und der <codeph class="+ topic/ph pr-d/codeph ">localName</codeph>-Eigenschaft der neuen QName-Instanz zugewiesen. Ist der Parameter <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> oder wurde er gar nicht angegeben, wird ein neues QName-Objekt erstellt, wobei die <codeph class="+ topic/ph pr-d/codeph ">localName</codeph>-Eigenschaft auf einen leeren String gesetzt ist. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Diese Klasse zeigt zwei Konstruktoreinträge, da jede Form andere Parameter akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Parameter, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.</p> |
| |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiConstructor id="QName:QName_1" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">QName</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein QName-Objekt mit einem URI-Objekt aus einem Namespace-Objekt und localName aus einem QName-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">QName |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uri</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Namespace</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Namespace-Objekt, aus dem der <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Wert zu kopieren ist. Parameter aller anderen Typen werden in einen String konvertiert. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">localName</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">QName</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein QName-Objekt, aus dem der <codeph class="+ topic/ph pr-d/codeph ">localName</codeph>-Wert zu kopieren ist. Parameter aller anderen Typen werden in einen String konvertiert. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein QName-Objekt mit einem URI-Objekt aus einem Namespace-Objekt und <codeph class="+ topic/ph pr-d/codeph ">localName</codeph> aus einem QName-Objekt. Hat einer der Parameter nicht den erwarteten Datentyp, wird er in einen String konvertiert und der entsprechenden Eigenschaft des neuen QName-Objekts zugewiesen. Handelt es sich beispielsweise bei beiden Parametern um Strings, wird ein neues QName-Objekt zurückgegeben, dessen <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft auf den ersten Parameter gesetzt ist und dessen <codeph class="+ topic/ph pr-d/codeph ">localName</codeph>-Eigenschaft auf den zweiten Parameter gesetzt ist. Anders ausgedrückt: Die folgenden Permutationen sind, neben vielen anderen, zulässige Formen des Konstruktors: |
| <pre xml:space="preserve" class="- topic/pre "> |
| QName (uri:Namespace, localName:String); |
| QName (uri:String, localName: QName); |
| QName (uri:String, localName: String); |
| </pre> |
| <p class="- topic/p ">Wenn Sie den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> an den <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Parameter übergeben, wird die <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft des neuen QName-Objekts auf <codeph class="+ topic/ph pr-d/codeph ">null</codeph> gesetzt. |
| </p> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Diese Klasse zeigt zwei Konstruktoreinträge, da jede Form andere Parameter akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Parameter, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.</p> |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="QName:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der sich aus dem URI und dem lokalen Namen für das QName-Objekt zusammensetzt, wobei die beiden durch „::“ voneinander getrennt sind.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">QName, QName.toString, toString |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der qualifizierte Name als String. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der sich aus dem URI und dem lokalen Namen für das QName-Objekt zusammensetzt, wobei die beiden durch „::“ voneinander getrennt sind. |
| |
| <p class="- topic/p ">Das Format hängt von der <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft des QName-Objekts ab:</p> |
| <pre xml:space="preserve" class="- topic/pre ">If <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> == "" |
| <codeph class="+ topic/ph pr-d/codeph ">toString</codeph> returns <codeph class="+ topic/ph pr-d/codeph ">localName</codeph> |
| else if <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> == null |
| <codeph class="+ topic/ph pr-d/codeph ">toString</codeph> returns ~~::<codeph class="+ topic/ph pr-d/codeph ">localName</codeph> |
| else |
| <codeph class="+ topic/ph pr-d/codeph ">toString</codeph> returns <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>::<codeph class="+ topic/ph pr-d/codeph ">localName</codeph></pre> |
| |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="QName:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das QName-Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">QName, QName.toString, toString |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Grundwert einer QName-Instanz. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">QName</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das QName-Objekt zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="QName:localName:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">localName</apiName><shortdesc class="- topic/shortdesc "> |
| Der lokale Name des QName-Objekts.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">QName, QName.localName, localName |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der lokale Name des QName-Objekts. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="QName:uri:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">uri</apiName><shortdesc class="- topic/shortdesc "> |
| Der URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner) des QName-Objekts.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">QName, QName.uri, uri |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner) des QName-Objekts. |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:EvalError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">EvalError</apiName><shortdesc class="- topic/shortdesc "> |
| Die EvalError-Klasse repräsentiert einen Fehler, der auftritt, wenn der Benutzercode die Funktion eval() aufruft oder versucht, den new-Operator mit dem Function-Objekt aufzurufen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid> |
| |
| </helpid></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein EvalError-Fehler wird ausgelöst, wenn der Code versucht, die Methode eval() aufzurufen oder „new“ mit dem Function-Objekt zu verwenden. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die EvalError-Klasse repräsentiert einen Fehler, der auftritt, wenn der Benutzercode die Funktion <codeph class="+ topic/ph pr-d/codeph ">eval()</codeph> aufruft oder versucht, den Operator <codeph class="+ topic/ph pr-d/codeph ">new</codeph> mit dem Function-Objekt aufzurufen. Es wird nicht unterstützt, <codeph class="+ topic/ph pr-d/codeph ">eval()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">new</codeph> mit dem Function-Objekt aufzurufen. |
| |
| </apiDesc></apiClassifierDetail><apiConstructor id="EvalError:EvalError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">EvalError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues EvalError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der mit dem Fehler verknüpft ist. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues EvalError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:Math" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Math</apiName><shortdesc class="- topic/shortdesc "> |
| Die Math-Klasse umfasst Methoden und Konstanten, die allgemeine mathematische Funktionen und Werte repräsentieren.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math, math object, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Bei der Math-Klasse handelt es sich um eine Klasse der obersten Ebene; sie besteht aus statischen Eigenschaften und Methoden, die allgemeine mathematische Konstanten und Funktionen definieren. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Math-Klasse umfasst Methoden und Konstanten, die allgemeine mathematische Funktionen und Werte repräsentieren. |
| <p class="- topic/p ">Verwenden Sie die Methoden und Eigenschaften dieser Klasse, um auf mathematische Konstanten und Funktionen zuzugreifen und diese zu bearbeiten. Alle Eigenschaften und Methoden der Math-Klasse sind statisch und müssen mit der Syntax <codeph class="+ topic/ph pr-d/codeph ">Math.method(</codeph><codeph class="+ topic/ph pr-d/codeph "><i class="+ topic/ph hi-d/i ">parameter</i></codeph><codeph class="+ topic/ph pr-d/codeph ">)</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">Math.constant</codeph> aufgerufen werden. In ActionScript sind Konstanten mit der maximalen Genauigkeit doppelt genauer Gleitkommazahlen nach IEEE-754 definiert.</p> |
| <p class="- topic/p ">Verschiedene Methoden der Math-Klasse verwenden als Parameter den Bogenmaßwert eines Winkels. Sie können die unten stehende Gleichung zur Berechnung von Bogenmaßwerten verwenden und den berechneten Wert als Parameter bereitstellen, oder Sie können die gesamte rechte Seite der Gleichung (bei der der Winkel in Bogenmaß anstelle von <codeph class="+ topic/ph pr-d/codeph ">degrees</codeph> angegeben ist) als Parameter für das Bogenmaß bereitstellen.</p> |
| <p class="- topic/p ">Bogenmaßwerte lassen sich wie folgt berechnen:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| radians = degrees ~~ Math.PI/180 |
| </pre> |
| <p class="- topic/p ">Um aus einem Bogenmaßwert die Gradzahl zu berechnen, verwenden Sie die folgende Formel:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| degrees = radians ~~ 180/Math.PI |
| </pre> |
| <p class="- topic/p ">Im folgenden Beispiel wird die Gleichung als Parameter zum Berechnen des Sinus eines 45-Grad-Winkels übergeben:</p> |
| <p class="- topic/p "><codeph class="+ topic/ph pr-d/codeph ">Math.sin(45 ~~ Math.PI/180)</codeph> ist identisch mit <codeph class="+ topic/ph pr-d/codeph ">Math.sin(.7854)</codeph></p> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Die Math-Funktionen acos, asin, atan, atan2, cos, exp, log, pow, sin und sqrt können je nach Algorithmus, den die CPU oder das Betriebssystem verwendet, zu leicht abweichenden Ergebnissen führen. Flash-Laufzeitumgebungen nutzen die CPU (oder das Betriebssystem, falls die CPU keine Gleitkommaberechnungen unterstützt), wenn Berechnungen für die aufgezählten Funktionen durchzuführen sind, und die Ergebnisse haben je nach verwendeter CPU bzw. verwendetem Betriebssystem leichte Abweichungen aufgezeigt. |
| </p> |
| |
| |
| </apiDesc></apiClassifierDetail><apiOperation id="Math:abs" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">abs</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet einen absoluten Wert für die im Parameter „val“ angegebene Zahl und gibt diesen zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.abs, abs, absolute |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der absolute Wert des angegebenen Parameters. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Zahl, deren absoluter Wert zurückgegeben wird. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den absolute Wert der angegebenen Zahl zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet einen absoluten Wert für die im Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> angegebene Zahl und gibt diesen zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:acos" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">acos</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet den Arkuskosinus für die im Parameter „val“ angegebene Zahl und gibt diesen in Bogenmaß zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.acos, acos, arc cosine |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Arkuskosinus des Parameters <codeph class="+ topic/ph pr-d/codeph ">val</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl zwischen -1,0 und 1,0. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Arkuskosinus der angegebenen Zahl in Bogenmaß zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Arkuskosinus für die im Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> angegebene Zahl und gibt diesen in Bogenmaß zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:asin" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">asin</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet den Arkussinus für die im Parameter „val“ angegebene Zahl und gibt diesen in Bogenmaß zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.asin, asin, arc sine |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl zwischen negativ Pi dividiert durch 2 und positiv Pi dividiert durch 2. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl zwischen -1,0 und 1,0. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Wert des Arkussinus des angegebenen Number-Parameters in Bogenmaß zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Arkussinus für die im Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> angegebene Zahl und gibt diesen in Bogenmaß zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:atan2" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">atan2</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet den Winkel des Punktes „y/x“ in Bogenmaß, gegen den Uhrzeigersinn von der x-Achse eines Kreises aus gemessen (mit 0,0 als Mittelpunkt des Kreises).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.atan2, atan2, arc tangent |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">y</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die <i class="+ topic/ph hi-d/i ">y</i>-Koordinate des Punkts. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">x</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die <i class="+ topic/ph hi-d/i ">x</i>-Koordinate des Punkts. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Winkel des Punktes „y/x“ in Bogenmaß zurück, von der x-Achse eines Kreises aus gegen den Uhrzeigersinn gemessen. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Winkel des Punktes <codeph class="+ topic/ph pr-d/codeph ">y</codeph>/<codeph class="+ topic/ph pr-d/codeph ">x</codeph> in Bogenmaß, von der <i class="+ topic/ph hi-d/i ">x</i>-Achse eines Kreises aus gegen den Uhrzeigersinn gemessen (mit 0,0 als Mittelpunkt des Kreises). Der Rückgabewert liegt zwischen positiv Pi und negativ Pi. Der erste Parameter von atan2 ist immer die <i class="+ topic/ph hi-d/i ">y</i>-Koordinate. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/acos()" class="- topic/link "><linktext class="- topic/linktext ">Math.acos()</linktext></link><link href="#Math/asin()" class="- topic/link "><linktext class="- topic/linktext ">Math.asin()</linktext></link><link href="#Math/atan()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan()</linktext></link><link href="#Math/cos()" class="- topic/link "><linktext class="- topic/linktext ">Math.cos()</linktext></link><link href="#Math/sin()" class="- topic/link "><linktext class="- topic/linktext ">Math.sin()</linktext></link><link href="#Math/tan()" class="- topic/link "><linktext class="- topic/linktext ">Math.tan()</linktext></link></related-links></apiOperation><apiOperation id="Math:atan" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">atan</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet in Bogenmaß den Wert des Winkels, dessen Tangens durch den Parameter „val“ festgelegt ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.atan, atan, arc tangent |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl zwischen negativ Pi dividiert durch 2 und positiv Pi dividiert durch 2. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die den Tangens eines Winkels angibt. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Winkel, dessen Tangens durch den Parameter „val“ angegeben ist, in Bogenmaß zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Wert des Winkels, dessen Tangens durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> festgelegt ist, in Bogenmaß. Der Rückgabewert liegt zwischen negativ Pi dividiert durch 2 und positiv Pi dividiert durch 2. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:ceil" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">ceil</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Obergrenze der angegebenen Zahl bzw. des angegebenen Ausdrucks zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.ceil, ceil, ceiling |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Ganzzahl, die dem Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> am Nächsten liegt und gleichzeitig größer oder gleich diesem Parameter ist. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt die Obergrenze der angegebenen Zahl bzw. des angegebenen Ausdrucks zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Obergrenze der angegebenen Zahl bzw. des angegebenen Ausdrucks zurück. Die Obergrenze einer Zahl ist die nächstliegende Ganzzahl, die größer oder gleich der Zahl ist. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/floor()" class="- topic/link "><linktext class="- topic/linktext ">Math.floor()</linktext></link><link href="#Math/round()" class="- topic/link "><linktext class="- topic/linktext ">Math.round()</linktext></link></related-links></apiOperation><apiOperation id="Math:cos" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">cos</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet den Kosinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.cos, cos, cosine |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl zwischen -1,0 und 1,0. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">angleRadians</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die einen Winkel in Bogenmaß angibt. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Kosinus des angegebenen Winkels zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Kosinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück. Informationen zum Berechnen eines Bogenmaßes finden Sie in der Einführung zur Math-Klasse. |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/acos()" class="- topic/link "><linktext class="- topic/linktext ">Math.acos()</linktext></link><link href="#Math/asin()" class="- topic/link "><linktext class="- topic/linktext ">Math.asin()</linktext></link><link href="#Math/atan()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan()</linktext></link><link href="#Math/atan2()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan2()</linktext></link><link href="#Math/sin()" class="- topic/link "><linktext class="- topic/linktext ">Math.sin()</linktext></link><link href="#Math/tan()" class="- topic/link "><linktext class="- topic/linktext ">Math.tan()</linktext></link></related-links></apiOperation><apiOperation id="Math:exp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">exp</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Wert der Basis des natürlichen Logarithmus (e) potenziert mit dem im Parameter „x“ angegebenen Exponenten zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.exp, exp, exponent |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><i class="+ topic/ph hi-d/i ">e</i> hoch <codeph class="+ topic/ph pr-d/codeph ">val</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Exponent. Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Wert der Basis des natürlichen Logarithmus (e) potenziert mit dem im Parameter „val“ angegebenen Exponenten zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Wert der Basis des natürlichen Logarithmus (<i class="+ topic/ph hi-d/i ">e</i>) potenziert mit dem im Parameter <codeph class="+ topic/ph pr-d/codeph ">x</codeph> angegebenen Exponenten zurück. Die Konstante <codeph class="+ topic/ph pr-d/codeph ">Math.E</codeph> kann den Wert von <i class="+ topic/ph hi-d/i ">e</i> liefern. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/E" class="- topic/link "><linktext class="- topic/linktext ">Math.E</linktext></link></related-links></apiOperation><apiOperation id="Math:floor" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">floor</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Untergrenze der Zahl oder des Ausdrucks zurück, die bzw. der im Parameter „val“ angegeben ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.floor, floor |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Ganzzahl, die dem Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> am Nächsten liegt und gleichzeitig kleiner oder gleich diesem Parameter ist. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt die Untergrenze der Zahl oder des Ausdrucks zurück, die bzw. der im Parameter „val“ angegeben ist. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Untergrenze der Zahl oder des Ausdrucks zurück, die bzw. der im Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> angegeben ist. Die Untergrenze einer Zahl ist die nächstliegende Ganzzahl, die kleiner oder gleich der angegebenen Zahl bzw. dem angegebenen Ausdruck ist. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:log" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">log</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den natürlichen Logarithmus des Parameters „val“ zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.log, log, logarithm |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der natürliche Logarithmus des Parameters <codeph class="+ topic/ph pr-d/codeph ">val</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck mit einem Wert größer als 0. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Logarithmus des Parameters „val“ zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den natürlichen Logarithmus des Parameters <codeph class="+ topic/ph pr-d/codeph ">val</codeph> zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:max" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">max</apiName><shortdesc class="- topic/shortdesc "> |
| Wertet „val1“ und „val2“ (oder auch weitere Werte) aus und gibt den größten Wert zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.max, max, maximum |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der größte Wert der Parameter <codeph class="+ topic/ph pr-d/codeph ">val1</codeph> und <codeph class="+ topic/ph pr-d/codeph ">val2</codeph> (und gegebenenfalls weiterere Werte). |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val1</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val2</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">rest</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. <codeph class="+ topic/ph pr-d/codeph ">Math.max()</codeph> kann mehrere Argumente akzeptieren. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Wertet die Parameter „val1“ und „val2“ aus und gibt den größeren Wert zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wertet <codeph class="+ topic/ph pr-d/codeph ">val1</codeph> und <codeph class="+ topic/ph pr-d/codeph ">val2</codeph> (oder auch weitere Werte) aus und gibt den größten Wert zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/min()" class="- topic/link "><linktext class="- topic/linktext ">Math.min()</linktext></link></related-links></apiOperation><apiOperation id="Math:min" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">min</apiName><shortdesc class="- topic/shortdesc "> |
| Wertet „val1“ und „val2“ (oder auch weitere Werte) aus und gibt den kleinsten Wert zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.min, min, minimum |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der kleinste Wert der Parameter <codeph class="+ topic/ph pr-d/codeph ">val1</codeph> und <codeph class="+ topic/ph pr-d/codeph ">val2</codeph> (und gegebenenfalls weiterere Werte). |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val1</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val2</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">rest</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck. <codeph class="+ topic/ph pr-d/codeph ">Math.min()</codeph> kann mehrere Argumente akzeptieren. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Wertet die Parameter „val1“ und „val2“ aus und gibt den kleineren Wert zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wertet <codeph class="+ topic/ph pr-d/codeph ">val1</codeph> und <codeph class="+ topic/ph pr-d/codeph ">val2</codeph> (oder auch weitere Werte) aus und gibt den kleinsten Wert zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/max()" class="- topic/link "><linktext class="- topic/linktext ">Math.max()</linktext></link></related-links></apiOperation><apiOperation id="Math:pow" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">pow</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet und gibt „base“ hoch „pow“ zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.pow, pow, power |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Wert von <codeph class="+ topic/ph pr-d/codeph ">base </codeph> erhöht auf die Potenz von <codeph class="+ topic/ph pr-d/codeph ">pow</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">base</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die mit dem Parameter <codeph class="+ topic/ph pr-d/codeph ">pow</codeph> potenziert werden soll. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">pow</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die angibt, mit welchem Exponenten der Parameter <codeph class="+ topic/ph pr-d/codeph ">base</codeph> potenziert wird. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Wert von „val1“ hoch „val2“ zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet und gibt den Wert <codeph class="+ topic/ph pr-d/codeph ">base</codeph> hoch <codeph class="+ topic/ph pr-d/codeph ">pow</codeph> zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:random" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">random</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Pseudozufallszahl n zurück, wobei 0 &lt;= n &lt; 1.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.random, random |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Pseudozufallszahl. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt eine Pseudozufallszahl n zurück, wobei 0 <= n < 1. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Pseudozufallszahl n zurück, wobei 0 <= n < 1. Wie die zurückgegebene Zahl berechnet wird, wird nicht bekannt gegeben. Man spricht von einer „Pseudo-Zufallszahl“, da es unvermeidlich ist, dass die Berechnung einige nicht-zufällige Elemente enthält. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:round" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">round</apiName><shortdesc class="- topic/shortdesc "> |
| Rundet den Wert des Parameters „val“ auf die nächstliegende Ganzzahl auf oder ab und gibt diese zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.round, round |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der auf die nächste Ganzzahl gerundete Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Zahl, die gerundet werden soll. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Wert des auf die nächste Ganzzahl auf- bzw. abgerundeten Parameters „val“ zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Rundet den Wert des Parameters <codeph class="+ topic/ph pr-d/codeph ">val</codeph> auf die nächstliegende Ganzzahl auf oder ab und gibt diese zurück. Hat <codeph class="+ topic/ph pr-d/codeph ">val</codeph> den gleichen Abstand von den beiden nächstliegenden Ganzzahlen (z. B. Zahlen die mit .5 enden), wird der Wert auf die nächsthöhere Ganzzahl aufgerundet. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/ceil()" class="- topic/link "><linktext class="- topic/linktext ">Math.ceil()</linktext></link><link href="#Math/floor()" class="- topic/link "><linktext class="- topic/linktext ">Math.floor()</linktext></link></related-links></apiOperation><apiOperation id="Math:sin" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">sin</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet den Sinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.sin, sin, sine |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Zahl, der Sinus des angegebenen Winkels (zwischen -1,0 und 1,0). |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">angleRadians</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die einen Winkel in Bogenmaß angibt. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Sinus des angegebenen Winkels zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Sinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück. Informationen zum Berechnen eines Bogenmaßes finden Sie in der Einführung zur Math-Klasse. |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/acos()" class="- topic/link "><linktext class="- topic/linktext ">Math.acos()</linktext></link><link href="#Math/asin()" class="- topic/link "><linktext class="- topic/linktext ">Math.asin()</linktext></link><link href="#Math/atan()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan()</linktext></link><link href="#Math/atan2()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan2()</linktext></link><link href="#Math/cos()" class="- topic/link "><linktext class="- topic/linktext ">Math.cos()</linktext></link><link href="#Math/tan()" class="- topic/link "><linktext class="- topic/linktext ">Math.tan()</linktext></link></related-links></apiOperation><apiOperation id="Math:sqrt" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">sqrt</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet die Quadratwurzel der angegebenen Zahl und gibt diese zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.sqrt, sqrt, square root |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, wenn der Parameter <codeph class="+ topic/ph pr-d/codeph ">val</codeph> größer oder gleich Null ist; andernfalls <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not a Number &#2013; keine Zahl). |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder ein Ausdruck größer oder gleich 0. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt die Quadratwurzel der angegebenen Zahl zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet die Quadratwurzel der angegebenen Zahl und gibt diese zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Math:tan" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">tan</apiName><shortdesc class="- topic/shortdesc "> |
| Berechnet den Tangens des angegebenen Winkels und gibt diesen zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.tan, tan, tangent |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Tangens des Parameters <codeph class="+ topic/ph pr-d/codeph ">angleRadians</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">angleRadians</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die einen Winkel in Bogenmaß angibt. |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Tangens des angegebenen Winkels zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Berechnet den Tangens des angegebenen Winkels und gibt diesen zurück. Informationen zum Berechnen eines Bogenmaßes finden Sie in der Einführung zur Math-Klasse. |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Math/acos()" class="- topic/link "><linktext class="- topic/linktext ">Math.acos()</linktext></link><link href="#Math/asin()" class="- topic/link "><linktext class="- topic/linktext ">Math.asin()</linktext></link><link href="#Math/atan()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan()</linktext></link><link href="#Math/atan2()" class="- topic/link "><linktext class="- topic/linktext ">Math.atan2()</linktext></link><link href="#Math/cos()" class="- topic/link "><linktext class="- topic/linktext ">Math.cos()</linktext></link><link href="#Math/sin()" class="- topic/link "><linktext class="- topic/linktext ">Math.sin()</linktext></link></related-links></apiOperation><apiValue id="Math:E" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">E</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für die Basis des natürlichen Logarithmus, ausgedrückt als „e“.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.e, e |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">2.71828182845905</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für die Basis des natürlichen Logarithmus, ausgedrückt als „e“. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für die Basis des natürlichen Logarithmus, ausgedrückt als <i class="+ topic/ph hi-d/i ">e</i>. Der ungefähre Wert von <i class="+ topic/ph hi-d/i ">e</i><codeph class="+ topic/ph pr-d/codeph "> </codeph>ist 2,71828182845905. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:LN10" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">LN10</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für den natürlichen Logarithmus von 10, der als „loge10“ ausgedrückt wird und den Näherungswert 2,302585092994046 aufweist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.ln10, ln10, logarithm |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">2.302585092994046</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für den natürlichen Logarithmus von 10, der als „loge10“ ausgedrückt wird und den Näherungswert 2,302585092994046 aufweist. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für den natürlichen Logarithmus von 10, der als log<sub class="+ topic/ph hi-d/sub ">e</sub>10 ausgedrückt wird und den Näherungswert 2,302585092994046 aufweist. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:LN2" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">LN2</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für den natürlichen Logarithmus von 2, der als „loge2“ ausgedrückt wird und den Näherungswert 0,6931471805599453 aufweist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.ln2, ln2, natural logarithm |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">0.6931471805599453</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für den natürlichen Logarithmus von 2, der als „loge2“ ausgedrückt wird und den Näherungswert 0,6931471805599453 aufweist. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für den natürlichen Logarithmus von 2, der als log<sub class="+ topic/ph hi-d/sub ">e</sub>2 ausgedrückt wird und den Näherungswert 0,6931471805599453 aufweist. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:LOG10E" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">LOG10E</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für den Logarithmus zur Basis 10 der Konstante e (Math.E), der als „log10e“ ausgedrückt wird und den Näherungswert 0,4342944819032518 aufweist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.log10e, log10e, logarithm |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">0.4342944819032518</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für den Zehnerlogarithmus der Konstante e, der als „log10e“ ausgedrückt wird und den Näherungswert 0,4342944819032518 aufweist. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für den Zehnerlogarithmus der Konstante <i class="+ topic/ph hi-d/i ">e</i> (<codeph class="+ topic/ph pr-d/codeph ">Math.E</codeph>), der als log<sub class="+ topic/ph hi-d/sub ">10</sub>e ausgedrückt wird und den Näherungswert 0,4342944819032518 aufweist. |
| <p class="- topic/p ">Die <codeph class="+ topic/ph pr-d/codeph ">Math.log()</codeph>-Methode berechnet den natürlichen Logarithmus einer Zahl. Den Zehnerlogarithmus erhalten Sie, indem Sie das Ergebnis von <codeph class="+ topic/ph pr-d/codeph ">Math.log()</codeph> mit <codeph class="+ topic/ph pr-d/codeph ">Math.LOG10E</codeph> multiplizieren.</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:LOG2E" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">LOG2E</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für den Zweierlogarithmus der Konstante e, der als „log2e“ ausgedrückt wird und den Näherungswert 1,442695040888963387 aufweist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.log2e, log2e, logarithm |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">1.442695040888963387</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für den Zweierlogarithmus der Konstante e, der als „log2e“ ausgedrückt wird und den Näherungswert 1,442695040888963387 aufweist. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für den Zweierlogarithmus der Konstante <i class="+ topic/ph hi-d/i ">e</i>, der als „log2e“ ausgedrückt wird und den Näherungswert 1,442695040888963387 aufweist. |
| |
| <p class="- topic/p ">Die <codeph class="+ topic/ph pr-d/codeph ">Math.log</codeph>-Methode berechnet den natürlichen Logarithmus einer Zahl. Den Zweierlogarithmus erhalten Sie, indem Sie das Ergebnis von <codeph class="+ topic/ph pr-d/codeph ">Math.log()</codeph> mit <codeph class="+ topic/ph pr-d/codeph ">Math.LOG2E</codeph> multiplizieren.</p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:PI" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">PI</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für das Verhältnis des Umfangs eines Kreises zu seinem Durchmesser, der als Pi mit dem Wert 3,141592653589793 ausgedrückt wird.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.pi, pi |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">3.141592653589793</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für das Verhältnis des Umfangs eines Kreises zu seinem Durchmesser, der als Pi mit dem Wert 3,141592653589793 ausgedrückt wird. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für das Verhältnis des Umfangs eines Kreises zu seinem Durchmesser, der als Pi mit dem Wert 3,141592653589793 ausgedrückt wird. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:SQRT1_2" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">SQRT1_2</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für die Quadratwurzel von 1/2 mit dem Näherungswert 0,7071067811865476.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.sqrt1_2, sqrt1_2, square root |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">0.7071067811865476</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für die Quadratwurzel von 1/2 mit dem Näherungswert 0,7071067811865476. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für die Quadratwurzel von 1/2 mit dem Näherungswert 0,7071067811865476. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Math:SQRT2" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">SQRT2</apiName><shortdesc class="- topic/shortdesc "> |
| Eine mathematische Konstante für die Quadratwurzel von 2 mit dem Näherungswert 1,4142135623730951.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">math.sqrt2, sqrt2, square root |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">1.4142135623730951</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Eine mathematische Konstante für die Quadratwurzel von 2 mit dem Näherungswert 1,4142135623730951. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine mathematische Konstante für die Quadratwurzel von 2 mit dem Näherungswert 1,4142135623730951. |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:Array" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Array</apiName><shortdesc class="- topic/shortdesc "> |
| Die Array-Klasse ermöglicht den Zugriff und die Bearbeitung von Arrays.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Array, Array object, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Die Array-Klasse ermöglicht den Zugriff und die Bearbeitung von indizierten Arrays. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Array-Klasse ermöglicht den Zugriff und die Bearbeitung von Arrays. Alle Arrays haben die Basis null, d. h., das erste Element im Array ist <codeph class="+ topic/ph pr-d/codeph ">[0]</codeph>, das zweite Element <codeph class="+ topic/ph pr-d/codeph ">[1]</codeph> usw. Verwenden Sie zum Erstellen eines Array-Objekts den Konstruktor <codeph class="+ topic/ph pr-d/codeph ">new Array()</codeph>. <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph> kann auch als Funktion aufgerufen werden. Zudem können Sie den Array-Zugriffsoperator (<codeph class="+ topic/ph pr-d/codeph ">[]</codeph>) verwenden, um ein Array zu initialisieren oder auf die Elemente eines Arrays zuzugreifen. |
| <p class="- topic/p ">Sie können viele unterschiedliche Datentypen in einem Arrayelement speichern, z. B. Zahlen, Strings, Objekte und auch andere Arrays. Außerdem haben Sie die Möglichkeit, ein <i class="+ topic/ph hi-d/i ">mehrdimensionales</i> Array zu erstellen, indem Sie ein indiziertes Array anlegen und jedem seiner Elemente ein weiteres indiziertes Array zuweisen. Diese Arrays werden als mehrdimensional bezeichnet, da sie zur Darstellung von Daten in einer Tabelle verwendet werden können.</p> |
| <p class="- topic/p "> Arrays sind <i class="+ topic/ph hi-d/i ">karge Arrays</i>, d. h., sie weisen unter Umständen ein Element auf Indexposition 0 und ein weiteres auf Position 5 auf, dazwischen jedoch keine Elemente. In diesem Fall sind die Elemente in Position 1 bis 4 nicht definiert, wodurch das Fehlen eines Elements angezeigt wird, nicht unbedingt das Vorhandensein eines Elements mit dem Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>.</p> |
| |
| <p class="- topic/p ">Die Zuweisung von Arrays erfolgt nicht mithilfe von Werten, sondern über Verweise. Wenn Sie eine Array-Variable einer anderen zuweisen, verweisen beide Variablen auf das gleiche Array:</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var oneArray:Array = new Array("a", "b", "c"); |
| var twoArray:Array = oneArray; // Both array variables refer to the same array. |
| twoArray[0] = "z"; |
| trace(oneArray); // Output: z,b,c. |
| </codeblock> |
| <p class="- topic/p ">Allerdings sollten Sie mithilfe der Array-Klasse keine <i class="+ topic/ph hi-d/i ">assoziativen Arrays</i> (auch als <i class="+ topic/ph hi-d/i ">hashes</i> bezeichnet) erstellen, bei denen es sich um Datenstrukturen mit bezeichneten statt numerierten Elementen handelt. Um assoziative Arrays zu erstellen, verwenden Sie die Object-Klasse. ActionScript ermöglicht zwar auch das Erstellen assoziativer Arrays mithilfe der Array-Klasse, Sie können dann jedoch keine der Methoden oder Eigenschaften der Array-Klasse verwenden. </p> |
| <p class="- topic/p ">Sie können die Array-Klasse erweitern und Methoden überschreiben oder hinzufügen. Allerdings müssen Sie die Unterklasse als <codeph class="+ topic/ph pr-d/codeph ">dynamic</codeph> angeben, da Sie sonst die Fähigkeit, Daten in einem Array zu speichern, verlieren.</p> |
| |
| </apiDesc><example conref="examples\ArrayExample.as" class="- topic/example "> Im folgenden Beispiel wird ein neues <codeph class="+ topic/ph pr-d/codeph ">myArr</codeph>-Objekt mit der Ausgangslänge 0 erstellt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ArrayExample extends Sprite { |
| public function ArrayExample() { |
| var myArr:Array = new Array(); |
| trace(myArr.length); // 0 |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="operators.html#array_access" class="- topic/link "><linktext class="- topic/linktext ">[] (Array-Zugriff)</linktext></link><link href="#Object" class="- topic/link "><linktext class="- topic/linktext ">Object-Klasse</linktext></link></related-links><apiConstructor id="Array:Array_0" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Array</apiName><shortdesc class="- topic/shortdesc "> |
| Ermöglicht das Erstellen eines Arrays mit der angegebenen Anzahl an Elementen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Argument ist eine Zahl, die keine Ganzzahl größer oder gleich 0 ist. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">values</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Liste mit mindestens zwei beliebigen Werten. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis: </b>Wenn an den Array-Konstruktor nur ein einziger numerischer Parameter übergeben wird, wird davon ausgegangen, dass er die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft des Arrays beschreibt.</p> |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ermöglicht das Erstellen eines Arrays mit der angegebenen Anzahl an Elementen. Sie können Werte beliebigen Typs angeben. Das erste Element in einem Array hat immer die Indexposition 0. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Diese Klasse zeigt zwei Konstruktoreinträge, da der Konstruktor Argumente verschiedenen Typs akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Argumente, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.</p> |
| </apiDesc><example conref="examples\Array_Array_3.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Array-Objekt mit der Ausgangslänge 3 erstellt, das Array wird mit den String-Elementen <codeph class="+ topic/ph pr-d/codeph ">one</codeph>, <codeph class="+ topic/ph pr-d/codeph ">two</codeph> und <codeph class="+ topic/ph pr-d/codeph ">three</codeph> gefüllt und anschließend werden die Elemente in einen String umgewandelt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class Array_Array_3 extends Sprite { |
| |
| public function Array_Array_3() { |
| var myArr:Array = new Array("one", "two", "three"); |
| trace(myArr.length); // 3 |
| trace(myArr); // one,two,three |
| } |
| } |
| } |
| </codeblock></example></apiConstructorDetail><related-links class="- topic/related-links "><link href="operators.html#array_access" class="- topic/link "><linktext class="- topic/linktext ">[] Array-Zugriff</linktext></link><link href="#Array/length" class="- topic/link "><linktext class="- topic/linktext ">Array.length</linktext></link></related-links></apiConstructor><apiConstructor id="Array:Array_1" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Array</apiName><shortdesc class="- topic/shortdesc "> |
| Ermöglicht das Erstellen eines Arrays mit der angegebenen Anzahl an Elementen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Argument ist eine Zahl, die keine Ganzzahl größer oder gleich 0 ist. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">numElements</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Anzahl von Elementen im Array angibt. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ermöglicht das Erstellen eines Arrays mit der angegebenen Anzahl an Elementen. Wenn Sie keine Parameter angeben, wird ein Array erstellt, der 0 Elemente enthält. Wenn Sie eine bestimmte Anzahl an Elementen angeben, wird ein Array mit <codeph class="+ topic/ph pr-d/codeph ">numElements</codeph> Elementen erstellt. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Diese Klasse zeigt zwei Konstruktormethodeneinträge, da der Konstruktor Argumente verschiedenen Typs akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Argumente, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.</p> |
| |
| |
| </apiDesc><example conref="examples\Array_Array.as" class="- topic/example "> Im folgenden Beispiel wird das Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">myArr</codeph> mit der Ausgangslänge 0 erstellt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class Array_Array extends Sprite { |
| |
| public function Array_Array() { |
| var myArr:Array = new Array(); |
| trace(myArr.length); // 0 |
| } |
| } |
| } |
| </codeblock></example><example conref="examples\Array_Array_2.as" class="- topic/example "> Im folgenden Beispiel wird ein Array-Objekt mit 5 Ausgangselementen und der Länge 5 erstellt, das erste Element wird mit dem String <codeph class="+ topic/ph pr-d/codeph ">"one"</codeph> gefüllt und fügt das Stringelement <codeph class="+ topic/ph pr-d/codeph ">"six"</codeph> am Ende des Arrays mithilfe der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>-Methode hinzu: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class Array_Array_2 extends Sprite { |
| |
| public function Array_Array_2() { |
| var myArr:Array = new Array(5); |
| trace(myArr.length); // 5 |
| myArr[0] = "one"; |
| myArr.push("six"); |
| trace(myArr); // one,,,,,six |
| trace(myArr.length); // 6 |
| } |
| } |
| } |
| </codeblock></example></apiConstructorDetail><related-links class="- topic/related-links "><link href="operators.html#array_access" class="- topic/link "><linktext class="- topic/linktext ">[] Array-Zugriff</linktext></link><link href="#Array/length" class="- topic/link "><linktext class="- topic/linktext ">Array.length</linktext></link></related-links></apiConstructor><apiOperation id="Array:AS3:concat" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">concat</apiName><shortdesc class="- topic/shortdesc "> |
| Verkettet die in den Parametern angegebenen Elemente mit den Elementen in einem Array und erstellt ein neues Array.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.concat, concat, concatenate |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array mit den Elementen dieses Arrays und den Elementen aus den Parametern. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Wert beliebigen Datentyps (wie etwa Zahlen, Elemente oder Strings) der in einem neuen Array verkettet werden soll. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Verkettet die in den Parametern angegebenen Elemente. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Verkettet die in den Parametern angegebenen Elemente mit den Elementen in einem Array und erstellt ein neues Array. Wenn die Parameter ein Array angeben, werden die Elemente dieses Arrays verkettet. Wenn Sie keine Parameter übergeben, wird das neue Array als Duplikat („Shallow Clone“) des ursprünglichen Arrays erstellt. |
| |
| </apiDesc><example conref="examples\Array.concat.1.as" class="- topic/example "> Mit dem folgenden Code werden vier Array-Objekte erstellt: |
| <ul class="- topic/ul "><li class="- topic/li ">Das <codeph class="+ topic/ph pr-d/codeph ">numbers</codeph>-Array, das die Zahlen <codeph class="+ topic/ph pr-d/codeph ">1</codeph>, <codeph class="+ topic/ph pr-d/codeph ">2</codeph> und <codeph class="+ topic/ph pr-d/codeph ">3</codeph> enthält. </li><li class="- topic/li ">Das <codeph class="+ topic/ph pr-d/codeph ">letters</codeph>-Array, das die Buchstaben <codeph class="+ topic/ph pr-d/codeph ">a</codeph>, <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> enthält. </li><li class="- topic/li ">Das <codeph class="+ topic/ph pr-d/codeph ">numbersAndLetters</codeph>-Array, das die <codeph class="+ topic/ph pr-d/codeph ">concat()</codeph>-Methode aufruft, um das Array <codeph class="+ topic/ph pr-d/codeph ">[1,2,3,a,b,c]</codeph> zu erstellen. </li><li class="- topic/li ">Das <codeph class="+ topic/ph pr-d/codeph ">lettersAndNumbers</codeph>-Array, das die <codeph class="+ topic/ph pr-d/codeph ">concat()</codeph>-Methode aufruft, um das Array <codeph class="+ topic/ph pr-d/codeph ">[a,b,c,1,2,3]</codeph> zu erstellen. </li></ul> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var numbers:Array = new Array(1, 2, 3); |
| var letters:Array = new Array("a", "b", "c"); |
| var numbersAndLetters:Array = numbers.concat(letters); |
| var lettersAndNumbers:Array = letters.concat(numbers); |
| |
| trace(numbers); // 1,2,3 |
| trace(letters); // a,b,c |
| trace(numbersAndLetters); // 1,2,3,a,b,c |
| trace(lettersAndNumbers); // a,b,c,1,2,3 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Array:AS3:every" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">every</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Array eine Testfunktion aus, bis ein Element erreicht wird, das für die angegebene Funktion „false“ zurückgibt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der boolesche Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn alle Elemente im Array für die Funktion <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgeben; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element im Array ausgeführt werden soll. Diese Funktion kann einen einfachen Vergleich enthalten (z. B. <codeph class="+ topic/ph pr-d/codeph ">item < 20</codeph>) oder eine komplexere Operation und wird mit drei Argumenten aufgerufen, nämlich dem Wert eines Elements, der Indexposition eines Elements und einem Array-Objekt: |
| <pre xml:space="preserve" class="- topic/pre ">function callback(item:*, index:int, array:Array):Boolean;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das als <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Wert für die Funktion verwendet wird. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Array eine Testfunktion aus, bis ein Element erreicht wird, das für die angegebene Funktion <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurückgibt. Sie verwenden diese Methode, um zu ermitteln, ob alle Elemente in einem Array ein Kriterium erfüllen, z. B. dass die Werte unter einer bestimmten Zahl liegen. |
| |
| <p product="flash" class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Angenommen, Sie erstellen eine Funktion in einem Movieclip mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">me</codeph>:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(obj:Object):void { |
| //your code here |
| } |
| </pre> |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, Sie wenden dann die <codeph class="+ topic/ph pr-d/codeph ">every()</codeph>-Methode auf ein Array mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myArray</codeph> an:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myArray.every(myFunction, me); |
| </pre> |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Timeline-Klasse ist, die von <codeph class="+ topic/ph pr-d/codeph ">me</codeph> nicht überschrieben werden kann, löst die Flash-Laufzeitumgebung eine Ausnahme aus. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(obj:Object):void { |
| //your code here |
| }; |
| myArray.every(myFunction, me); |
| </pre> |
| |
| </apiDesc><example conref="examples\Array_every.as" class="- topic/example "> Im folgenden Beispiel soll mit einer Prüfung von zwei Arrays festgestellt werden, ob es sich bei jedem Element in jedem Array um eine Zahl handelt. Außerdem werden die Ergebnisse der Tests ausgegeben: <codeph class="+ topic/ph pr-d/codeph ">isNumeric</codeph> ist <codeph class="+ topic/ph pr-d/codeph ">true</codeph> für das erste Array und <codeph class="+ topic/ph pr-d/codeph ">false</codeph> für das zweite: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_every extends Sprite { |
| public function Array_every() { |
| var arr1:Array = new Array(1, 2, 4); |
| var res1:Boolean = arr1.every(isNumeric); |
| trace("isNumeric:", res1); // true |
| |
| var arr2:Array = new Array(1, 2, "ham"); |
| var res2:Boolean = arr2.every(isNumeric); |
| trace("isNumeric:", res2); // false |
| } |
| private function isNumeric(element:*, index:int, arr:Array):Boolean { |
| return (element is Number); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/some()" class="- topic/link "><linktext class="- topic/linktext ">Array.some()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:filter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">filter</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Array eine Testfunktion aus und erstellt ein neues Array für alle Elemente, die für die angegebene Funktion „true“ zurückgeben.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein neues Array, das alle Elemente des ursprünglichen Arrays enthält, die den Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgegeben haben. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element im Array ausgeführt werden soll. Diese Funktion kann einen einfachen Vergleich enthalten (z. B. <codeph class="+ topic/ph pr-d/codeph ">item < 20</codeph>) oder eine komplexere Operation und wird mit drei Argumenten aufgerufen, nämlich dem Wert eines Elements, der Indexposition eines Elements und einem Array-Objekt: |
| <pre xml:space="preserve" class="- topic/pre "> function callback(item:*, index:int, array:Array):Boolean;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das als <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Wert für die Funktion verwendet wird. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Array eine Testfunktion aus und erstellt ein neues Array für alle Elemente, die für die angegebene Funktion <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgeben. Gibt ein Element <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurück, wird es nicht in den neuen Array aufgenommen. |
| |
| <p product="flash" class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Angenommen, Sie erstellen eine Funktion in einem Movieclip mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">me</codeph>:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(obj:Object):void { |
| //your code here |
| } |
| </pre> |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, Sie wenden dann die <codeph class="+ topic/ph pr-d/codeph ">filter()</codeph>-Methode auf ein Array mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myArray</codeph> an:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myArray.filter(myFunction, me); |
| </pre> |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Timeline-Klasse ist, die von <codeph class="+ topic/ph pr-d/codeph ">me</codeph> nicht überschrieben werden kann, löst die Flash-Laufzeitumgebung eine Ausnahme aus. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(obj:Object):void { |
| //your code here |
| }; |
| myArray.filter(myFunction, me); |
| </pre> |
| |
| </apiDesc><example conref="examples\Array.filter.as" class="- topic/example "> Im folgenden Beispiel wird ein Array aus allen Angestellten erstellt, die dem Management angehören: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_filter extends Sprite { |
| public function Array_filter() { |
| var employees:Array = new Array(); |
| employees.push({name:"Employee 1", manager:false}); |
| employees.push({name:"Employee 2", manager:true}); |
| employees.push({name:"Employee 3", manager:false}); |
| trace("Employees:"); |
| employees.forEach(traceEmployee); |
| |
| var managers:Array = employees.filter(isManager); |
| trace("Managers:"); |
| managers.forEach(traceEmployee); |
| } |
| private function isManager(element:*, index:int, arr:Array):Boolean { |
| return (element.manager == true); |
| } |
| private function traceEmployee(element:*, index:int, arr:Array):void { |
| trace("\t" + element.name + ((element.manager) ? " (manager)" : "")); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/map()" class="- topic/link "><linktext class="- topic/linktext ">Array.map()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:forEach" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">forEach</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Array eine Funktion aus.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element im Array ausgeführt werden soll. Diese Funktion kann einen einfachen Befehl enthalten (z. B. <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>) oder eine komplexere Operation und wird mit drei Argumenten aufgerufen, nämlich dem Wert eines Elements, der Indexposition eines Elements und einem Array-Objekt: |
| <pre xml:space="preserve" class="- topic/pre "> function callback(item:*, index:int, array:Array):void;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das als <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Wert für die Funktion verwendet wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Array eine Funktion aus. |
| |
| <p product="flash" class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Angenommen, Sie erstellen eine Funktion in einem Movieclip mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">me</codeph>:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(obj:Object):void { |
| //your code here |
| } |
| </pre> |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, Sie wenden dann die <codeph class="+ topic/ph pr-d/codeph ">forEach()</codeph>-Methode auf ein Array mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myArray</codeph> an:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myArray.forEach(myFunction, me); |
| </pre> |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Timeline-Klasse ist, die von <codeph class="+ topic/ph pr-d/codeph ">me</codeph> nicht überschrieben werden kann, löst die Flash-Laufzeitumgebung eine Ausnahme aus. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(obj:Object):void { |
| //your code here |
| }; |
| myArray.forEach(myFunction, me); |
| </pre> |
| </apiDesc><example conref="examples\Array_forEach.as" class="- topic/example "> Im folgenden Beispiel wird die <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung in der <codeph class="+ topic/ph pr-d/codeph ">traceEmployee()</codeph>-Funktion für jedes Element im Array ausgeführt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_forEach extends Sprite { |
| public function Array_forEach() { |
| var employees:Array = new Array(); |
| employees.push({name:"Employee 1", manager:false}); |
| employees.push({name:"Employee 2", manager:true}); |
| employees.push({name:"Employee 3", manager:false}); |
| trace(employees); |
| employees.forEach(traceEmployee); |
| } |
| private function traceEmployee(element:*, index:int, arr:Array):void { |
| trace(element.name + " (" + element.manager + ")"); |
| } |
| } |
| } |
| </codeblock></example><example conref="examples\Array_forEach_2.as" class="- topic/example "> Im folgenden Beispiel wird die <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung in einer leicht abgewandelten <codeph class="+ topic/ph pr-d/codeph ">traceEmployee()</codeph>-Funktion für jedes Element im Array ausgeführt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_forEach_2 extends Sprite { |
| public function Array_forEach_2() { |
| var employeeXML:XML = <employees> |
| <employee name="Steven" manager="false" /> |
| <employee name="Bruce" manager="true" /> |
| <employee name="Rob" manager="false" /> |
| </employees>; |
| var employeesList:XMLList = employeeXML.employee; |
| var employeesArray:Array = new Array(); |
| for each (var tempXML:XML in employeesList) { |
| employeesArray.push(tempXML); |
| } |
| employeesArray.sortOn("@name"); |
| employeesArray.forEach(traceEmployee); |
| } |
| private function traceEmployee(element:*, index:Number, arr:Array):void { |
| trace(element.@name + ((element.@manager == "true") ? " (manager)" : "")); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Array:AS3:indexOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">indexOf</apiName><shortdesc class="- topic/shortdesc "> |
| Sucht nach einem Element in einem Array unter Verwendung strikter Gleichheit (===), und gibt die Indexposition des Elements zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine auf Null basierende Indexposition des Elements im Array. Wird das <codeph class="+ topic/ph pr-d/codeph ">searchElement</codeph>-Argument nicht gefunden, lautet der Rückgabewert -1. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">searchElement</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Element, das im Array gesucht werden soll. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fromIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position im Array, ab der die Suche nach dem Element gestartet werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sucht nach einem Element in einem Array unter Verwendung strikter Gleichheit (<codeph class="+ topic/ph pr-d/codeph ">===</codeph>), und gibt die Indexposition des Elements zurück. |
| </apiDesc><example conref="examples\Array_indexOf.as" class="- topic/example "> Im folgenden Beispiel wird die Position des angegebenen Arrays angezeigt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_indexOf extends Sprite { |
| public function Array_indexOf() { |
| var arr:Array = new Array(123,45,6789); |
| arr.push("123-45-6789"); |
| arr.push("987-65-4321"); |
| |
| var index:int = arr.indexOf("123"); |
| trace(index); // -1 |
| |
| var index2:int = arr.indexOf(123); |
| trace(index2); // 0 |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/lastIndexOf()" class="- topic/link "><linktext class="- topic/linktext ">Array.lastIndexOf()</linktext></link><link href="operators.html#strict_equality" class="- topic/link "><linktext class="- topic/linktext ">=== (strikte Gleichheit)</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:join" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">join</apiName><shortdesc class="- topic/shortdesc "> |
| Wandelt die Elemente in einem Array in Strings um, fügt zwischen ihnen das angegebene Trennzeichen ein, verkettet die Elemente und gibt den resultierenden String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.join, join |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der aus den Elementen eines Arrays besteht, die in Strings umgewandelt und durch den angegebenen Parameter getrennt werden sollen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">sep</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">unknown</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Zeichen oder String, mit dem die Arrayelemente im zurückgegebenen String voneinander getrennt werden. Wenn Sie diesen Parameter weglassen, wird als Standardtrennzeichen das Komma verwendet. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Konvertiert die Elemente in einem Array in Strings. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wandelt die Elemente in einem Array in Strings um, fügt zwischen ihnen das angegebene Trennzeichen ein, verkettet die Elemente und gibt den resultierenden String zurück. Ein verschachteltes Array wird immer durch ein Komma getrennt und nicht durch das Trennzeichen, das an die <codeph class="+ topic/ph pr-d/codeph ">join()</codeph>-Methode übergeben wurde. |
| |
| </apiDesc><example conref="examples\Array.join.1.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">myArr</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">one</codeph>, <codeph class="+ topic/ph pr-d/codeph ">two</codeph> und <codeph class="+ topic/ph pr-d/codeph ">three</codeph> erstellt. Anschließend wird ein String, der <codeph class="+ topic/ph pr-d/codeph ">one and two and three</codeph> enthält, mithilfe der <codeph class="+ topic/ph pr-d/codeph ">join()</codeph>-Methode erstellt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var myArr:Array = new Array("one", "two", "three"); |
| var myStr:String = myArr.join(" and "); |
| trace(myArr); // one,two,three |
| trace(myStr); // one and two and three |
| </codeblock></example><example conref="examples\Array.join.2.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">specialChars</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">(</codeph>, <codeph class="+ topic/ph pr-d/codeph ">)</codeph>, <codeph class="+ topic/ph pr-d/codeph ">-</codeph> und einer Leerstelle erstellt. Anschließend wird ein String erstellt, der <codeph class="+ topic/ph pr-d/codeph ">(888) 867-5309</codeph> enthält. Dann werden mithilfe einer <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife alle in <codeph class="+ topic/ph pr-d/codeph ">specialChars</codeph> aufgelisteten Sonderzeichentypen entfernt, um einen String (<codeph class="+ topic/ph pr-d/codeph ">myStr</codeph>) zu erstellen, der nur die Zahlen der verbleibenden Telefonnummer enthält: <codeph class="+ topic/ph pr-d/codeph ">888675309</codeph>. Beachten Sie, dass möglicherweise andere Zeichen, wie etwa <codeph class="+ topic/ph pr-d/codeph ">+</codeph>, zu <codeph class="+ topic/ph pr-d/codeph ">specialChars</codeph> hinzugefügt wurden. Diese Routine würde dann mit internationalen Telefonnummerformaten funktionieren. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var phoneString:String = "(888) 867-5309"; |
| |
| var specialChars:Array = new Array("(", ")", "-", " "); |
| var myStr:String = phoneString; |
| |
| var ln:uint = specialChars.length; |
| for(var i:uint; i < ln; i++) { |
| myStr = myStr.split(specialChars[i]).join(""); |
| } |
| |
| var phoneNumber:Number = new Number(myStr); |
| |
| trace(phoneString); // (888) 867-5309 |
| trace(phoneNumber); // 8888675309 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/split()" class="- topic/link "><linktext class="- topic/linktext ">String.split()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:lastIndexOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">lastIndexOf</apiName><shortdesc class="- topic/shortdesc "> |
| Sucht rückwärts, vom letzten Element aus, nach einem Element in einem Array und gibt die Indexposition des Elements zurück, das unter Verwendung des strikten Gleichheitsoperators (===) übereinstimmt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine auf Null basierende Indexposition des Elements im Array. Wird das <codeph class="+ topic/ph pr-d/codeph ">searchElement</codeph>-Argument nicht gefunden, lautet der Rückgabewert -1. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">searchElement</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Element, das im Array gesucht werden soll. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fromIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7fffffff</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position im Array, ab der die Suche nach dem Element gestartet werden soll. Standard ist der maximale für eine Indexposition erlaubte Wert. Wenn Sie <codeph class="+ topic/ph pr-d/codeph ">fromIndex</codeph> nicht angeben, beginnt die Suche bei dem letzten Element im Array. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sucht rückwärts, vom letzten Element aus, nach einem Element in einem Array und gibt die Indexposition des Elements zurück, das unter Verwendung des strikten Gleichheitsoperators (<codeph class="+ topic/ph pr-d/codeph ">===</codeph>) übereinstimmt. |
| </apiDesc><example conref="examples\Array_lastIndexOf.as" class="- topic/example "> Im folgenden Beispiel wird die Position des angegebenen Arrays angezeigt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_lastIndexOf extends Sprite { |
| public function Array_lastIndexOf() { |
| var arr:Array = new Array(123,45,6789,123,984,323,123,32); |
| |
| var index:int = arr.indexOf(123); |
| trace(index); // 0 |
| |
| var index2:int = arr.lastIndexOf(123); |
| trace(index2); // 6 |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/indexOf()" class="- topic/link "><linktext class="- topic/linktext ">Array.indexOf()</linktext></link><link href="operators.html#strict_equality" class="- topic/link "><linktext class="- topic/linktext ">=== (strikte Gleichheit)</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:map" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">map</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element in einem Array eine Funktion aus, und erstellt ein neues Array mit Elementen, die den Ergebnissen der Funktion entsprechen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein neues Array, das die Ergebnisse der Funktion enthält, die für jedes Element im ursprünglichen Array ausgeführt wurde. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element im Array ausgeführt werden soll. Diese Funktion kann einen einfachen Befehl enthalten (z. B. die Groß-/Kleinschreibung in einem Array an Strings umschalten) oder eine komplexere Operation und wird mit drei Argumenten aufgerufen, nämlich dem Wert eines Elements, der Indexposition eines Elements und einem Array-Objekt: |
| <pre xml:space="preserve" class="- topic/pre "> function callback(item:*, index:int, array:Array):String;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das als <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Wert für die Funktion verwendet wird. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element in einem Array eine Funktion aus, und erstellt ein neues Array mit Elementen, die den Ergebnissen der Funktion entsprechen. |
| |
| <p product="flash" class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Angenommen, Sie erstellen eine Funktion in einem Movieclip mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">me</codeph>:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(obj:Object):void { |
| //your code here |
| } |
| </pre> |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, Sie wenden dann die <codeph class="+ topic/ph pr-d/codeph ">map()</codeph>-Methode auf ein Array mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myArray</codeph> an:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myArray.map(myFunction, me); |
| </pre> |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Timeline-Klasse ist, die von <codeph class="+ topic/ph pr-d/codeph ">me</codeph> nicht überschrieben werden kann, löst die Flash-Laufzeitumgebung eine Ausnahme aus. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(obj:Object):void { |
| //your code here |
| }; |
| myArray.map(myFunction, me); |
| </pre> |
| </apiDesc><example conref="examples\Array_map.as" class="- topic/example "> Im folgenden Beispiel werden alle Elemente im Array zur Verwendung von Großbuchstaben veranlasst: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_map extends Sprite { |
| public function Array_map() { |
| var arr:Array = new Array("one", "two", "Three"); |
| trace(arr); // one,two,Three |
| |
| var upperArr:Array = arr.map(toUpper); |
| trace(upperArr); // ONE,TWO,THREE |
| } |
| private function toUpper(element:*, index:int, arr:Array):String { |
| return String(element).toUpperCase(); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/filter()" class="- topic/link "><linktext class="- topic/linktext ">Array.filter()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:pop" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">pop</apiName><shortdesc class="- topic/shortdesc "> |
| Entfernt das letzte Element aus einem Array und gibt den Wert dieses Elements zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.pop, pop |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Wert des letzten Elements (beliebigen Typs) im angegebenen Array. |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Entfernt das letzte Element aus einem Array und gibt den Wert dieses Elements zurück. |
| |
| </apiDesc><example conref="examples\Array.pop.1.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">a</codeph>, <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> erstellt. Der letzte Element (<codeph class="+ topic/ph pr-d/codeph ">c</codeph>) wird dann mithilfe der <codeph class="+ topic/ph pr-d/codeph ">pop()</codeph>-Methode aus dem Array entfernt und dem String-Objekt <codeph class="+ topic/ph pr-d/codeph ">letter</codeph> zugewiesen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a", "b", "c"); |
| trace(letters); // a,b,c |
| var letter:String = letters.pop(); |
| trace(letters); // a,b |
| trace(letter); // c |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/push()" class="- topic/link "><linktext class="- topic/linktext ">Array.push()</linktext></link><link href="#Array/shift()" class="- topic/link "><linktext class="- topic/linktext ">Array.shift()</linktext></link><link href="#Array/unshift()" class="- topic/link "><linktext class="- topic/linktext ">Array.unshift()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:push" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">push</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt am Ende eines Arrays ein oder mehrere Elemente hinzu und gibt die neue Länge des Arrays zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.push, push |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Länge des neuen Arrays angibt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein oder mehrere Werte, die an das Array angehängt werden. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt am Ende eines Arrays ein oder mehrere Elemente hinzu und gibt die neue Länge des Arrays zurück. |
| |
| </apiDesc><example conref="examples\Array.push.1.as" class="- topic/example "> Mit dem folgenden Code wird ein leeres Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> erstellt und mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">a</codeph>, <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> mithilfe der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>-Methode gefüllt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array(); |
| |
| letters.push("a"); |
| letters.push("b"); |
| letters.push("c"); |
| |
| trace(letters.toString()); // a,b,c |
| </codeblock></example><example conref="examples\Array.push.2.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> erstellt, das zunächst mit dem Element <codeph class="+ topic/ph pr-d/codeph ">a</codeph> gefüllt wird. Dann werden durch einmaliges Anwenden der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>-Methode die Elemente <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> am Ende des Arrays hinzugefügt, d. h. drei Elemente nach dem „push“. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a"); |
| var count:uint = letters.push("b", "c"); |
| |
| trace(letters); // a,b,c |
| trace(count); // 3 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/pop()" class="- topic/link "><linktext class="- topic/linktext ">Array.pop()</linktext></link><link href="#Array/shift()" class="- topic/link "><linktext class="- topic/linktext ">Array.shift()</linktext></link><link href="#Array/unshift()" class="- topic/link "><linktext class="- topic/linktext ">Array.unshift()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:reverse" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">reverse</apiName><shortdesc class="- topic/shortdesc "> |
| Kehrt die Reihenfolge der Arrayelemente im Array um.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.reverse, reverse |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das neue Array. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Kehrt die Reihenfolge der Arrayelemente im Array um. |
| |
| </apiDesc><example conref="examples\Array.reverse.1.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">a</codeph>, <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> erstellt. Anschließend wird die Reihenfolge der Arrayelemente mithilfe der <codeph class="+ topic/ph pr-d/codeph ">reverse()</codeph>-Methode umgekehrt, um das Array <codeph class="+ topic/ph pr-d/codeph ">[c,b,a]</codeph> zu erstellen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a", "b", "c"); |
| trace(letters); // a,b,c |
| letters.reverse(); |
| trace(letters); // c,b,a |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Array:AS3:shift" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">shift</apiName><shortdesc class="- topic/shortdesc "> |
| Entfernt das erste Element aus einem Array und gibt dieses Element zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.shift, shift |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das erste Element (beliebigen Datentyps) in einem Array. |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Entfernt das erste Element aus einem Array und gibt dieses Element zurück. Die verbleibenden Arrayelemente werden von ihrer ursprünglichen Position, i, nach i-1 verschoben. |
| |
| </apiDesc><example conref="examples\Array.shift.1.as" class="- topic/example "> Mit dem folgenden Code wird das Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">a</codeph>, <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> erstellt. Dann wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">shift()</codeph>-Methode das erste Elemente (<codeph class="+ topic/ph pr-d/codeph ">a</codeph>) aus <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> entfernt und dem String <codeph class="+ topic/ph pr-d/codeph ">firstLetter</codeph> zugewiesen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a", "b", "c"); |
| var firstLetter:String = letters.shift(); |
| trace(letters); // b,c |
| trace(firstLetter); // a |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/pop()" class="- topic/link "><linktext class="- topic/linktext ">Array.pop()</linktext></link><link href="#Array/push()" class="- topic/link "><linktext class="- topic/linktext ">Array.push()</linktext></link><link href="#Array/unshift()" class="- topic/link "><linktext class="- topic/linktext ">Array.unshift()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:slice" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">slice</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt ein neues Array zurück, das aus mehreren Elementen des ursprünglichen Arrays besteht, ohne das ursprüngliche Array dabei zu ändern.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.slice, slice |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array, das aus mehreren Elementen des ursprünglichen Arrays besteht. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die die Indexposition des Segmentanfangs angibt. Wenn <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> eine negative Zahl ist, liegt der Ausgangspunkt am Ende des Arrays, wobei -1 das letzte Element ist. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">endIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">16777215</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die die Indexposition des Segmentendes angibt. Wenn Sie diesen Parameter weglassen, umfasst das Segment alle Elemente vom Anfang bis zum Ende des Arrays. Wenn <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> eine negative Zahl ist, wird der Endpunkt vom Ende des Arrays aus berechnet, wobei -1 das letzte Element ist. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt ein Array zurück, das aus mehreren Elementen des ursprünglichen Arrays besteht. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt ein neues Array zurück, das aus mehreren Elementen des ursprünglichen Arrays besteht, ohne das ursprüngliche Array dabei zu ändern. Das zurückgegebene Array umfasst das Element <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> und alle Elemente bis (ausschließlich) zum Element <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph>. |
| |
| <p class="- topic/p ">Wenn Sie keine Parameter übergeben, wird das neue Array als Duplikat („Shallow Clone“) des ursprünglichen Arrays erstellt.</p> |
| |
| </apiDesc><example conref="examples\Array.slice.1.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[a,b,c,d,e,f]</codeph> erstellt. Anschließend wird das Array <codeph class="+ topic/ph pr-d/codeph ">someLetters</codeph> erstellt, und zwar durch den Aufruf der Methode <codeph class="+ topic/ph pr-d/codeph ">slice()</codeph> für die Elemente 1 (<codeph class="+ topic/ph pr-d/codeph ">b</codeph>) bis 3 (<codeph class="+ topic/ph pr-d/codeph ">d</codeph>). Dadurch entsteht ein Array mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">b</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a", "b", "c", "d", "e", "f"); |
| var someLetters:Array = letters.slice(1,3); |
| |
| trace(letters); // a,b,c,d,e,f |
| trace(someLetters); // b,c |
| </codeblock></example><example conref="examples\Array.slice.2.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[a,b,c,d,e,f]</codeph> erstellt. Anschließend wird das Array <codeph class="+ topic/ph pr-d/codeph ">someLetters</codeph> erstellt, und zwar durch den Aufruf der Methode <codeph class="+ topic/ph pr-d/codeph ">slice()</codeph> für das Elemente 2 (<codeph class="+ topic/ph pr-d/codeph ">c</codeph>). Dadurch entsteht ein Array mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[c,d,e,f]</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a", "b", "c", "d", "e", "f"); |
| var someLetters:Array = letters.slice(2); |
| |
| trace(letters); // a,b,c,d,e,f |
| trace(someLetters); // c,d,e,f |
| </codeblock></example><example conref="examples\Array.slice.3.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">letters</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[a,b,c,d,e,f]</codeph> erstellt. Anschließend wird das Array <codeph class="+ topic/ph pr-d/codeph ">someLetters</codeph> erstellt, und zwar durch den Aufruf der Methode <codeph class="+ topic/ph pr-d/codeph ">slice()</codeph> für das vorletzte Element (<codeph class="+ topic/ph pr-d/codeph ">e</codeph>). Dadurch entsteht ein Array mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">e</codeph> und <codeph class="+ topic/ph pr-d/codeph ">f</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var letters:Array = new Array("a", "b", "c", "d", "e", "f"); |
| var someLetters:Array = letters.slice(-2); |
| |
| trace(letters); // a,b,c,d,e,f |
| trace(someLetters); // e,f |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Array:AS3:some" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">some</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Array eine Testfunktion aus, bis ein Element erreicht wird, das „true“ zurückgibt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der boolesche Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn ein Element im Array für die angegebene Funktion <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgibt; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element im Array ausgeführt werden soll. Diese Funktion kann einen einfachen Vergleich enthalten (z. B. <codeph class="+ topic/ph pr-d/codeph ">item < 20</codeph>) oder eine komplexere Operation und wird mit drei Argumenten aufgerufen, nämlich dem Wert eines Elements, der Indexposition eines Elements und einem Array-Objekt: |
| <pre xml:space="preserve" class="- topic/pre "> function callback(item:*, index:int, array:Array):Boolean;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das als <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Wert für die Funktion verwendet wird. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Array eine Testfunktion aus, bis ein Element erreicht wird, das <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgibt. Verwenden Sie diese Methode, um festzustellen, ob alle Elemente in einem Array ein Kriterium erfüllen, z. B. dass die Werte unter einer bestimmten Zahl liegen. |
| |
| <p product="flash" class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Angenommen, Sie erstellen eine Funktion in einem Movieclip mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">me</codeph>:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(obj:Object):void { |
| //your code here |
| } |
| </pre> |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, Sie wenden dann die <codeph class="+ topic/ph pr-d/codeph ">some()</codeph>-Methode auf ein Array mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myArray</codeph> an:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myArray.some(myFunction, me); |
| </pre> |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Timeline-Klasse ist, die von <codeph class="+ topic/ph pr-d/codeph ">me</codeph> nicht überschrieben werden kann, löst die Flash-Laufzeitumgebung eine Ausnahme aus. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(obj:Object):void { |
| //your code here |
| }; |
| myArray.some(myFunction, me); |
| </pre> |
| </apiDesc><example conref="examples\Array_some.as" class="- topic/example "> Im folgenden Beispiel wird angezeigt, welche Werte nicht definiert sind: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Array_some extends Sprite { |
| public function Array_some() { |
| var arr:Array = new Array(); |
| arr[0] = "one"; |
| arr[1] = "two"; |
| arr[3] = "four"; |
| var isUndef:Boolean = arr.some(isUndefined); |
| if (isUndef) { |
| trace("array contains undefined values: " + arr); |
| } else { |
| trace("array contains no undefined values."); |
| } |
| } |
| private function isUndefined(element:*, index:int, arr:Array):Boolean { |
| return (element == undefined); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/every()" class="- topic/link "><linktext class="- topic/linktext ">every()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:sortOn" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">sortOn</apiName><shortdesc class="- topic/shortdesc "> |
| Sortiert die Elemente in einem Array nach mindestens einem Feld im Array.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.sortOn, sortOn |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Rückgabewert hängt davon ab, ob Sie Parameter übergeben: |
| <ul class="- topic/ul "><li class="- topic/li ">Wenn Sie den Wert 4 oder <codeph class="+ topic/ph pr-d/codeph ">Array.UNIQUESORT</codeph> für den Parameter <codeph class="+ topic/ph pr-d/codeph ">options</codeph> angeben und mindestens zwei zu sortierende Elemente identische Sortierfelder aufweisen, wird der Wert 0 zurückgegeben, und das Array wird nicht geändert. </li><li class="- topic/li ">Wenn Sie den Wert 8 oder <codeph class="+ topic/ph pr-d/codeph ">Array.RETURNINDEXEDARRAY</codeph> für den Parameter <codeph class="+ topic/ph pr-d/codeph ">options</codeph> angeben, wird ein Array zurückgegeben, das die Ergebnisse der Sortierung wiedergibt, und das Array wird nicht geändert.</li><li class="- topic/li ">Andernfalls wird nichts zurückgegeben, und das Array wird entsprechend der Sortierreihenfolge geändert.</li></ul> |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fieldName</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der ein Feld mit einem Sortierwert definiert bzw. ein Array, in dem das erste Element das primäre Sortierfeld, das zweite Element das sekundäre Sortierfeld darstellt usw. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">options</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Durch den Operator <codeph class="+ topic/ph pr-d/codeph ">bitwise OR (|)</codeph> voneinander getrennte Zahlen oder Namen definierter Konstanten, die das Verhalten der Sortierung ändern. Folgende Werte sind für den <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter zulässig: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Array.CASEINSENSITIVE</codeph> oder 1</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Array.DESCENDING</codeph> oder 2</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Array.UNIQUESORT</codeph> oder 4</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Array.RETURNINDEXEDARRAY</codeph> oder 8</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Array.NUMERIC</codeph> oder 16</li></ul> |
| <p product="flash" class="- topic/p ">Codehinweise sind aktiviert, wenn Sie die Stringform des Parameters (z. B. <codeph class="+ topic/ph pr-d/codeph ">DESCENDING</codeph>) anstelle der numerischen Form (2) verwenden.</p> |
| |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sortiert die Elemente in einem Array nach mindestens einem Feld im Array. Das Array muss folgende Merkmale aufweisen: |
| <ul class="- topic/ul "><li class="- topic/li ">Es handelt sich um ein indiziertes und kein assoziatives Array.</li><li class="- topic/li ">Jedes Element des Arrays enthält ein Objekt mit mindestens einer Eigenschaft.</li><li class="- topic/li ">Sämtliche Objekte haben mindestens eine Eigenschaft gemeinsam, anhand deren Werte die Objekte im Array sortiert werden können. Eine solche Eigenschaft wird als <i class="+ topic/ph hi-d/i ">field</i> bezeichnet.</li></ul> |
| <p class="- topic/p ">Wenn Sie mehrere <codeph class="+ topic/ph pr-d/codeph ">fieldName</codeph>-Parameter übergeben, stellt das erste Feld das primäre Sortierfeld dar, das zweite Feld das nächste Sortierfeld usw. Flash sortiert nach Unicode-Werten. (ASCII ist eine Untergruppe von Unicode.) Wenn eines der zu vergleichenden Elemente das im <codeph class="+ topic/ph pr-d/codeph ">fieldName</codeph>-Parameter angegebene Feld nicht enthält, wird davon ausgegangen, dass das Feld auf <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> gesetzt wurde, und die Elemente werden im sortierten Array ohne bestimmte Reihenfolge nacheinander platziert.</p> |
| <p class="- topic/p ">In der Standardeinstellung funktioniert <codeph class="+ topic/ph pr-d/codeph ">Array</codeph> .<codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph> wie folgt:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Bei der Sortierung wird Groß-/Kleinschreibung beachtet (<i class="+ topic/ph hi-d/i ">Z</i> kommt vor <i class="+ topic/ph hi-d/i ">a</i>).</li><li class="- topic/li ">Die Sortierung erfolgt aufsteigend (<i class="+ topic/ph hi-d/i ">a</i> kommt vor <i class="+ topic/ph hi-d/i ">b</i>). </li><li class="- topic/li ">Das Array wird entsprechend der Sortierreihenfolge geändert. Elemente mit identischen Sortierfeldern werden im sortierten Array ohne bestimmte Reihenfolge nacheinander platziert.</li><li class="- topic/li ">Numerische Felder werden so sortiert, als seien sie Strings. 100 kommt demnach vor 99, da „1“ ein kleinerer Stringwert ist als „9“.</li></ul> |
| <p class="- topic/p ">Flash Player 7 umfasst den <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter, mit dem Sie das Standardverhalten der Sortierung außer Kraft setzen können. Wenn Sie ein einfaches Array (z. B. ein Array mit nur einem Feld) sortieren oder eine nicht vom <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter unterstützte Sortierreihenfolge festlegen möchten, verwenden Sie <codeph class="+ topic/ph pr-d/codeph ">Array.sort()</codeph>.</p> |
| <p class="- topic/p ">Wenn Sie mehrere Flags übergeben möchten, trennen Sie diese mithilfe des bitweisen OR-Operators (<codeph class="+ topic/ph pr-d/codeph ">|</codeph>):</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| my_array.sortOn(someFieldName, Array.DESCENDING | Array.NUMERIC); |
| </codeblock> |
| <p class="- topic/p ">In Flash Player 8 haben Sie die Möglichkeit, bei einer Sortierung nach mehreren Feldern für jedes Feld eine andere Sortieroption anzugeben. In Flash Player 8 kann für den <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter ein Array mit Sortieroptionen angegeben werden, bei dem jede Sortieroption einem Sortierfeld im <codeph class="+ topic/ph pr-d/codeph ">fieldName</codeph>-Parameter entspricht. Im folgenden Beispiel wird nach dem primären Sortierfeld <codeph class="+ topic/ph pr-d/codeph ">a</codeph> in absteigender Reihenfolge, dann nach dem sekundären Sortierfeld <codeph class="+ topic/ph pr-d/codeph ">b</codeph> anhand einer numerischen Sortierung und schließlich nach dem Sortierfeld <codeph class="+ topic/ph pr-d/codeph ">c</codeph> mit einer Sortierung ohne Beachtung der Groß-/Kleinschreibung sortiert.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| Array.sortOn (["a", "b", "c"], [Array.DESCENDING, Array.NUMERIC, Array.CASEINSENSITIVE]); |
| </codeblock> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis: </b> Die Arrays <codeph class="+ topic/ph pr-d/codeph ">fieldName</codeph> und <codeph class="+ topic/ph pr-d/codeph ">options</codeph> müssen die gleiche Anzahl von Elementen aufweisen. Andernfalls wird das Array <codeph class="+ topic/ph pr-d/codeph ">options</codeph> ignoriert. Außerdem können die Optionen <codeph class="+ topic/ph pr-d/codeph ">Array.UNIQUESORT</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Array.RETURNINDEXEDARRAY</codeph> nur als erstes Element im Array verwendet werden, da sie ansonsten ignoriert werden.</p> |
| |
| </apiDesc><example conref="examples\Array.sortOn.1.as" class="- topic/example "> Im folgenden Beispiel wird das leere Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> erstellt, das dann durch fünf Aufrufe von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> gefüllt wird. Mit jedem Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> wird ein neues <codeph class="+ topic/ph pr-d/codeph ">Vegetable</codeph>-Objekt durch einen Aufruf des <codeph class="+ topic/ph pr-d/codeph ">Vegetable()</codeph>-Konstruktors erstellt, der ein String- (<codeph class="+ topic/ph pr-d/codeph ">name</codeph>) und ein Number- (<codeph class="+ topic/ph pr-d/codeph ">price</codeph>)-Objekt akzeptiert. Durch das fünfmalige Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> mit den gezeigten Werten ergibt sich das folgende Array: <codeph class="+ topic/ph pr-d/codeph ">[lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44]</codeph>. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph>-Methode zusammen mit dem <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter angewendet, um das folgende Array zu erstellen: <codeph class="+ topic/ph pr-d/codeph ">[asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44]</codeph>. Daraufhin wird die <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph>-Methode erneut zusammen mit dem price-Parameter und den Konstanten NUMERIC und DESCENDING aufgerufen, um ein nach Zahlen in absteigender Reihenfolge sortiertes Array zu erstellen: <codeph class="+ topic/ph pr-d/codeph ">[asparagus:3.99, spinach:1.89, lettuce:1.49, squash:1.44, celery:1.29]</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array(); |
| vegetables.push(new Vegetable("lettuce", 1.49)); |
| vegetables.push(new Vegetable("spinach", 1.89)); |
| vegetables.push(new Vegetable("asparagus", 3.99)); |
| vegetables.push(new Vegetable("celery", 1.29)); |
| vegetables.push(new Vegetable("squash", 1.44)); |
| |
| trace(vegetables); |
| // lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44 |
| |
| vegetables.sortOn("name"); |
| trace(vegetables); |
| // asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44 |
| |
| vegetables.sortOn("price", Array.NUMERIC | Array.DESCENDING); |
| trace(vegetables); |
| // asparagus:3.99, spinach:1.89, lettuce:1.49, squash:1.44, celery:1.29 |
| |
| class Vegetable { |
| public var name:String; |
| public var price:Number; |
| |
| public function Vegetable(name:String, price:Number) { |
| this.name = name; |
| this.price = price; |
| } |
| |
| public function toString():String { |
| return " " + name + ":" + price; |
| } |
| } |
| </codeblock></example><example conref="examples\Array.sortOn.2.as" class="- topic/example "> Im folgenden Beispiel wird das leere Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">records</codeph> erstellt, das dann durch drei Aufrufe von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> gefüllt wird. Mit jedem Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> werden die Strings <codeph class="+ topic/ph pr-d/codeph ">name</codeph> und <codeph class="+ topic/ph pr-d/codeph ">city</codeph> sowie eine <codeph class="+ topic/ph pr-d/codeph ">zip</codeph>-Zahl zu <codeph class="+ topic/ph pr-d/codeph ">records</codeph> hinzugefügt. Die Arrayelemente werden mit drei <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleifen gedruckt. Mit der ersten <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife werden die Elemente in der Reihenfolge gedruckt, in der sie hinzugefügt wurden. Die zweite <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife wird ausgeführt, nachdem <codeph class="+ topic/ph pr-d/codeph ">records</codeph> zuerst anhand des Namens und dann der Stadt mithilfe der <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph>-Methode sortiert wurde. Mit der dritten <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife wird <codeph class="+ topic/ph pr-d/codeph ">records</codeph> zuerst anhand der Stadt und dann anhand des Namens sortiert. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| |
| var records:Array = new Array(); |
| records.push({name:"john", city:"omaha", zip:68144}); |
| records.push({name:"john", city:"kansas city", zip:72345}); |
| records.push({name:"bob", city:"omaha", zip:94010}); |
| |
| for(var i:uint = 0; i < records.length; i++) { |
| trace(records[i].name + ", " + records[i].city); |
| } |
| // Results: |
| // john, omaha |
| // john, kansas city |
| // bob, omaha |
| |
| trace("records.sortOn('name', 'city');"); |
| records.sortOn(["name", "city"]); |
| for(var i:uint = 0; i < records.length; i++) { |
| trace(records[i].name + ", " + records[i].city); |
| } |
| // Results: |
| // bob, omaha |
| // john, kansas city |
| // john, omaha |
| |
| trace("records.sortOn('city', 'name');"); |
| records.sortOn(["city", "name"]); |
| for(var i:uint = 0; i < records.length; i++) { |
| trace(records[i].name + ", " + records[i].city); |
| } |
| // Results: |
| // john, kansas city |
| // bob, omaha |
| // john, omaha |
| </codeblock></example><example conref="examples\Array.sortOn.3.as" class="- topic/example "> Im folgenden Beispiel wird das leere Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">users</codeph> erstellt, das dann durch vier Aufrufe von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> gefüllt wird. Mit jedem Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> wird ein User-Objekt mit dem <codeph class="+ topic/ph pr-d/codeph ">User()</codeph>-Konstruktor erstellt und den Benutzern wird ein <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-String sowie eine <codeph class="+ topic/ph pr-d/codeph ">age</codeph>-uint hinzugefügt. Das sich daraus ergebende Array ist <codeph class="+ topic/ph pr-d/codeph ">[Bob:3,barb:35,abcd:3,catchy:4]</codeph>. |
| <p class="- topic/p ">Anschließend wird das Array folgendermaßen sortiert: |
| <ol class="- topic/ol "><li class="- topic/li ">Anhand des Namens ergibt sich <codeph class="+ topic/ph pr-d/codeph ">[Bob:3,abcd:3,barb:35,catchy:4]</codeph>.</li><li class="- topic/li ">Anhand des Namens zusammen mit der Konstante <codeph class="+ topic/ph pr-d/codeph ">CASEINSENSITIVE</codeph> ergibt sich <codeph class="+ topic/ph pr-d/codeph ">[abcd:3,barb:35,Bob:3,catchy:4]</codeph>.</li><li class="- topic/li ">Anhand des Namens zusammen mit den Konstanten <codeph class="+ topic/ph pr-d/codeph ">CASEINSENSITIVE</codeph> und <codeph class="+ topic/ph pr-d/codeph ">DESCENDING</codeph> ergibt sich <codeph class="+ topic/ph pr-d/codeph ">[catchy:4,Bob:3,barb:35,abcd:3]</codeph>.</li><li class="- topic/li ">Anhand des Alters ergibt sich <codeph class="+ topic/ph pr-d/codeph ">[abcd:3,Bob:3,barb:35,catchy:4]</codeph>.</li><li class="- topic/li ">Anhand des Alters zusammen mit der Konstante <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph> ergibt sich <codeph class="+ topic/ph pr-d/codeph ">[Bob:3,abcd:3,catchy:4,barb:35]</codeph>.</li><li class="- topic/li ">Anhand des Alters zusammen mit den Konstanten <codeph class="+ topic/ph pr-d/codeph ">DESCENDING</codeph> und <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph> ergibt sich <codeph class="+ topic/ph pr-d/codeph ">[barb:35,catchy:4,Bob:3,abcd:3]</codeph>.</li></ol> |
| </p> |
| <p class="- topic/p ">Anschließend wird ein Array mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">indices</codeph> erstellt, dem die Ergebnisse einer Sortierung anhand des Alters zusammen mit den Konstanten <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph> und <codeph class="+ topic/ph pr-d/codeph ">RETURNINDEXEDARRAY</codeph> zugewiesen werden. Daraus ergibt sich das Array <codeph class="+ topic/ph pr-d/codeph ">[Bob:3,abcd:3,catchy:4,barb:35]</codeph>, das mithilfe einer <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife gedruckt wird.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| class User { |
| public var name:String; |
| public var age:Number; |
| public function User(name:String, age:uint) { |
| this.name = name; |
| this.age = age; |
| } |
| |
| public function toString():String { |
| return this.name + ":" + this.age; |
| } |
| } |
| |
| var users:Array = new Array(); |
| users.push(new User("Bob", 3)); |
| users.push(new User("barb", 35)); |
| users.push(new User("abcd", 3)); |
| users.push(new User("catchy", 4)); |
| |
| trace(users); // Bob:3,barb:35,abcd:3,catchy:4 |
| |
| users.sortOn("name"); |
| trace(users); // Bob:3,abcd:3,barb:35,catchy:4 |
| |
| users.sortOn("name", Array.CASEINSENSITIVE); |
| trace(users); // abcd:3,barb:35,Bob:3,catchy:4 |
| |
| users.sortOn("name", Array.CASEINSENSITIVE | Array.DESCENDING); |
| trace(users); // catchy:4,Bob:3,barb:35,abcd:3 |
| |
| users.sortOn("age"); |
| trace(users); // abcd:3,Bob:3,barb:35,catchy:4 |
| |
| users.sortOn("age", Array.NUMERIC); |
| trace(users); // Bob:3,abcd:3,catchy:4,barb:35 |
| |
| users.sortOn("age", Array.DESCENDING | Array.NUMERIC); |
| trace(users); // barb:35,catchy:4,Bob:3,abcd:3 |
| |
| var indices:Array = users.sortOn("age", Array.NUMERIC | Array.RETURNINDEXEDARRAY); |
| var index:uint; |
| for(var i:uint = 0; i < indices.length; i++) { |
| index = indices[i]; |
| trace(users[index].name, ": " + users[index].age); |
| } |
| |
| // Results: |
| // Bob : 3 |
| // abcd : 3 |
| // catchy : 4 |
| // barb : 35 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="operators.html#bitwise_OR" class="- topic/link "><linktext class="- topic/linktext ">| (bitweiser OR-Operator)</linktext></link><link href="#Array/sort()" class="- topic/link "><linktext class="- topic/linktext ">Array.sort()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:sort" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">sort</apiName><shortdesc class="- topic/shortdesc "> |
| Sortiert die Elemente in einem Array.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.sort, sort |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Rückgabewert hängt, wie in der folgenden Liste beschrieben, davon ab, ob Sie Argumente übergeben: |
| <ul class="- topic/ul "><li class="- topic/li ">Wenn Sie den Wert 4 oder <codeph class="+ topic/ph pr-d/codeph ">Array.UNIQUESORT</codeph> für das Argument <codeph class="+ topic/ph pr-d/codeph ">sortOptions</codeph> des Parameters <codeph class="+ topic/ph pr-d/codeph ">...args</codeph> angeben und mindestens zwei zu sortierende Elemente identische Sortierfelder aufweisen, gibt Flash den Wert 0 zurück, ändert das Array jedoch nicht. </li><li class="- topic/li ">Wenn Sie den Wert 8 oder <codeph class="+ topic/ph pr-d/codeph ">Array.RETURNINDEXEDARRAY</codeph> für das Argument <codeph class="+ topic/ph pr-d/codeph ">sortOptions</codeph> des Parameters <codeph class="+ topic/ph pr-d/codeph ">...args</codeph> angeben, gibt Flash ein sortiertes numerisches Array der Indexpositionen zurück, das die Ergebnisse der Sortierung wiedergibt, ändert das Array jedoch nicht. </li><li class="- topic/li ">Andernfalls gibt Flash keinen Wert zurück und ändert das Array entsprechend der Sortierreihenfolge.</li></ul> |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Argumente, die eine Vergleichsfunktion angeben, sowie mindestens ein Wert, der das Verhalten der Sortierung bestimmt. |
| <p class="- topic/p ">Diese Methode verwendet die Syntax und Argumentreihenfolge <codeph class="+ topic/ph pr-d/codeph ">Array.sort(compareFunction, sortOptions)</codeph>, wobei die Argument wie folgt definiert sind:</p> |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">compareFunction</codeph> – Eine Vergleichsfunktion, mit der die Sortierreihenfolge der Elemente im Array festgelegt wird. Dieses Argument ist optional. Eine Vergleichsfunktion sollte zwei zu vergleichende Argumente akzeptieren. Bei gegebenen Elementen A und B kann das Ergebnis von <codeph class="+ topic/ph pr-d/codeph ">compareFunction</codeph> einen negativen oder einen positiven oder den Wert 0 haben: |
| <ul class="- topic/ul "><li class="- topic/li ">Ein negativer Rückgabewert legt fest, dass A in der sortierten Reihenfolge vor B erscheint.</li><li class="- topic/li ">Der Rückgabewert 0 legt fest, dass A und B die gleiche Sortierreihenfolge haben.</li><li class="- topic/li ">Ein positiver Rückgabewert legt fest, dass A in der sortierten Reihenfolge nach B erscheint.</li></ul> |
| </li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">sortOptions</codeph> – Eine oder mehrere durch den bitweisen OR-Operator <codeph class="+ topic/ph pr-d/codeph ">|</codeph> voneinander getrennte Zahlen oder definierte Konstanten, die das Verhalten der Sortierung gegenüber dem Standardverhalten ändern. Dieses Argument ist optional. Folgende Werte sind für <codeph class="+ topic/ph pr-d/codeph ">sortOptions</codeph> zulässig: |
| <ul class="- topic/ul "><li class="- topic/li ">1 oder <codeph class="+ topic/ph pr-d/codeph ">Array.CASEINSENSITIVE</codeph></li><li class="- topic/li ">2 oder <codeph class="+ topic/ph pr-d/codeph ">Array.DESCENDING</codeph></li><li class="- topic/li ">4 oder <codeph class="+ topic/ph pr-d/codeph ">Array.UNIQUESORT</codeph></li><li class="- topic/li ">8 oder <codeph class="+ topic/ph pr-d/codeph ">Array.RETURNINDEXEDARRAY</codeph> </li><li class="- topic/li ">16 oder <codeph class="+ topic/ph pr-d/codeph ">Array.NUMERIC</codeph></li></ul> |
| Weitere Informationen hierzu finden Sie im Abschnitt zur Methode <codeph class="+ topic/ph pr-d/codeph ">Array.sortOn()</codeph>.</li></ul> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sortiert die Elemente in einem Array. Diese Methode sortiert nach Unicode-Werten. (ASCII ist eine Untergruppe von Unicode.) |
| <p class="- topic/p ">In der Standardeinstellung funktioniert <codeph class="+ topic/ph pr-d/codeph ">Array</codeph> .<codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> wie folgt:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Bei der Sortierung wird Groß-/Kleinschreibung beachtet (<i class="+ topic/ph hi-d/i ">Z</i> kommt vor <i class="+ topic/ph hi-d/i ">a</i>).</li><li class="- topic/li ">Die Sortierung erfolgt aufsteigend (<i class="+ topic/ph hi-d/i ">a</i> kommt vor <i class="+ topic/ph hi-d/i ">b</i>). </li><li class="- topic/li ">Das Array wird entsprechend der Sortierreihenfolge geändert. Elemente mit identischen Sortierfeldern werden im sortierten Array ohne bestimmte Reihenfolge nacheinander platziert.</li><li class="- topic/li ">Alle Elemente werden, unabhängig von ihrem Datentyp, so sortiert, als seien sie Strings. 100 kommt demnach vor 99, da „1“ ein kleinerer Stringwert ist als „9“.</li></ul> |
| <p class="- topic/p "> |
| Um ein Array in einer von den Standardeinstellungen abweichenden Reihenfolge zu sortieren, können Sie entweder eine der im Abschnitt <codeph class="+ topic/ph pr-d/codeph ">sortOptions</codeph> des <codeph class="+ topic/ph pr-d/codeph ">...args</codeph>-Parameters beschriebenen Sortierreihenfolgen verwenden oder eine eigene benutzerdefinierte Funktion für die Sortierung erstellen. Wenn Sie eine benutzerdefinierte Funktion erstellen möchten, rufen Sie die <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>-Methode auf und verwenden den Namen der benutzerdefinierten Funktion als erstes Argument (<codeph class="+ topic/ph pr-d/codeph ">compareFunction</codeph>). |
| </p> |
| |
| </apiDesc><example conref="examples\Array.sort.1.as" class="- topic/example "> Im folgenden Beispiel wird das Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[spinach, green pepper, cilantro, onion, avocado]</codeph> erstellt. Anschließend wird das Array mithilfe der <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>-Methode, die ohne Parameter aufgerufen wird, sortiert. Das Ergebnis ist <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> sortiert in alphabetischer Reihenfolge (<codeph class="+ topic/ph pr-d/codeph ">[avocado, cilantro, green pepper, onion, spinach]</codeph>). |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array("spinach", |
| "green pepper", |
| "cilantro", |
| "onion", |
| "avocado"); |
| |
| trace(vegetables); // spinach,green pepper,cilantro,onion,avocado |
| vegetables.sort(); |
| trace(vegetables); // avocado,cilantro,green pepper,onion,spinach |
| </codeblock></example><example conref="examples\Array.sort.2.as" class="- topic/example "> Im folgenden Beispiel wird das Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[spinach, green pepper, Cilantro, Onion, and Avocado]</codeph> erstellt. Anschließend wird das Array mithilfe der <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>-Methode, die beim ersten Mal ohne Parameter aufgerufen wird, sortiert. Das Ergenis ist <codeph class="+ topic/ph pr-d/codeph ">[Avocado,Cilantro,Onion,green pepper,spinach]</codeph>. Anschließend wird <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> erneut für <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> aufgerufen, wobei die Konstante <codeph class="+ topic/ph pr-d/codeph ">CASEINSENSITIVE</codeph> als ein Parameter verwendet wird. Das Ergebnis ist <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> sortiert in alphabetischer Reihenfolge (<codeph class="+ topic/ph pr-d/codeph ">[Avocado, Cilantro, green pepper, Onion, spinach]</codeph>). |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array("spinach", |
| "green pepper", |
| "Cilantro", |
| "Onion", |
| "Avocado"); |
| |
| vegetables.sort(); |
| trace(vegetables); // Avocado,Cilantro,Onion,green pepper,spinach |
| vegetables.sort(Array.CASEINSENSITIVE); |
| trace(vegetables); // Avocado,Cilantro,green pepper,Onion,spinach |
| </codeblock></example><example conref="examples\Array.sort.3.as" class="- topic/example "> Im folgenden Beispiel wird das leere Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> erstellt, das dann durch fünf Aufrufe von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> gefüllt wird. Mit jedem Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> wird ein neues <codeph class="+ topic/ph pr-d/codeph ">Vegetable</codeph>-Objekt durch einen Aufruf des <codeph class="+ topic/ph pr-d/codeph ">Vegetable()</codeph>-Konstruktors erstellt, der ein String- (<codeph class="+ topic/ph pr-d/codeph ">name</codeph>) und ein Number- (<codeph class="+ topic/ph pr-d/codeph ">price</codeph>)-Objekt akzeptiert. Durch das fünfmalige Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> mit den gezeigten Werten ergibt sich das folgende Array: <codeph class="+ topic/ph pr-d/codeph ">[lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44]</codeph>. Dann wird das Array mithilfe der <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>-Methode sortiert, und es ergibt das Array <codeph class="+ topic/ph pr-d/codeph ">[asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44]</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var vegetables:Array = new Array(); |
| vegetables.push(new Vegetable("lettuce", 1.49)); |
| vegetables.push(new Vegetable("spinach", 1.89)); |
| vegetables.push(new Vegetable("asparagus", 3.99)); |
| vegetables.push(new Vegetable("celery", 1.29)); |
| vegetables.push(new Vegetable("squash", 1.44)); |
| |
| trace(vegetables); |
| // lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44 |
| |
| vegetables.sort(); |
| |
| trace(vegetables); |
| // asparagus:3.99, celery:1.29, lettuce:1.49, spinach:1.89, squash:1.44 |
| |
| //The following code defines the Vegetable class |
| class Vegetable { |
| private var name:String; |
| private var price:Number; |
| |
| public function Vegetable(name:String, price:Number) { |
| this.name = name; |
| this.price = price; |
| } |
| |
| public function toString():String { |
| return " " + name + ":" + price; |
| } |
| } |
| </codeblock></example><example conref="examples\Array.sort.4.as" class="- topic/example "> Das folgende Beispiel unterscheidet sich vom vorherigen nur dadurch, dass die <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>-Methode zusammen mit einer benutzerdefinierten Sortierfunktion (<codeph class="+ topic/ph pr-d/codeph ">sortOnPrice</codeph>) ausgeführt wird, d. h. das Array wird nicht in alphabetischer Reihenfolge sondern anhand des Preises sortiert. Beachten Sie, dass die neue Funktion <codeph class="+ topic/ph pr-d/codeph ">getPrice()</codeph> den Preis extrahiert. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array(); |
| vegetables.push(new Vegetable("lettuce", 1.49)); |
| vegetables.push(new Vegetable("spinach", 1.89)); |
| vegetables.push(new Vegetable("asparagus", 3.99)); |
| vegetables.push(new Vegetable("celery", 1.29)); |
| vegetables.push(new Vegetable("squash", 1.44)); |
| |
| trace(vegetables); |
| // lettuce:1.49, spinach:1.89, asparagus:3.99, celery:1.29, squash:1.44 |
| |
| vegetables.sort(sortOnPrice); |
| |
| trace(vegetables); |
| // celery:1.29, squash:1.44, lettuce:1.49, spinach:1.89, asparagus:3.99 |
| |
| function sortOnPrice(a:Vegetable, b:Vegetable):Number { |
| var aPrice:Number = a.getPrice(); |
| var bPrice:Number = b.getPrice(); |
| |
| if(aPrice > bPrice) { |
| return 1; |
| } else if(aPrice < bPrice) { |
| return -1; |
| } else { |
| //aPrice == bPrice |
| return 0; |
| } |
| } |
| |
| // The following code defines the Vegetable class and should be in a separate package. |
| class Vegetable { |
| private var name:String; |
| private var price:Number; |
| |
| public function Vegetable(name:String, price:Number) { |
| this.name = name; |
| this.price = price; |
| } |
| |
| public function getPrice():Number { |
| return price; |
| } |
| |
| public function toString():String { |
| return " " + name + ":" + price; |
| } |
| } |
| </codeblock></example><example conref="examples\Array.sort.5.as" class="- topic/example "> Mit dem folgenden Code wird das Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">numbers</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[3,5,100,34,10]</codeph> erstellt. Durch das Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> ohne Parameter wird das Array in alphabetischer Reihenfolge sortiert; es ergibt das unerwünschte Ergebnis <codeph class="+ topic/ph pr-d/codeph ">[10,100,3,34,5]</codeph>. Um numerische Werte richtig zu sortieren, müssen Sie die <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph>-Konstante an die <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>-Methode übergeben, mit der <codeph class="+ topic/ph pr-d/codeph ">numbers</codeph> wie folgt sortiert wird: <codeph class="+ topic/ph pr-d/codeph ">[3,5,10,34,100]</codeph>. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Das Standardverhalten der Funktion <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> besteht darin, jede Einheit als String zu behandeln. Wenn Sie das <codeph class="+ topic/ph pr-d/codeph ">Array.NUMERIC</codeph>-Argument verwenden, versucht die Flash-Laufzeitumgebung, nicht numerische Werte zu Sortierungszwecken in Ganzzahlen zu konvertieren. Schlägt dies fehl, gibt die Laufzeit einen Fehler aus. Die Laufzeitumgebung kann zum Beispiel den Stringwert <codeph class="+ topic/ph pr-d/codeph ">"6"</codeph> in eine Ganzzahl konvertieren, gibt jedoch einen Fehler aus, wenn ein Stringwert von <codeph class="+ topic/ph pr-d/codeph ">"six"</codeph> auftritt.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var numbers:Array = new Array(3,5,100,34,10); |
| |
| trace(numbers); // 3,5,100,34,10 |
| numbers.sort(); |
| trace(numbers); // 10,100,3,34,5 |
| numbers.sort(Array.NUMERIC); |
| trace(numbers); // 3,5,10,34,100 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="operators.html#bitwise_OR" class="- topic/link "><linktext class="- topic/linktext ">| (bitweiser OR-Operator)</linktext></link><link href="#Array/sortOn()" class="- topic/link "><linktext class="- topic/linktext ">Array.sortOn()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:splice" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">splice</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt einem Array Elemente hinzu bzw. entfernt diese.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.splice, splice |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array, das die aus dem ursprünglichen Array entfernten Elemente enthält. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Indexposition des Arrayelements angibt, an der der Einfüge- oder Löschvorgang beginnt. Sie können hier negative Ganzzahlen verwenden, um eine Position am Ende des Arrays anzugeben (so ist -1 das letzte Element des Arrays). |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">deleteCount</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Anzahl der zu löschenden Elemente angibt. Diese Zahl schließt das im <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph>-Parameter angegebene Element ein. Wenn kein Wert für <codeph class="+ topic/ph pr-d/codeph ">deleteCount</codeph> angegeben ist, löscht die Methode alle Werte von <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> bis zum letzten Arrayelement. Wenn der Wert 0 lautet, werden keine Elemente gelöscht. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">values</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine optionale Liste mit mindestens zwei durch Kommas getrennten Werten, die an der durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> angegebenen Position in das Array einzufügen sind. Wenn ein eingefügter Wert den Typ „Array“ aufweist, wird das Array intakt gehalten und als einzelnes Element eingefügt. Wenn Sie zum Beispiel ein vorhandenes Array mit der Länge 3 mit einem anderen Array mit der Länge 3 verbinden, hat das resultierende Array nur vier Elemente. Eines dieser Elemente ist ein Array mit der Länge 3. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt einem Array Elemente hinzu bzw. entfernt diese. Bei dieser Methode werden Änderungen am Array vorgenommen, ohne eine Kopie zu erstellen. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Um diese Methode in einer Unterklasse von Array zu überschreiben, verwenden Sie, wie im folgenden Beispiel gezeigt, <codeph class="+ topic/ph pr-d/codeph ">...args</codeph> für die Parameter:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| public override function splice(...args) { |
| // your statements here |
| } |
| </pre> |
| </apiDesc><example conref="examples\Array.splice.1.as" class="- topic/example "> Im folgenden Beispiel wird das Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[spinach, green pepper, cilantro, onion, avocado]</codeph> erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">splice()</codeph>-Methode mit den Parametern 2 und 2 aufgerufen. Dadurch werden <codeph class="+ topic/ph pr-d/codeph ">cilantro</codeph> und <codeph class="+ topic/ph pr-d/codeph ">onion</codeph> dem <codeph class="+ topic/ph pr-d/codeph ">spliced</codeph>-Array hinzugefügt. Das <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph>-Array enthält daraufhin <codeph class="+ topic/ph pr-d/codeph ">[spinach,green pepper,avocado]</codeph>. Die <codeph class="+ topic/ph pr-d/codeph ">splice()</codeph>-Methode wird ein zweites Mal mit den Parametern 1 und 0 sowie dem <codeph class="+ topic/ph pr-d/codeph ">spliced</codeph>-Array aufgerufen, um <codeph class="+ topic/ph pr-d/codeph ">[cilantro,onion]</codeph> als zweites Element von <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> zuzuweisen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array("spinach", |
| "green pepper", |
| "cilantro", |
| "onion", |
| "avocado"); |
| |
| var spliced:Array = vegetables.splice(2, 2); |
| trace(vegetables); // spinach,green pepper,avocado |
| trace(spliced); // cilantro,onion |
| |
| vegetables.splice(1, 0, spliced); |
| trace(vegetables); // spinach,cilantro,onion,green pepper,avocado |
| |
| </codeblock></example><example conref="examples\Array.splice.2.as" class="- topic/example "> Beachten Sie, dass <codeph class="+ topic/ph pr-d/codeph ">cilantro</codeph> und <codeph class="+ topic/ph pr-d/codeph ">onion</codeph> wiedergegeben werden, als ob <codeph class="+ topic/ph pr-d/codeph ">vegetables</codeph> 5 Elemente enthielte, obwohl es nur vier sind (wobei es sich beim zweiten Element um ein anderes Array mit zwei Elementen handelt). Sie können <codeph class="+ topic/ph pr-d/codeph ">cilantro</codeph> und <codeph class="+ topic/ph pr-d/codeph ">onion</codeph> einzeln hinzufügen, und zwar mithilfe von: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array("spinach", |
| "green pepper", |
| "cilantro", |
| "onion", |
| "avocado"); |
| |
| var spliced:Array = vegetables.splice(2, 2); |
| trace(vegetables); // spinach,green pepper,avocado |
| trace(spliced); // cilantro,onion |
| |
| vegetables.splice(1, 0, "cilantro", "onion"); |
| trace(vegetables); // spinach,cilantro,onion,green pepper,avocado |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Array:toLocaleString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der die Elemente im angegebenen Array repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String mit Arrayelementen. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der die Elemente im angegebenen Array repräsentiert. Alle Arrayelemente von Indexposition 0 bis zur höchsten Indexposition werden in einen verketteten, durch Kommas getrennten String umgewandelt. In der ActionScript 3.0-Implementierung gibt diese Methode denselben Wert wie die <codeph class="+ topic/ph pr-d/codeph ">Array.toString()</codeph>-Methode zurück. |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/toString()" class="- topic/link "><linktext class="- topic/linktext ">Array.toString()</linktext></link></related-links></apiOperation><apiOperation id="Array:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der die Elemente im angegebenen Array repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.toString, toString |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String mit Arrayelementen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der die Elemente im angegebenen Array repräsentiert. Alle Arrayelemente von Indexposition 0 bis zur höchsten Indexposition werden in einen verketteten, durch Kommas getrennten String umgewandelt. Verwenden Sie die <codeph class="+ topic/ph pr-d/codeph ">Array.join()</codeph>-Methode, um ein benutzerdefiniertes Trennzeichen anzugeben. |
| |
| |
| </apiDesc><example conref="examples\Array.toString.1.as" class="- topic/example "> MIt dem folgenden Beispiel wird ein Array erstellt, die Werte werden in Strings umgewandelt und in der <codeph class="+ topic/ph pr-d/codeph ">vegnums</codeph>-Variable vom Datentyp String gespeichert. |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var vegetables:Array = new Array(); |
| vegetables.push(1); |
| vegetables.push(2); |
| vegetables.push(3); |
| vegetables.push(4); |
| vegetables.push(5); |
| var vegnums:String = vegetables.toString(); |
| trace(vegnums+",6"); |
| // 1,2,3,4,5,6 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/split()" class="- topic/link "><linktext class="- topic/linktext ">String.split()</linktext></link><link href="#Array/join()" class="- topic/link "><linktext class="- topic/linktext ">Array.join()</linktext></link></related-links></apiOperation><apiOperation id="Array:AS3:unshift" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">unshift</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt am Anfang eines Arrays ein oder mehrere Elemente hinzu und gibt die neue Länge des Arrays zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.unshift, unshift |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die neue Länge des Arrays repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine oder mehrere Zahlen, Elemente oder Variablen, die am Anfang des Arrays eingefügt werden sollen. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt am Anfang eines Arrays ein oder mehrere Elemente hinzu und gibt die neue Länge des Arrays zurück. Die anderen Elemente im Array werden von ihrer ursprünglichen Position, i, nach i+1 verschoben. |
| |
| </apiDesc><example conref="examples\Array.unshift.1.as" class="- topic/example "> Im folgenden Beispiel wird das leere Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">names</codeph> erstellt. Die Strings <codeph class="+ topic/ph pr-d/codeph ">Bill</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Jeff</codeph> werden mithilfe der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>-Methode hinzugefügt. Anschließend werden die Strings <codeph class="+ topic/ph pr-d/codeph ">Alfred</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Kyle</codeph> am Anfang von <codeph class="+ topic/ph pr-d/codeph ">names</codeph> durch zwei Aufrufe der <codeph class="+ topic/ph pr-d/codeph ">unshift()</codeph>-Methode eingefügt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var names:Array = new Array(); |
| names.push("Bill"); |
| names.push("Jeff"); |
| |
| trace(names); // Bill,Jeff |
| |
| names.unshift("Alfred"); |
| names.unshift("Kyle"); |
| |
| trace(names); // Kyle,Alfred,Bill,Jeff |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/pop()" class="- topic/link "><linktext class="- topic/linktext ">Array.pop()</linktext></link><link href="#Array/push()" class="- topic/link "><linktext class="- topic/linktext ">Array.push()</linktext></link><link href="#Array/shift()" class="- topic/link "><linktext class="- topic/linktext ">Array.shift()</linktext></link></related-links></apiOperation><apiValue id="Array:CASEINSENSITIVE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">CASEINSENSITIVE</apiName><shortdesc class="- topic/shortdesc "> |
| Legt als Sortiermethode für die Array-Klasse eine Sortierung ohne Beachtung der Groß- und Kleinschreibung fest.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid>x217F6 |
| |
| </helpid></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">1</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt als Sortiermethode für die Array-Klasse eine Sortierung ohne Beachtung der Groß- und Kleinschreibung fest. Sie können diese Konstante als Wert für den <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter in der Methode <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph> verwenden. |
| <p class="- topic/p ">Diese Konstante hat den Wert 1.</p> |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Array/sort()" class="- topic/link "><linktext class="- topic/linktext ">Array.sort()</linktext></link><link href="#Array/sortOn()" class="- topic/link "><linktext class="- topic/linktext ">Array.sortOn()</linktext></link></related-links></apiValue><apiValue id="Array:DESCENDING" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">DESCENDING</apiName><shortdesc class="- topic/shortdesc "> |
| Legt als Sortiermethode für die Array-Klasse eine absteigende Sortierreihenfolge fest.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid>x217F7 |
| |
| </helpid></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">2</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt als Sortiermethode für die Array-Klasse eine absteigende Sortierreihenfolge fest. Sie können diese Konstante als Wert für den <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter in der Methode <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph> verwenden. |
| <p class="- topic/p ">Diese Konstante hat den Wert 2.</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Array/sort()" class="- topic/link "><linktext class="- topic/linktext ">Array.sort()</linktext></link><link href="#Array/sortOn()" class="- topic/link "><linktext class="- topic/linktext ">Array.sortOn()</linktext></link></related-links></apiValue><apiValue id="Array:NUMERIC" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">NUMERIC</apiName><shortdesc class="- topic/shortdesc "> |
| Legt als Sortiermethode für die Array-Klasse eine numerische (statt einer stringbasierten) Sortierreihenfolge fest.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid>x217F8 |
| |
| </helpid></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">16</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt als Sortiermethode für die Array-Klasse eine numerische (statt einer stringbasierten) Sortierreihenfolge fest. Wenn Sie diese Konstante dem <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter hinzufügen, sortieren die <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph>-Methoden Zahlen als numerische Werte und nicht als Strings numerischer Zeichen. Ohne die Konstante <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph> werden bei der Sortierung alle Arrayelemente wie Strings behandelt, und die Ergebnisse werden in der Unicode-Reihenfolge dargestellt. |
| |
| <p class="- topic/p ">Wenn beispielsweise bei einem Array der Werte <codeph class="+ topic/ph pr-d/codeph ">[2005, 7, 35]</codeph> die Konstante <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph> <b class="+ topic/ph hi-d/b ">not</b> dem <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter hinzugefügt ist, lautet das sortierte Array <codeph class="+ topic/ph pr-d/codeph ">[2005, 35, 7]</codeph>. Wurde die Konstante <codeph class="+ topic/ph pr-d/codeph ">NUMERIC</codeph> jedoch <b class="+ topic/ph hi-d/b ">is</b>, lautet das sortierte Array <codeph class="+ topic/ph pr-d/codeph ">[7, 35, 2005]</codeph>. </p> |
| |
| <p class="- topic/p ">Diese Konstante gilt nur für Zahlen im Array. Sie gilt jedoch nicht für Strings mit numerischen Daten wie <codeph class="+ topic/ph pr-d/codeph ">["23", "5"]</codeph>.</p> |
| |
| <p class="- topic/p ">Diese Konstante hat den Wert 16.</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Array/sort()" class="- topic/link "><linktext class="- topic/linktext ">Array.sort()</linktext></link><link href="#Array/sortOn()" class="- topic/link "><linktext class="- topic/linktext ">Array.sortOn()</linktext></link></related-links></apiValue><apiValue id="Array:RETURNINDEXEDARRAY" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">RETURNINDEXEDARRAY</apiName><shortdesc class="- topic/shortdesc "> |
| Legt fest, dass eine Sortierung ein Array zurückgibt, der aus Arrayindizes besteht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid>x217F9 |
| |
| </helpid></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">8</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt fest, dass eine Sortierung ein Array zurückgibt, der aus Arrayindizes besteht. Diese Konstante können Sie für den Parameter <codeph class="+ topic/ph pr-d/codeph ">options</codeph> in den Methoden <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph> verwenden, sodass Sie Zugriff auf mehrere Ansichten zu Arrayelementen haben, während das Originalarray unverändert bleibt. |
| <p class="- topic/p ">Diese Konstante hat den Wert 8.</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Array/sort()" class="- topic/link "><linktext class="- topic/linktext ">Array.sort()</linktext></link><link href="#Array/sortOn()" class="- topic/link "><linktext class="- topic/linktext ">Array.sortOn()</linktext></link></related-links></apiValue><apiValue id="Array:UNIQUESORT" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">UNIQUESORT</apiName><shortdesc class="- topic/shortdesc "> |
| Legt als Sortiermethode für die Array-Klasse eine eindeutige Sortierreihenfolge fest.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid>x217FA |
| |
| </helpid></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">4</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt als Sortiermethode für die Array-Klasse eine eindeutige Sortierreihenfolge fest. Sie können diese Konstante als Wert für den <codeph class="+ topic/ph pr-d/codeph ">options</codeph>-Parameter in der Methode <codeph class="+ topic/ph pr-d/codeph ">sort()</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">sortOn()</codeph> verwenden. Bei der eindeutigen Sortierung wird der Vorgang beendet, sobald zwei beliebige zu sortierende Elemente bzw. Felder den gleichen Wert enthalten. |
| <p class="- topic/p ">Diese Konstante hat den Wert 4.</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Array/sort()" class="- topic/link "><linktext class="- topic/linktext ">Array.sort()</linktext></link><link href="#Array/sortOn()" class="- topic/link "><linktext class="- topic/linktext ">Array.sortOn()</linktext></link></related-links></apiValue><apiValue id="Array:length:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">length</apiName><shortdesc class="- topic/shortdesc "> |
| Eine nicht negative Ganzzahl, die die Anzahl von Elementen im Array angibt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">array.length, length |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine nicht negative Ganzzahl, die die Anzahl von Elementen im Array angibt. Diese Eigenschaft wird automatisch aktualisiert, wenn dem Array neue Elemente hinzugefügt werden. Sobald Sie einem Arrayelement einen Wert zuweisen (z. B. <codeph class="+ topic/ph pr-d/codeph ">my_array[index] = value</codeph>) und wenn <codeph class="+ topic/ph pr-d/codeph ">index</codeph> eine Zahl und <codeph class="+ topic/ph pr-d/codeph ">index+1</codeph> größer als die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft ist, wird die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft auf <codeph class="+ topic/ph pr-d/codeph ">index+1</codeph> aktualisiert. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis: </b>Wenn Sie der <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft einen Wert zuweisen, der kleiner ist als die tatsächliche Länge des Arrays, wird das Array abgeschnitten.</p> |
| |
| </apiDesc><example conref="examples\Array.length.1.as" class="- topic/example "> Mit dem folgenden Code wird ein Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">names</codeph> mit dem Element <codeph class="+ topic/ph pr-d/codeph ">Bill</codeph> erstellt. Anschließend wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>-Methode das String-Element <codeph class="+ topic/ph pr-d/codeph ">Kyle</codeph> hinzugefügt. Die Länge des Arrays, die durch die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft bestimmt wird, betrug ein Element bevor f <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> angewendet wurde; nach dem Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">push()</codeph> beträgt sie zwei Elemente. Ein weiterer String, <codeph class="+ topic/ph pr-d/codeph ">Jeff</codeph>, wird hinzugefügt, damit <codeph class="+ topic/ph pr-d/codeph ">names</codeph> eine Länge von drei Elementen hat. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">shift()</codeph>-Methode zweimal aufgerufen, um <codeph class="+ topic/ph pr-d/codeph ">Bill</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Kyle</codeph> zu entfernen. Abschließend hat <codeph class="+ topic/ph pr-d/codeph ">length</codeph> eine Länge von eins. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var names:Array = new Array("Bill"); |
| names.push("Kyle"); |
| trace(names.length); // 2 |
| |
| names.push("Jeff"); |
| trace(names.length); // 3 |
| |
| names.shift(); |
| names.shift(); |
| trace(names.length); // 1 |
| </codeblock></example></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:RegExp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">RegExp</apiName><shortdesc class="- topic/shortdesc "> |
| |
| Die RegExp-Klasse ermöglicht Ihnen den Einsatz regulärer Ausdrücke. Reguläre Ausdrücke sind Muster, die Sie in Such- und Ersetzungsvorgängen in Strings verwenden können.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| |
| Die RegExp-Klasse ermöglicht Ihnen den Einsatz regulärer Ausdrücke. Reguläre Ausdrücke sind Muster, die Sie in Such- und Ersetzungsvorgängen in Strings verwenden können. |
| |
| <p class="- topic/p ">Ein neues RegExp-Objekt erstellen Sie mithilfe des Konstruktors <codeph class="+ topic/ph pr-d/codeph ">new RegExp()</codeph> oder per Zuweisung eines RegExp-Literals zu einer Variable:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> var pattern1:RegExp = new RegExp("test-\\d", "i"); |
| var pattern2:RegExp = /test-\d/i; |
| </codeblock> |
| |
| <p class="- topic/p ">Weitere Informationen finden Sie unter „Verwenden von regulären Ausdrücken“ im <i class="+ topic/ph hi-d/i ">ActionScript 3.0 Entwicklerhandbuch</i>.</p> |
| |
| </apiDesc><example conref="examples\RegExpExample.as" class="- topic/example "> Aus diesem Beispiel geht hervor, wie Sie mithilfe von regulären Ausdrücken Strings parsen und einen neuen String oder einen booleschen Wert, der auf dem übergebenen String basiert, zurückgeben. Die <codeph class="+ topic/ph pr-d/codeph ">informalizeGreeting()</codeph>-Methode ersetzt einfach das Wort<codeph class="+ topic/ph pr-d/codeph ">Hello</codeph> durch <codeph class="+ topic/ph pr-d/codeph ">Hi</codeph>, wobei die Groß- oder Kleinschreibung keine Rolle spielt. Außerdem wird der Nachname aus dem Namen im String entfernt (vorausgesetzt, dass der Name dem angegebenen Muster entspricht). In den <codeph class="+ topic/ph pr-d/codeph ">validateEmail()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">validatePhoneNumber()</codeph>-Methoden wird der übergebene String wird überprüft, um zu sehen, ob sein Muster einer gültigen E-Mail-Adresse oder einem bestimmten Telefonnummernmuster entspricht. Auf der Grundlage der Ergebnisse geben die Methoden boolesche Werte zurück. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class RegExpExample extends Sprite { |
| public function RegExpExample() { |
| var formalGreeting:String = "Hello, John Smith."; |
| trace(informalizeGreeting(formalGreeting)); // Hi, John. |
| |
| var validEmail:String = "name@domain.com"; |
| trace(validateEmail(validEmail)); // true |
| |
| var invalidEmail:String = "foo"; |
| trace(validateEmail(invalidEmail)); // false |
| |
| var validPhoneNumber:String = "415-555-1212"; |
| trace(validatePhoneNumber(validPhoneNumber)); // true |
| |
| var invalidPhoneNumber:String = "312-867-530999"; |
| trace(validatePhoneNumber(invalidPhoneNumber)); // false |
| } |
| private function informalizeGreeting(str:String):String { |
| var pattern:RegExp = new RegExp("hello, (\\w+) \\w+", "i"); |
| return str.replace(pattern, "Hi, $1"); |
| } |
| private function validateEmail(str:String):Boolean { |
| var pattern:RegExp = /(\w|[_.\-])+@((\w|-)+\.)+\w{2,4}+/; |
| var result:Object = pattern.exec(str); |
| if(result == null) { |
| return false; |
| } |
| return true; |
| } |
| private function validatePhoneNumber(str:String):Boolean { |
| var pattern:RegExp = /^\d{3}-\d{3}-\d{4}$/; |
| var result:Object = pattern.exec(str); |
| if(result == null) { |
| return false; |
| } |
| return true; |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#String/match()" class="- topic/link "><linktext class="- topic/linktext ">String.match()</linktext></link><link href="#String/replace()" class="- topic/link "><linktext class="- topic/linktext ">String.replace()</linktext></link><link href="#String/search()" class="- topic/link "><linktext class="- topic/linktext ">String.search()</linktext></link></related-links><apiConstructor id="RegExp:RegExp" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">RegExp</apiName><shortdesc class="- topic/shortdesc "> |
| Dient zur Erstellung eines regulären Ausdrucks aus zwei Strings.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.attribute, attribute |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">re</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Muster des regulären Ausdrucks (wird auch <i class="+ topic/ph hi-d/i ">Konstruktorstring</i> genannt). Dies ist der Hauptteil des regulären Ausdrucks (der Teil, der innerhalb der Schrägstriche („/“) vorkommt). |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweise:</b> </p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Die einleitenden und abschließenden Schrägstriche („/“) dürfen Sie nicht einbinden. Sie werden nur eingesetzt, wenn Sie ein reguläres Ausdrucksliteral definieren, ohne den Konstruktor zu verwenden. Die beiden folgenden regulären Ausdrücke sind beispielsweise gleichwertig: |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> var re1:RegExp = new RegExp("bob", "i"); |
| var re2:RegExp = /bob/i;</codeblock> |
| |
| </li><li class="- topic/li ">Um in einem regulären Ausdruck, der mit der Konstruktormethode <codeph class="+ topic/ph pr-d/codeph ">RegExp()</codeph> definiert wird, eine Metasequenz zu verwenden, die mit dem rückwärtigen Schrägstrich (\) beginnt, z. B. <codeph class="+ topic/ph pr-d/codeph ">\d</codeph> (was einer beliebigen Ziffer entspricht), geben Sie den rückwärtigen Schrägstrich zweimal ein. Die beiden folgenden regulären Ausdrücke sind beispielsweise gleichwertig: |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> var re1:RegExp = new RegExp("\\d+", ""); |
| var re2:RegExp = /\d/;</codeblock> |
| |
| <p class="- topic/p ">Im ersten Ausdruck müssen Sie in diesem Fall den rückwärtigen Schrägstrich zweimal eingeben, da der erste Parameter der Konstruktormethode <codeph class="+ topic/ph pr-d/codeph ">RegExp()</codeph> ein String ist und in einem Stringliteral ein rückwärtiger Schrägstrich zweimal eingegeben werden muss, damit er als einfacher rückwärtiger Schrägstrich erkannt wird.</p> |
| |
| </li></ul> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">flags</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Modifizierer des regulären Ausdrucks. Dazu zählen die folgenden Zeichen: |
| |
| <ul class="- topic/ul "><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">g</codeph> – Wenn Sie die <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>-Methode der String-Klasse verwenden, geben Sie diesen Modifizierer an, um alle Übereinstimmungen zu ersetzen und nicht nur die erste. Dieser Modifizierer entspricht der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">global</codeph> der RegExp-Instanz.</li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">i</codeph> – Der reguläre Ausdruck wird <i class="+ topic/ph hi-d/i ">ohne</i> Berücksichtigung der Groß-/Kleinschreibung ausgewertet. Dieser Modifizierer entspricht der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">ignoreCase</codeph> der RegExp-Instanz.</li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">s</codeph> – Der Punkt (<codeph class="+ topic/ph pr-d/codeph ">.</codeph>) sucht nach Zeilenumbruchzeichen. Hinweis: Dieser Modifizierer entspricht der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">dotall</codeph> der RegExp-Instanz.</li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">m</codeph> – Das Caretzeichen (<codeph class="+ topic/ph pr-d/codeph ">^</codeph>) und das Dollarzeichen (<codeph class="+ topic/ph pr-d/codeph ">$</codeph>) stimmen vor <i class="+ topic/ph hi-d/i ">und</i> nach einem Zeilenumbruch überein. Dieser Modifizierer entspricht der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">multiline</codeph> der RegExp-Instanz.</li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">x</codeph> – Leerraumzeichen im <codeph class="+ topic/ph pr-d/codeph ">re</codeph>-String werden ignoriert, sodass Sie besser lesbare Konstruktoren schreiben können. Dieser Modifizierer entspricht der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">extended</codeph> der RegExp-Instanz.</li></ul> |
| |
| <p class="- topic/p ">Alle anderen Zeichen im <codeph class="+ topic/ph pr-d/codeph ">flags</codeph>-String werden ignoriert. </p> |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Dient zur Erstellung eines regulären Ausdrucks aus zwei Strings. Ein String definiert das Muster des regulären Ausdrucks, und der zweite definiert die im regulären Ausdruck verwendeten Flags. |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="RegExp:AS3:exec" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">exec</apiName><shortdesc class="- topic/shortdesc "> |
| Führt in dem gegebenen String „str“ eine Suche nach dem regulären Ausdruck durch.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.exec, exec |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">null</codeph>, wenn keine Übereinstimmung gefunden wird; andernfalls ein Objekt mit einer der folgenden Eigenschaften: |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Ein Array, in dem Element 0 den vollständigen, übereinstimmenden Teilstring enthält, und dessen andere Elemente (1 bis <i class="+ topic/ph hi-d/i ">n</i>) Teilstrings enthalten, die in Klammern eingeschlossenen Gruppen im regulären Ausdruck entsprechen </li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">index</codeph> – Die Zeichenposition des übereinstimmenden Teilstrings innerhalb des Strings</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">input</codeph> – Der String (<codeph class="+ topic/ph pr-d/codeph ">str</codeph>)</li></ul> |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der String, der durchsucht werden soll. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt in dem gegebenen String <codeph class="+ topic/ph pr-d/codeph ">str</codeph> eine Suche nach dem regulären Ausdruck durch. |
| |
| <p class="- topic/p ">Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) für den regulären Ausdruck <i class="+ topic/ph hi-d/i ">not</i> gesetzt, so beginnt die Suche am Anfang des Strings (bei Indexposition 0); die Suche ignoriert die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks.</p> |
| |
| <p class="- topic/p ">Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) für den regulären Ausdruck <i class="+ topic/ph hi-d/i ">gesetzt</i>, so beginnt die Suche bei der Indexposition, die durch die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks angegeben wird. Wird nach einem Teilstring gesucht, ändert sich die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft so, dass sie der Position des Endes der Übereinstimmung entspricht. </p> |
| |
| </apiDesc><example class="- topic/example ">Wenn das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) im regulären Ausdruck <i class="+ topic/ph hi-d/i ">nicht</i> gesetzt ist, können Sie mit <codeph class="+ topic/ph pr-d/codeph ">exec()</codeph> nach der ersten Übereinstimmung im String suchen: |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myPattern:RegExp = /(\w~~)sh(\w~~)/ig; |
| var str:String = "She sells seashells by the seashore"; |
| var result:Object = myPattern.exec(str); |
| trace(result); |
| </codeblock> |
| |
| <p class="- topic/p "> Das <codeph class="+ topic/ph pr-d/codeph ">result</codeph>-Objekt wird auf folgende Werte gesetzt:</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">result[0]</codeph> wird auf <codeph class="+ topic/ph pr-d/codeph ">"She"</codeph> gesetzt (die vollständige Übereinstimmung). </li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">result[1]</codeph> wird auf einen leeren String gesetzt (die erste übereinstimmende in Klammern eingeschlossene Gruppe). </li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">result[2]</codeph> wird auf <codeph class="+ topic/ph pr-d/codeph ">"e"</codeph> gesetzt (die zweite übereinstimmende in Klammern eingeschlossene Gruppe). </li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">result.index</codeph> wird auf 0 gesetzt.</li><li class="- topic/li "> <codeph class="+ topic/ph pr-d/codeph ">result.input</codeph> wird auf den Eingabestring gesetzt: <codeph class="+ topic/ph pr-d/codeph ">"She sells seashells by the seashore"</codeph>.</li></ul> |
| |
| |
| |
| <p class="- topic/p "> Im folgenden Beispiel wird das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) im regulären Ausdruck <i class="+ topic/ph hi-d/i ">gesetzt</i>, sodass Sie <codeph class="+ topic/ph pr-d/codeph ">exec()</codeph> wiederholt verwenden können, um mehrere Übereinstimmungen zu finden:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myPattern:RegExp = /(\w~~)sh(\w~~)/ig; |
| var str:String = "She sells seashells by the seashore"; |
| var result:Object = myPattern.exec(str); |
| |
| while (result != null) { |
| trace ( result.index, "\t", result); |
| result = myPattern.exec(str); |
| } |
| </codeblock> |
| |
| <p class="- topic/p "> Der Code ergibt die folgende Ausgabe.</p> |
| |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph "> |
| 0 She,,e |
| 10 seashells,sea,ells |
| 27 seashore,sea,ore |
| </codeph></pre> |
| |
| </example></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/match()" class="- topic/link "><linktext class="- topic/linktext ">String.match()</linktext></link><link href="#String/search()" class="- topic/link "><linktext class="- topic/linktext ">String.search()</linktext></link></related-links></apiOperation><apiOperation id="RegExp:AS3:test" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">test</apiName><shortdesc class="- topic/shortdesc "> |
| Testet in dem gegebenen String „str“ auf Übereinstimmung mit dem regulären Ausdruck.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.test, test |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn es eine Übereinstimmung gibt; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der zu testende String. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft den gegebenen String <codeph class="+ topic/ph pr-d/codeph ">str</codeph> auf eine Übereinstimmung mit dem regulären Ausdruck. |
| |
| <p class="- topic/p ">Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) für den regulären Ausdruck <i class="+ topic/ph hi-d/i ">not</i> gesetzt, so beginnt die Suche am Anfang des Strings (bei Indexposition 0); die Suche ignoriert die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks.</p> |
| |
| <p class="- topic/p ">Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) für den regulären Ausdruck <i class="+ topic/ph hi-d/i ">gesetzt</i>, so beginnt die Suche bei der Indexposition, die durch die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks angegeben wird. Wird nach einem Teilstring gesucht, ändert sich die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft so, dass sie der Position des Endes der Übereinstimmung entspricht. </p> |
| |
| </apiDesc><example conref="examples\RegExp.test.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht die Verwendung der <codeph class="+ topic/ph pr-d/codeph ">test()</codeph>-Methode bei einem regulären Ausdruck, in dem das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) wie folgt gesetzt ist: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var re1:RegExp = /\w/g; |
| var str:String = "a b c"; |
| trace (re1.lastIndex); // 0 |
| trace (re1.test(str)); // true |
| trace (re1.lastIndex); // 1 |
| trace (re1.test(str)); // true |
| trace (re1.lastIndex); // 3 |
| trace (re1.test(str)); // true |
| trace (re1.lastIndex); // 5 |
| trace (re1.test(str)); // false |
| </codeblock></example></apiOperationDetail></apiOperation><apiValue id="RegExp:dotall:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">dotall</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob ein Punkt (.) in einem regulären Ausdruck nach Zeilenumbrüchen sucht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.dotall, dotall |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob ein Punkt (.) in einem regulären Ausdruck nach Zeilenumbrüchen sucht. Verwenden Sie das <codeph class="+ topic/ph pr-d/codeph ">s</codeph>-Flag, um einen regulären Ausdruck zu erstellen, der <codeph class="+ topic/ph pr-d/codeph ">dotall = true</codeph> setzt. |
| |
| </apiDesc><example conref="examples\RegExp.dotall.1.as" class="- topic/example "> Aus dem folgenden Beispiel geht die Wirkung des <codeph class="+ topic/ph pr-d/codeph ">s</codeph>-Flags (<codeph class="+ topic/ph pr-d/codeph ">dotall</codeph>) bei einem regulären Ausdruck hervor: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var str:String = "<p>Hello\n" |
| + "again</p>" |
| + "<p>Hello</p>"; |
| |
| var pattern:RegExp = /<p>.*?<\/p>/; |
| trace(pattern.dotall) // false |
| trace(pattern.exec(str)); // <p>Hello</p> |
| |
| pattern = /<p>.*?<\/p>/s; |
| trace(pattern.dotall) // true |
| trace(pattern.exec(str)); |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="RegExp:extended:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">extended</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob für den regulären Ausdruck der erweiterte Modus verwendet werden soll.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.extended, extended |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob für den regulären Ausdruck der erweiterte Modus verwendet werden soll. Befindet sich ein RegExp-Objekt im erweiterten Modus, werden Leerraumzeichen im Konstruktorstring ignoriert. Dadurch können die Konstruktoren lesbarer gestaltet werden. |
| |
| <p class="- topic/p ">Verwenden Sie das <codeph class="+ topic/ph pr-d/codeph ">x</codeph>-Flag, um einen regulären Ausdruck zu erstellen, der <codeph class="+ topic/ph pr-d/codeph ">extended = true</codeph> setzt. </p> |
| |
| </apiDesc><example conref="examples\RegExp.extended.1.as" class="- topic/example "> Im folgenden Beispiel werden verschiedene Möglichkeiten gezeigt, um den gleichen regulären Ausdruck zu erstellen. In allen Fällen soll mit dem regulären Ausdruck nach dem Telefonnummernmuster xxx-xxx-xxxx oder (xxx) xxx-xxxx oder (xxx)xxx-xxxx gesucht werden. Im zweiten regulären Ausdruck wird das <codeph class="+ topic/ph pr-d/codeph ">x</codeph>-Flag verwendet, wodurch die Leerräume im String ignoriert werden. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var rePhonePattern1:RegExp = /\d{3}-\d{3}-\d{4}|\(\d{3}\)\s?\d{3}-\d{4}/; |
| var str:String = "The phone number is (415)555-1212."; |
| |
| trace(rePhonePattern1.extended) // false |
| trace(rePhonePattern1.exec(str)); // (415)555-1212 |
| |
| var rePhonePattern2:RegExp = / \d{3}-\d{3}-\d{4} | \( \d{3} \) \ ? \d{3}-\d{4} /x; |
| trace(rePhonePattern2.extended) // true |
| trace(rePhonePattern2.exec(str)); // (415)555-1212 |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="RegExp:global:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">global</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob für den regulären Ausdruck eine globale Suche verwendet werden soll.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.global, global |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob für den regulären Ausdruck eine globale Suche verwendet werden soll. Wenn <codeph class="+ topic/ph pr-d/codeph ">global == true</codeph>, wird die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft gesetzt, nachdem eine Übereinstimmung gefunden wurde. Wenn das nächste Mal eine Suche ausgelöste wird, beginnt die Engine für reguläre Ausdrücke ab der Position <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph> in dem String. Verwenden Sie das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag, um einen regulären Ausdruck zu erstellen, der <codeph class="+ topic/ph pr-d/codeph ">global</codeph> auf <codeph class="+ topic/ph pr-d/codeph ">true</codeph> setzt. |
| |
| </apiDesc><example conref="examples\RegExp.global.1.as" class="- topic/example "> Aus dem folgenden Beispiel geht die Wirkung des <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flags (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) auf die <codeph class="+ topic/ph pr-d/codeph ">exec()</codeph>-Methode hervor: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var pattern:RegExp = /foo\d/; |
| var str:String = "foo1 foo2"; |
| trace(pattern.global); // false |
| trace(pattern.exec(str)); // foo1 |
| trace(pattern.lastIndex); // 0 |
| trace(pattern.exec(str)); // foo1 |
| |
| pattern = /foo\d/g; |
| trace(pattern.global); // true |
| trace(pattern.exec(str)); // foo1 |
| trace(pattern.lastIndex); // 4 |
| trace(pattern.exec(str)); // foo2 |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="RegExp:ignoreCase:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">ignoreCase</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob der reguläre Ausdruck die Groß-/Kleinschreibung ignoriert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.ignoreCase, ignoreCase |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob der reguläre Ausdruck die Groß-/Kleinschreibung ignoriert. Verwenden Sie das <codeph class="+ topic/ph pr-d/codeph ">i</codeph>-Flag, um einen regulären Ausdruck zu erstellen, der <codeph class="+ topic/ph pr-d/codeph ">ignoreCase = true</codeph> setzt. |
| |
| </apiDesc><example conref="examples\RegExp.ignoreCase.1.as" class="- topic/example "> Aus dem folgenden Beispiel geht hervor, welche Wirkung das Setzen des <codeph class="+ topic/ph pr-d/codeph ">i</codeph>-Flags (<codeph class="+ topic/ph pr-d/codeph ">ignoreCase</codeph>) hat: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var pattern:RegExp = /bob/; |
| var str:String = "Bob bob"; |
| trace(pattern.ignoreCase); // false |
| trace(pattern.exec(str)); // bob |
| |
| pattern = /bob/i; |
| trace(pattern.ignoreCase); // true |
| trace(pattern.exec(str)); // Bob |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="RegExp:lastIndex:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">lastIndex</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Indexposition im String an, ab der die nächste Suche beginnen soll.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.lastIndex, lastIndex |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Indexposition im String an, ab der die nächste Suche beginnen soll. Diese Eigenschaft wirkt sich auf die <codeph class="+ topic/ph pr-d/codeph ">exec()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">test()</codeph>-Methode der RegExp-Klasse aus. Allerdings ignorieren die <codeph class="+ topic/ph pr-d/codeph ">match()</codeph>-, <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">search()</codeph>-Methoden der String-Klasse die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft und beginnen die Suche immer ab dem Anfang eines Strings. |
| |
| <p class="- topic/p ">Wenn die <codeph class="+ topic/ph pr-d/codeph ">exec()</codeph>- oder <codeph class="+ topic/ph pr-d/codeph ">test()</codeph>-Methode eine Übereinstimmung findet, und das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) für diesen regulären Ausdruck auf <codeph class="+ topic/ph pr-d/codeph ">true</codeph> gesetzt ist, setzt die Methode automatisch die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft auf die Indexposition des Zeichens <i class="+ topic/ph hi-d/i ">nach</i> dem letzten Zeichen im gefundenen passenden Teilstring der letzten Suche. Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph> gesetzt, wird die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft von der Methode nicht gesetzt.</p> |
| |
| <p class="- topic/p ">Sie können die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft setzen, um die Anfangsposition in dem String zu setzen, in dem nach einem regulären Ausdruck gesucht werden soll. </p> |
| |
| </apiDesc><example conref="examples\RegExp.lastIndex.1.as" class="- topic/example "> Aus dem folgenden Beispiel geht hervor, welche Wirkung das Setzen der <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft hat. Außerdem wird gezeigt, wie sie nach einem Aufruf der <codeph class="+ topic/ph pr-d/codeph ">exec()</codeph>-Methode bei einem regulären Ausdruck aktualisiert wird, in dem das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">global</codeph>) gesetzt wurde: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var pattern:RegExp = /\w\d/g; |
| var str:String = "a1 b2 c3 d4"; |
| pattern.lastIndex = 2; |
| trace(pattern.exec(str)); // b2 |
| trace(pattern.lastIndex); // 5 |
| trace(pattern.exec(str)); // c3 |
| trace(pattern.lastIndex); // 8 |
| trace(pattern.exec(str)); // d4 |
| trace(pattern.lastIndex); // 11 |
| trace(pattern.exec(str)); // null |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="RegExp:multiline:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">multiline</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob das m-Flag (multiline) gesetzt wurde.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.multiline, multiline |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob das <codeph class="+ topic/ph pr-d/codeph ">m</codeph>-Flag (<codeph class="+ topic/ph pr-d/codeph ">multiline</codeph>) gesetzt wurde. Ist das Flag gesetzt, wird mit dem Caret- (<codeph class="+ topic/ph pr-d/codeph ">^</codeph>) und dem Dollarzeichen (<codeph class="+ topic/ph pr-d/codeph ">$</codeph>) in einem regulären Ausdruck nach Übereinstimmungen vor und nach einem Zeilenumbruch gesucht. Verwenden Sie das <codeph class="+ topic/ph pr-d/codeph ">m</codeph>-Flag, um einen regulären Ausdruck zu erstellen, der <codeph class="+ topic/ph pr-d/codeph ">multiline = true</codeph> setzt. |
| |
| </apiDesc><example conref="examples\RegExp.multiline.1.as" class="- topic/example "> Aus dem folgenden Beispiel geht hervor, welche Wirkung das Setzen des <codeph class="+ topic/ph pr-d/codeph ">m</codeph>-Flags (<codeph class="+ topic/ph pr-d/codeph ">multiline</codeph>) hat: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var pattern:RegExp = /^bob/; |
| var str:String = "foo\n" |
| + "bob"; |
| trace(pattern.multiline); // false |
| trace(pattern.exec(str)); // null |
| |
| pattern = /^bob/m; |
| trace(pattern.multiline); // true |
| trace(pattern.exec(str)); // bob |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="RegExp:source:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">source</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das Muster des regulären Ausdrucks an.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">RegExp, RegExp.source, source |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das Muster des regulären Ausdrucks an. |
| |
| </apiDesc><example conref="examples\RegExp.source.1.as" class="- topic/example "> Der folgende Code gibt den <codeph class="+ topic/ph pr-d/codeph ">source</codeph>-Parameter für zwei reguläre Ausdrücke aus: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var re1:RegExp = /aabb/gi; |
| trace (re1.source); // aabb |
| |
| var re2:RegExp = new RegExp("x+y*", "i"); |
| trace(re2.source); // x+y* |
| </codeblock></example></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:Date" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Date</apiName><shortdesc class="- topic/shortdesc "> |
| Die Date-Klasse repräsentiert Informationen zu Datum und Uhrzeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Date object, built-in class, date |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Date-Klasse repräsentiert Informationen zu Datum und Uhrzeit. Eine Instanz der Date-Klasse repräsentiert einen bestimmten Zeitpunkt, für den Eigenschaften wie month, day, hours und seconds abgefragt oder geändert werden können. Mit der Date-Klasse können Sie Werte abrufen für Datum und Uhrzeit relativ zur Weltzeit (GMT, heute als Koordinierte Weltzeit, UTC bezeichnet) oder relativ zur Ortszeit, die von der Einstellung für die aktuelle Zeitzone des Betriebssystems bestimmt wird, auf dem Flash Player ausgeführt wird. Die Methoden der Date-Klasse sind nicht statisch, sondern gelten nur für das jeweilige Date-Objekt, das beim Aufruf der Methode angegeben wird. Die Methoden <codeph class="+ topic/ph pr-d/codeph ">Date.UTC()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Date.parse()</codeph> sind Ausnahmen; es handelt sich um statische Methoden. |
| <p product="flash" class="- topic/p ">Wie die Sommerzeit von der Date-Klasse behandelt wird, hängt vom Betriebssystem und der Version der Laufzeitumgebung ab. Flash Player behandelt ab Version 6 die Sommerzeit auf den folgenden Betriebssystemen auf folgende Art:</p> |
| <ul product="flash" class="- topic/ul "><li class="- topic/li ">Windows: Das Date-Objekt passt seine Ausgabe automatisch an die Sommerzeit an. Das Date-Objekt ermittelt, ob für das aktuelle Gebietsschema Sommerzeit Gültigkeit hat, und wenn ja, wann die Umstellung auf Sommer- bzw. Winterzeit erfolgt. Die derzeit verwendeten Umstellungstermine werden jedoch auch auf Datumswerte in der Vergangenheit und Zukunft angewendet, sodass bei in der Vergangenheit liegenden Datumswerten, zu denen für das Gebietsschema andere Umstellungstermine galten, der Sommerzeitausgleich u. U. falsch berechnet wird.</li><li class="- topic/li ">Mac OS X: Das Date-Objekt passt seine Ausgabe automatisch an die Sommerzeit an. Anhand der Zeitzonendatenbank in Mac OSX wird ermittelt, ob für in der Gegenwart oder Vergangenheit liegende Datums- oder Uhrzeitwerte ein Sommerzeitausgleich erfolgen soll.</li><li class="- topic/li ">Mac OS 9: Das Betriebssystem stellt nur Informationen bereit, anhand derer ermittelt werden kann, ob auf das aktuelle Datum und die aktuelle Uhrzeit ein Sommerzeitausgleich angewendet werden soll. Demzufolge geht das Date-Objekt davon aus, dass der aktuelle Sommerzeitausgleich für alle vergangenen und künftigen Datums- und Uhrzeitwerte gilt.</li></ul> |
| <p product="flash" class="- topic/p ">Flash Player 5 behandelt die Sommerzeit auf den verschiedenen Betriebssystemen wie folgt:</p> |
| <ul product="flash" class="- topic/ul "><li class="- topic/li ">Windows: Die US-Sommerzeitregeln finden immer Anwendung, was u. U. zu falschen Umstellungsterminen in Europa und anderen Regionen mit Sommerzeit führt. Ob im aktuellen Gebietsschema Sommerzeit verwendet wird, wird von Flash korrekt erkannt.</li></ul> |
| <p class="- topic/p ">Um die Date-Klasse zu verwenden, erstellen Sie mithilfe des Operators <codeph class="+ topic/ph pr-d/codeph ">new</codeph> eine Date-Instanz.</p> |
| <p class="- topic/p ">ActionScript 3.0 stellt mehrere neue accessor-Eigenschaften bereit, die anstelle der vielen Methoden der Date-Klasse verwendet werden können, die auf Date-Instanzen zugreifen oder sie verändern. ActionScript 3.0 umfasst auch folgende neue Variationen der Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>, die zur Norm ECMA-262, 3rd Edition, gehören: <codeph class="+ topic/ph pr-d/codeph ">Date.toLocaleString()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">Date.toTimeString()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">Date.toLocaleTimeString()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">Date.toDateString()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Date.toLocaleDateString()</codeph>.</p> |
| <p class="- topic/p ">Wie Sie die relative oder verstrichene Zeit berechnen, erfahren Sie im Abschnitt über die Methode <codeph class="+ topic/ph pr-d/codeph ">getTimer()</codeph> im flash.utils-Paket.</p> |
| |
| </apiDesc><example conref="examples\DateExample.as" class="- topic/example "> Das folgende Beispiel veranschaulicht verschiedene Möglichkeiten, wie Sie mit dem <codeph class="+ topic/ph pr-d/codeph ">Date()</codeph>-Konstruktor die folgenden Variablen zuweisen können: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">myDate1</codeph> ruft <codeph class="+ topic/ph pr-d/codeph ">Date()</codeph> ohne Parameter auf, wodurch <codeph class="+ topic/ph pr-d/codeph ">myDate1</codeph> auf das aktuelle Datum und die aktuelle Uhrzeit gesetzt wird (gemäß der aktuellen Datums- und Uhrzeiteinstellung des System). </li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">myDate2</codeph> ruft <codeph class="+ topic/ph pr-d/codeph ">Date()</codeph> auf, wobei die Parameter <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">2000</codeph>), month (<codeph class="+ topic/ph pr-d/codeph ">0</codeph> = Januar) und <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) übergeben werden.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">myDate3</codeph> ruft <codeph class="+ topic/ph pr-d/codeph ">Date()</codeph> mit <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">65</codeph> = 1965), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">2</codeph> = März) auf, wobei <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">6</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">9</codeph>), <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">second</codeph> (<codeph class="+ topic/ph pr-d/codeph ">15</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">millisecond</codeph>-+ (<codeph class="+ topic/ph pr-d/codeph ">0</codeph>) als Parameter übergeben werden.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">myDate4</codeph> ruft <codeph class="+ topic/ph pr-d/codeph ">Date()</codeph> auf, wobei der Zeitwert die Anzahl der Millisekunden <b class="+ topic/ph hi-d/b ">vor</b> (da dieser Wert negativ ist) dem 1. Januar 1970, 0.00 Uhr GMT angibt.</li></ul> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| |
| public class DateExample extends Sprite{ |
| public function DateExample() { |
| var myDate1:Date = new Date(); |
| trace(myDate1); // [NOW] |
| |
| var myDate2:Date = new Date(2000, 0, 1); |
| trace(myDate2); // Sat Jan 1 00:00:00 GMT-0800 2000 |
| |
| var myDate3:Date = new Date(65, 2, 6, 9, 30, 15, 0); |
| trace(myDate3); // Sat Mar 6 09:30:15 GMT-0800 1965 |
| |
| var myDate4:Date = new Date(-14159025000); |
| trace(myDate4); // Sun Jul 20 19:56:15 GMT-0700 1969 |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.utils.xml#/getTimer()" class="- topic/link "><linktext class="- topic/linktext ">flash.utils.getTimer()</linktext></link></related-links><apiConstructor id="Date:Date" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Date</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues Date-Objekt mit dem angegebenen Datum und der angegebenen Uhrzeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">new Date, constructor, date |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">yearOrTimevalue</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn andere Parameter angegeben werden, stellt diese Zahl das Jahr (z. B. 1965), andernfalls einen Zeitwert dar. Wenn es sich um eine Jahresangabe handelt, steht ein Wert von 0 bis 99 für eine Jahreszahl zwischen 1900 und 1999, andernfalls müssen alle vier Ziffern der Jahreszahl angegeben werden. Stellt diese Zahl dagegen einen Zeitwert dar (ohne die Angabe anderer Parameter), so ist die Anzahl der Millisekunden vor bzw. nach dem 1. Januar 1970, 0.00 Uhr GMT gemeint. Ein negativer Wert bezieht sich auf die Zeit <i class="+ topic/ph hi-d/i ">vor</i> dem 1. Januar 1970, 0.00 Uhr GMT, ein positiver Wert auf eine Zeit danach. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">month</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Januar) bis 11 (Dezember). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">date</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">hour</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">minute</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999 Millisekunden. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues Date-Objekt mit dem angegebenen Datum und der angegebenen Uhrzeit. |
| |
| <p class="- topic/p ">Dem <codeph class="+ topic/ph pr-d/codeph ">Date()</codeph>-Konstruktor können bis zu sieben Parameter (year, month, ..., millisecond) übergeben werden, um ein Datum und die Uhrzeit bis hin zu den Millisekunden anzugeben. Das Datum, das das neu erstellte Date-Objekt enthält, hängt von der übergebenen Zahl, dem Datentyp und den Argumenten ab. </p> |
| <ul class="- topic/ul "><li class="- topic/li ">Wenn Sie keine Argumente übergeben, werden dem Date-Objekt das aktuelle Datum und die aktuelle Uhrzeit zugewiesen.</li><li class="- topic/li ">Wenn Sie ein Argument des Datentyps Number übergeben, wird dem Date-Objekt ein Zeitwert zugewiesen, der der Anzahl an Millisekunden entspricht, die seit dem 1. Januar 1970 0:00:000 GMT verstrichen sind, wie es im lone-Argument angegeben ist.</li><li class="- topic/li ">Wenn Sie ein Argument des Datentyps String übergeben, enthält der String ein gültiges Datum und das Date-Objekt enthält einen auf diesem Datum basierenden Zeitwert.</li><li class="- topic/li ">Wenn Sie zwei oder mehrere Argumente übergeben, wird dem Date-Objekt ein Zeitwert zugewiesen, der auf den übergebenen Argumentwerten basiert, die das Jahr, den Monat, den Tag, die Stunde, die Minute, die Sekunde und die Millisekunde des Datums repräsentieren.</li></ul> |
| <p class="- topic/p ">Wenn Sie an den Date-Klassenkonstruktor einen String übergeben, kann das Datum eine Vielzahl von Formaten annehmen, muss aber mindestens, den Monat, den Tag und das Jahr enthalten. So wäre <codeph class="+ topic/ph pr-d/codeph ">Feb 1 2005</codeph> beispielsweise ein zulässiger Datumswert, <codeph class="+ topic/ph pr-d/codeph ">Feb 2005</codeph> aber nicht. Die folgende Liste zeigt einige zulässige Formate auf:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Wochentag Monat Tag Stunde:Minute:Sekunde GMT Jahr (z. B. „Tue Feb 1 00:00:00 GMT-0800 2005“, was dem <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Format entspricht)</li><li class="- topic/li ">Wochentag Monat Tag Jahr Stunde:Minute:Sekunde AM/PM (z. B. „Tue Feb 1 2005 12:00:00 AM“, was dem <codeph class="+ topic/ph pr-d/codeph ">toLocaleString()</codeph>-Format entspricht)</li><li class="- topic/li ">Wochentag Monat Tag Jahr (z. B. „Tue Feb 1 2005“, was dem <codeph class="+ topic/ph pr-d/codeph ">toDateString()</codeph>-Format entspricht)</li><li class="- topic/li ">Monat/Tag/Jahr (z. B. „02/01/2005“)</li><li class="- topic/li ">Monat/Jahr (z. B. „02/2005“)</li></ul> |
| </apiDesc></apiConstructorDetail><related-links class="- topic/related-links "><link href="#Date/getMonth()" class="- topic/link "><linktext class="- topic/linktext ">getMonth()</linktext></link><link href="#Date/getDate()" class="- topic/link "><linktext class="- topic/linktext ">getDate()</linktext></link><link href="#Date/getFullYear()" class="- topic/link "><linktext class="- topic/linktext ">getFullYear()</linktext></link></related-links></apiConstructor><apiOperation id="Date:UTC" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">UTC</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Anzahl von Millisekunden zurück, die zwischen dem 1. Januar 1970, 0.00 Uhr Weltzeit, und der in den Parametern angegebenen Zeit vergangen sind.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.utc, utc, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Anzahl von Millisekunden seit dem 1. Januar 1970 und dem angegebenen Datum und der Uhrzeit. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">year</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine vierstellige Ganzzahl, die das Jahr darstellt (z. B. 2000). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">month</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Januar) bis 11 (Dezember). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">date</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">1</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">hour</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">minute</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Anzahl von Millisekunden zurück, die zwischen dem 1. Januar 1970, 0.00 Uhr Weltzeit, und der in den Parametern angegebenen Zeit vergangen sind. Diese Methode verwendet Weltzeit, während der Konstruktor <codeph class="+ topic/ph pr-d/codeph ">Date</codeph> Ortszeit verwendet. |
| <p class="- topic/p ">Diese Methode ist nützlich, wenn Sie ein UTC-Datum an den Date-Klassenkonstruktor übergeben. Da der Date-Klassenkonstruktor den Zeitabstand in Millisekunden als Argument akzeptiert, können Sie mithilfe der Methode Date.UTC() Ihr UTC-Datum in den entsprechenden Zeitabstand in Millisekunden konvertieren und diesen Zeitabstand dann als Argument an den Date-Klassenkonstruktor senden.</p> |
| |
| </apiDesc><example conref="examples\Date.UTC.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) in Ortszeit erstellt. Durch das Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">UTC()</codeph> innerhalb einer <codeph class="+ topic/ph pr-d/codeph ">setTime()</codeph>-Methode werden die gleichen Parameter auf Weltzeit gesetzt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 15, 20); |
| trace(someBirthday.toString()); |
| |
| someBirthday.setTime(Date.UTC(1974, 10, 30, 15, 20)); |
| trace(someBirthday.toString()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getDate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getDate</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den von einem Date-Objekt gemäß der Ortszeit angegebenen Tag des Monats (eine Ganzzahl von 1 bis 31) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getdate, getdate, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Tag des Monats (1 - 31), den ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den von einem <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt gemäß der Ortszeit angegebenen Tag des Monats (eine Ganzzahl von 1 bis 31) zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getDate.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getDate()</codeph>-Methode aufgerufen, die den Tag des Monats abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class DateExample extends Sprite { |
| |
| public function DateExample() { |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getDate()); // 30 |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getMonth()" class="- topic/link "><linktext class="- topic/linktext ">getMonth()</linktext></link><link href="#Date/getFullYear()" class="- topic/link "><linktext class="- topic/linktext ">getFullYear()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:getDay" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getDay</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den von dem Date-Objekt gemäß der Ortszeit angegebenen Wochentag zurück (0 für Sonntag, 1 für Montag usw.).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getday, getday, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine numerische Version des Tags der Woche (0 - 6), die ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den von dem <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt gemäß der Ortszeit angegebenen Wochentag zurück (0 für Sonntag, 1 für Montag usw.). Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getDay.1.as" class="- topic/example "> Bei folgendem Beispiel wird ein neues Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">weekDayLabels</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday]</codeph> und ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getDay()</codeph>-Methode zweimal aufgerufen. Daraufhin wird zuerst der Tag des Monats als 6 angezeigt und dann wird der Tag der Woche mithilfe von <codeph class="+ topic/ph pr-d/codeph ">weekDayLabels</codeph> angezeigt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var weekDayLabels:Array = new Array("Sunday", |
| "Monday", |
| "Tuesday", |
| "Wednesday", |
| "Thursday", |
| "Friday", |
| "Saturday"); |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getDay()); // 6 |
| trace(weekDayLabels[someBirthday.getDay()]); // Saturday |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getFullYear" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getFullYear</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die vollständige Jahreszahl (eine vierstellige Zahl, z. B. 2000) eines Date-Objekts gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getfullyear, getfullyear, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die vollständige Jahreszahl, die ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die vollständige Jahreszahl (eine vierstellige Zahl, z. B. 2000) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getFullYear.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getFullYear()</codeph>-Methode aufgerufen, die die vierstellige Jahreszahl abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getFullYear()); // 1974 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getHours" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getHours</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Stunde (eine Ganzzahl von 0 bis 23) des day-Teils eines Date-Objekts gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.gethours, gethours, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stunde des Tags (0 - 23), die ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Stunde (eine Ganzzahl von 0 bis 23) des day-Teils eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getHours.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend werden die <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-Methoden aufgerufen, die die Stunden und Minuten im 24-Stunden-Format abrufen. Abschließend wird ein String (<codeph class="+ topic/ph pr-d/codeph ">localTime</codeph>) erstellt und dem Ergebnis zugeordnet, das sich aus dem Aufruf der <codeph class="+ topic/ph pr-d/codeph ">getUSClockTime()</codeph>-Funktion ergibt. Daraufhin werden erneut <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph> aufgerufen und schließlich wird die Uhrzeit ausgegeben: <codeph class="+ topic/ph pr-d/codeph ">03:05 PM</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 15, 5); |
| |
| trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 |
| trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5 |
| |
| var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes()); |
| trace(localTime); // 03:05 PM |
| |
| function getUSClockTime(hrs:uint, mins:uint):String { |
| var modifier:String = "PM"; |
| var minLabel:String = doubleDigitFormat(mins); |
| |
| if(hrs > 12) { |
| hrs = hrs-12; |
| } else if(hrs == 0) { |
| modifier = "AM"; |
| hrs = 12; |
| } else if(hrs < 12) { |
| modifier = "AM"; |
| } |
| |
| return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier); |
| } |
| |
| function doubleDigitFormat(num:uint):String { |
| if(num < 10) { |
| return ("0" + num); |
| } |
| return num; |
| } |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getMilliseconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getMilliseconds</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den milliseconds-Teil (eine Ganzzahl von 0 bis 999) des Date-Objekts gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getmilliseconds, getmilliseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der milliseconds-Teil eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den milliseconds-Teil (eine Ganzzahl von 0 bis 999) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getMilliseconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getMilliseconds()</codeph>-Methode aufgerufen, die die Millisekunden des Date-Objekts <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt seiner Erstellung abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getMilliseconds()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getMinutes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getMinutes</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den minutes-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getminutes, getminutes, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der minutes-Teil eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den minutes-Teil (eine Ganzzahl von 0 bis 59) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getMinutes.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-Methode aufgerufen, die die Minuten des Date-Objekts <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt seiner Erstellung abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(now.getMinutes()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getMonth" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getMonth</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Monat (0 für Januar, 1 für Februar usw.) dieses Date-Objekts gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getmonth, getmonth, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der month-Teil (0 – 11) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Monat (0 für Januar, 1 für Februar usw.) dieses <codeph class="+ topic/ph pr-d/codeph "> Date</codeph>-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getMonth.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">monthLabels</codeph>, und zwar mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">January</codeph> bis <codeph class="+ topic/ph pr-d/codeph ">December</codeph> und einem neuen Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getMonth()</codeph>-Methode zweimal aufgerufen. Dadurch wird zuerst die Zahl des Monats und dann der Name des Monats, in dem das Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> erstellt wurde, zurückgegeben. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var monthLabels:Array = new Array("January", |
| "February", |
| "March", |
| "April", |
| "May", |
| "June", |
| "July", |
| "August", |
| "September", |
| "October", |
| "November", |
| "December"); |
| |
| var now:Date = new Date(); |
| trace(now.getMonth()); |
| trace(monthLabels[now.getMonth()]); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getSeconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getSeconds</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den seconds-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getseconds, getseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der seconds-Teil (0 – 59) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den seconds-Teil (eine Ganzzahl von 0 bis 59) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.getSeconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getSeconds()</codeph>-Methode aufgerufen, die die Sekunden des Date-Objekts <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt seiner Erstellung abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getSeconds()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getTime" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getTime</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt für ein Date-Objekt die Anzahl der Millisekunden zurück, die seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit, vergangen sind.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.gettime, gettime, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Anzahl an Millisekunden, die zwischen dem 1. Januar 1970 und dem Datum, den das <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert, vergangen sind. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt für ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt die Anzahl der Millisekunden zurück, die seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit, vergangen sind. Mit dieser Methode können Sie beim Vergleich von mindestens zwei <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekten einen bestimmten Zeitpunkt angeben. |
| |
| </apiDesc><example conref="examples\Date.getTime.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">mlk</codeph> mit den folgenden Parametern erstellt: <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1929</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">0</codeph> = January) und <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">15</codeph>). Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getTime()</codeph>-Methode aufgerufen, die die Millisekunden seit dem 1. Januar 1970, 0.00 Uhr, abruft. Hierbei handelt es sich um einen negativen Wert, da als Jahr 1929 festgelegt wurde. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var mlk:Date = new Date(1929, 0, 15); |
| trace(mlk); // Tue Jan 15 00:00:00 GMT-0800 1929 |
| trace(mlk.getTime()); // -1292601600000 |
| </codeblock></example><example conref="examples\Date.getTime.2.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt und anschließend wird dem ursprünglichen Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> mithilfe der folgenden DateMath-Klassenmethode (siehe unten) die Zeit seit seiner Erstellung hinzugefügt: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addSeconds()</codeph>: fügt 30 Sekunden zu <codeph class="+ topic/ph pr-d/codeph ">now</codeph> hinzu.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addMinutes()</codeph>: fügt 30 Minuten zu <codeph class="+ topic/ph pr-d/codeph ">now</codeph> hinzu.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addHours()</codeph>: fügt 6 Stunden zum Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> hinzu.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addDays()</codeph> : fügt 30 Tage zum Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> hinzu.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">addWeeks()</codeph> : fügt 4 Wochen zu <codeph class="+ topic/ph pr-d/codeph ">now</codeph> hinzu.</li></ul> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(DateMath.addSeconds(now, 30)); |
| trace(DateMath.addMinutes(now, 30)); |
| trace(DateMath.addHours(now, 6)); |
| trace(DateMath.addDays(now, 30)); |
| trace(DateMath.addWeeks(now, 4)); |
| |
| class DateMath { |
| public static function addWeeks(date:Date, weeks:Number):Date { |
| return addDays(date, weeks*7); |
| } |
| |
| public static function addDays(date:Date, days:Number):Date { |
| return addHours(date, days*24); |
| } |
| |
| public static function addHours(date:Date, hrs:Number):Date { |
| return addMinutes(date, hrs*60); |
| } |
| |
| public static function addMinutes(date:Date, mins:Number):Date { |
| return addSeconds(date, mins*60); |
| } |
| |
| public static function addSeconds(date:Date, secs:Number):Date { |
| var mSecs:Number = secs * 1000; |
| var sum:Number = mSecs + date.getTime(); |
| return new Date(sum); |
| } |
| } |
| </codeblock> <b class="+ topic/ph hi-d/b ">Hinweis</b>: Die Verwendung von getTime bei der Ausführung der Datumsarithmetik ist wichtig, da getTime auch in Schaltjahren verwendet werden kann und keine komplizierte if-Logik wie der folgende Pseudocode erfordert: |
| <pre xml:space="preserve" class="- topic/pre "> |
| function addMonths(num:Number):void { |
| currentMonth = currentMonth + num; |
| if(currentMonth > 12) { |
| currentYear++; |
| currentMonth = currentMonth - 12; |
| } |
| } |
| </pre> |
| </example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getTimezoneOffset" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getTimezoneOffset</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Differenz zwischen der Weltzeit (UTC) und der Ortszeit des Computers in Minuten zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.gettimezoneoffset, gettimezoneoffset, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Anzahl Minuten, die Sie zur Ortszeit des Computers hinzufügen müssen, damit sie gleich der Weltzeit ist. Ist die Ortszeit des Computers später als die Weltzeit, wird ein negativer Wert zurückgegeben. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Differenz zwischen der Weltzeit (UTC) und der Ortszeit des Computers in Minuten zurück. |
| |
| </apiDesc><example conref="examples\Date.getTimezoneOffset.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getTimezoneOffset()</codeph>-Methode aufgerufen, die die Differenz zwischen dem Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> und der Weltzeit in Minuten abruft. Anschließend wird die Zeitzonenabweichung in Stunden umgewandelt, indem das Ergebnis durch 60 geteilt wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var date:Date = new Date(); |
| trace(date.getTimezoneOffset() / 60); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getUTCDate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCDate</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Tag des Monats (eine Ganzzahl von 1 bis 31) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcdate, getutcdate, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Tag des Monats (1 - 31) gemäß Weltzeit (UTC), den ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Tag des Monats (eine Ganzzahl von 1 bis 31) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCDate.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCDate()</codeph>-Methode aufgerufen, die den Tag des Monats gemäß der Weltzeit abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getUTCDate()); // 30 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getDate()" class="- topic/link "><linktext class="- topic/linktext ">getDate()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:getUTCDay" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCDay</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Wochentag (0 für Sonntag, 1 für Montag usw.) dieses Date-Objekts gemäß Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcday, getutcday, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Tag der Woche (0 - 6) gemäß Weltzeit (UTC), den ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Wochentag (0 für Sonntag, 1 für Montag usw.) dieses <codeph class="+ topic/ph pr-d/codeph ">Date </codeph>-Objekts gemäß Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCDay.1.as" class="- topic/example "> Bei folgendem Beispiel wird ein neues Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">weekDayLabels</codeph> mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">[Sunday,Monday,Tuesday,Wednesday,Thursday,Friday,Saturday]</codeph> und ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCDay()</codeph>-Methode zweimal aufgerufen. Daraufhin wird zuerst der Tag des Monats als 6 angezeigt und dann wird der Tag der Woche gemäß Weltzeit mithilfe von <codeph class="+ topic/ph pr-d/codeph ">weekDayLabels</codeph> angezeigt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var weekDayLabels:Array = new Array("Sunday", |
| "Monday", |
| "Tuesday", |
| "Wednesday", |
| "Thursday", |
| "Friday", |
| "Saturday"); |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getUTCDay()); // 6 |
| trace(weekDayLabels[someBirthday.getUTCDay()]); // Saturday |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getDay()" class="- topic/link "><linktext class="- topic/linktext ">getDay()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:getUTCFullYear" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCFullYear</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die vierstellige Jahreszahl des Date-Objekts gemäß Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcfullyear, getutcfullyear, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die vierstellige Jahreszahl gemäß Weltzeit (UTC), die das <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die vierstellige Jahreszahl des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCFullYear.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCFullYear()</codeph>-Methode aufgerufen, die die vierstellige Jahreszahl gemäß Weltzeit abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getUTCFullYear()); // 1974 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getFullYear()" class="- topic/link "><linktext class="- topic/linktext ">getFullYear()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:getUTCHours" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCHours</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Stunde (eine Ganzzahl von 0 bis 23) des Date-Objekts gemäß der Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutchours, getutchours, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stunde (0 - 23) gemäß Weltzeit (UTC), die ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Stunde (eine Ganzzahl von 0 bis 23) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCHours.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend werden die <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-Methoden aufgerufen, die die Stunden und Minuten im 24-Stunden-Format abrufen. Abschließend wird ein String (<codeph class="+ topic/ph pr-d/codeph ">localTime</codeph>) erstellt und dem Ergebnis zugeordnet, das sich aus dem Aufruf der <codeph class="+ topic/ph pr-d/codeph ">getUSClockTime()</codeph>-Funktion ergibt. Daraufhin werden erneut <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph> aufgerufen und schließlich wird die Uhrzeit ausgegeben: <codeph class="+ topic/ph pr-d/codeph ">03:05 PM</codeph>. Abschließend wird eine String-Variable (<codeph class="+ topic/ph pr-d/codeph ">utcTime</codeph>) auf die gleiche Weise wie <codeph class="+ topic/ph pr-d/codeph ">localTime</codeph> erstellt, und in diesem Fall ist das Ergebnis identisch. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 15, 5); |
| |
| trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 |
| trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:5 |
| |
| var localTime:String = getUSClockTime(someBirthday.getHours(), someBirthday.getMinutes()); |
| trace(localTime); // 03:05 PM |
| |
| var utcTime:String = getUSClockTime(someBirthday.getUTCHours(), someBirthday.getUTCMinutes()); |
| trace(utcTime); // 11:05 PM |
| |
| function getUSClockTime(hrs:uint, mins:uint):String { |
| var modifier:String = "PM"; |
| var minLabel:String = doubleDigitFormat(mins); |
| |
| if(hrs > 12) { |
| hrs = hrs-12; |
| } else if(hrs == 0) { |
| modifier = "AM"; |
| hrs = 12; |
| } else if(hrs < 12) { |
| modifier = "AM"; |
| } |
| |
| return (doubleDigitFormat(hrs) + ":" + minLabel + " " + modifier); |
| } |
| |
| function doubleDigitFormat(num:uint):String { |
| if(num < 10) { |
| return ("0" + num); |
| } |
| return num; |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getHours()" class="- topic/link "><linktext class="- topic/linktext ">getHours()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:getUTCMilliseconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCMilliseconds</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den milliseconds-Teil (eine Ganzzahl von 0 bis 999) eines Date-Objekts gemäß Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcmilliseconds, getutcmilliseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der milliseconds-Teil gemäß Weltzeit (UTC) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den milliseconds-Teil (eine Ganzzahl von 0 bis 999) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCMilliseconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCMilliseconds()</codeph>-Methode aufgerufen, die die Millisekunden des Date-Objekts <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt seiner Erstellung gemäß Weltzeit abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getUTCMilliseconds()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getUTCMinutes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCMinutes</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den minutes-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcminutes, getutcminutes, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der minutes-Teil gemäß Weltzeit (UTC) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den minutes-Teil (eine Ganzzahl von 0 bis 59) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCMinutes.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCMinutes()</codeph>-Methode aufgerufen, die die Minuten des Date-Objekts <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt seiner Erstellung gemäß Weltzeit abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getUTCMinutes()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:getUTCMonth" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCMonth</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den month-Teil (von 0 für Januar bis 11 für Dezember) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcmonth, getutcmonth, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der month-Teil gemäß Weltzeit (UTC) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den month-Teil (von 0 für Januar bis 11 für Dezember) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCMonth.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">monthLabels</codeph>, und zwar mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">January</codeph> bis <codeph class="+ topic/ph pr-d/codeph ">December</codeph> und einem neuen Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCMonth()</codeph>-Methode zweimal aufgerufen. Dadurch wird zuerst die Zahl des Monats und dann der Name des Monats, in dem das Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> erstellt wurde, gemäß Weltzeit zurückgegeben. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var monthLabels:Array = new Array("January", |
| "February", |
| "March", |
| "April", |
| "May", |
| "June", |
| "July", |
| "August", |
| "September", |
| "October", |
| "November", |
| "December"); |
| |
| var now:Date = new Date(); |
| trace(now.getMonth()); |
| trace(now.getUTCMonth()); |
| trace(monthLabels[now.getUTCMonth()]); |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getMonth()" class="- topic/link "><linktext class="- topic/linktext ">getMonth()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:getUTCSeconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getUTCSeconds</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den seconds-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.getutcseconds, getutcseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der seconds-Teil gemäß Weltzeit (UTC) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den seconds-Teil (eine Ganzzahl von 0 bis 59) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC) zurück. |
| |
| </apiDesc><example conref="examples\Date.getUTCSeconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCSeconds()</codeph>-Methode aufgerufen, die die Sekunden des Date-Objekts <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt seiner Erstellung gemäß Weltzeit abruft. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getUTCSeconds()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:parse" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">parse</apiName><shortdesc class="- topic/shortdesc "> |
| Konvertiert einen String, der ein Datum repräsentiert, in eine Zahl, die der Anzahl der seit dem 1. Januar 1970 vergangenen Millisekunden gemäß Weltzeit (UTC) entspricht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die der Anzahl der seit dem 1. Januar 1970 vergangenen Millisekunden gemäß Weltzeit (UTC) entspricht. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">date</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung eine Datums, das dem Format für die Ausgabe von <codeph class="+ topic/ph pr-d/codeph ">Date.toString()</codeph> entspricht. Die Ausgabe von <codeph class="+ topic/ph pr-d/codeph ">Date.toString()</codeph> hat das folgende Format: |
| <pre xml:space="preserve" class="- topic/pre "> |
| Day Mon DD HH:MM:SS TZD YYYY |
| </pre> |
| <p class="- topic/p ">Beispiel: </p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| Wed Apr 12 15:30:17 GMT-0700 2006 |
| </pre> |
| <p class="- topic/p ">Die Zeitzonenzuweisung (TZD, Time Zone Designation) hat immer das Format <codeph class="+ topic/ph pr-d/codeph ">GMT-HHMM</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">UTC-HHMM</codeph>, wobei die Abweichung von der Weltzeit (GMT, heute als Koordinierte Weltzeit, UTC bezeichnet) in Stunden und Minuten angegeben wird. Jahr, Monat und Tag können auch durch einen Schrägstrich (<codeph class="+ topic/ph pr-d/codeph ">/</codeph>)getrennt sein oder durch Leerzeichen, aber niemals durch einen Bindestrich (<codeph class="+ topic/ph pr-d/codeph ">-</codeph>). Es werden zudem die folgenden Formate unterstützt (Sie können jeweils auch Teilrepräsentationen dieser Formate verwenden, also nur Monat, Tag und Jahr):</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| MM/DD/YYYY HH:MM:SS TZD |
| HH:MM:SS TZD Day Mon/DD/YYYY |
| Mon DD YYYY HH:MM:SS TZD |
| Day Mon DD HH:MM:SS TZD YYYY |
| Day DD Mon HH:MM:SS TZD YYYY |
| Mon/DD/YYYY HH:MM:SS TZD |
| YYYY/MM/DD HH:MM:SS TZD |
| </pre> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konvertiert einen String, der ein Datum repräsentiert, in eine Zahl, die der Anzahl der seit dem 1. Januar 1970 vergangenen Millisekunden gemäß Weltzeit (UTC) entspricht. |
| |
| </apiDesc><example conref="examples\Date.parse.1.as" class="- topic/example "> Im folgenden Beispiel wird <codeph class="+ topic/ph pr-d/codeph ">dateParsed</codeph> ein Datumsstring für den 30. November 1974 zugewiesen. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">Date.parse()</codeph>-Methode aufgerufen, die das Datum in die Anzahl Millisekunden seit dem 1. Januar 1970 umwandelt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var dateParsed:String = "Sat Nov 30 1974"; |
| |
| var milliseconds:Number = Date.parse(dateParsed); |
| trace(milliseconds); // 155030400000 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/toString()" class="- topic/link "><linktext class="- topic/linktext ">Date.toString()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:setDate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setDate</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt den Tag des Monats gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setdate, setdate, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">day</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt den Tag des Monats gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.setDate.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getDate()</codeph>-Methode aufgerufen, die den Tag des Monats abruft. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setDate()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">day</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">20</codeph> gesetzt ist; daraufhin wird erneut<codeph class="+ topic/ph pr-d/codeph ">getDate()</codeph> aufgerufen, um den neu eingestellten Tag des Monats abzurufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getDate()); // 30 |
| |
| someBirthday.setDate(20); |
| trace(someBirthday.getDate()); // 20 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setFullYear" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setFullYear</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt das Jahr gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setfullyear, setfullyear, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">year</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine vierstellige Zahl zur Angabe eines Jahres. Zweistellige Zahlen sind nicht für vierstellige Jahresangaben vorgesehen. So steht 99 z. B. nicht für das Jahr 1999, sondern für das Jahr 99. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">month</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Januar) bis 11 (Dezember). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">day</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl zwischen 1 und 31. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt das Jahr gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Angabe der Parameter <codeph class="+ topic/ph pr-d/codeph ">month</codeph> und <codeph class="+ topic/ph pr-d/codeph ">day</codeph> setzt diese auf Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| <p class="- topic/p "> |
| Bei Aufruf dieser Methode werden die anderen Felder des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts nicht geändert. Die Methoden <codeph class="+ topic/ph pr-d/codeph ">Date.getUTCDay()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Date.getDay()</codeph> können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert. |
| </p> |
| |
| </apiDesc><example conref="examples\Date.setFullYear.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getFullYear()</codeph>-Methode aufgerufen, die die vierstellige Jahreszahl abruft. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setFullYear()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">year</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">2000</codeph> gesetzt ist; daraufhin wird erneut<codeph class="+ topic/ph pr-d/codeph ">getFullYear()</codeph> aufgerufen, um das neu eingestellte Jahr abzurufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getFullYear()); // 1974 |
| |
| someBirthday.setFullYear(2000); |
| trace(someBirthday.getFullYear()); // 2000 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getUTCDay()" class="- topic/link "><linktext class="- topic/linktext ">getUTCDay()</linktext></link><link href="#Date/getDay()" class="- topic/link "><linktext class="- topic/linktext ">getDay()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:setHours" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setHours</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Stunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.sethours, sethours, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">hour</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr). |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">minute</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Stunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.setHours.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend werden die <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-Methoden aufgerufen, die die Stunden und Minuten abrufen. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setHours()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">hour</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">12</codeph> gesetzt ist; daraufhin wird erneut<codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph> aufgerufen, um die neu eingestellten Stunden und Minuten abzurufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 15, 20); |
| |
| trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 |
| trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20 |
| |
| someBirthday.setHours(12); |
| trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 12:20 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setMilliseconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setMilliseconds</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Millisekunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setmilliseconds, setmilliseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Millisekunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.setMilliseconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getMilliseconds()</codeph>-Methode aufgerufen, die die Anzahl von Millisekunden zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird ein weiteres neues Date-Objekt (<codeph class="+ topic/ph pr-d/codeph ">before</codeph>) mit einem zusätzlichen Aufruf von<codeph class="+ topic/ph pr-d/codeph ">setMilliseconds()</codeph> erstellt, wobei der <codeph class="+ topic/ph pr-d/codeph ">millisecond</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">4</codeph> gesetzt ist. Dann wird <codeph class="+ topic/ph pr-d/codeph ">getMilliseconds()</codeph> erneut aufgerufen. Hierdurch werden die neu eingestellten Millisekunden abgerufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(now.getMilliseconds()); |
| |
| var before:Date = new Date(now.setMilliseconds(4)); |
| trace(before); |
| trace(before.getMilliseconds()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setMinutes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setMinutes</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Minute gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setminutes, setminutes, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">minute</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Minute gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.setMinutes.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-Methode aufgerufen, die die Anzahl von Minuten zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird ein weiteres neues Date-Objekt (<codeph class="+ topic/ph pr-d/codeph ">before</codeph>) mit einem zusätzlichen Aufruf von <codeph class="+ topic/ph pr-d/codeph ">setMinutes()</codeph> erstellt, wobei der <codeph class="+ topic/ph pr-d/codeph ">minute</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> gesetzt ist. <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph> wird erneut aufgerufen. Hierdurch werden die neu eingestellten Minuten abgerufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(now.getMinutes()); |
| |
| var before:Date = new Date(now.setMinutes(0)); |
| trace(before); |
| trace(before.getMinutes()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setMonth" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setMonth</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt den Monat und optional den Tag des Monats gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setmonth, setmonth, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">month</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Januar) bis 11 (Dezember). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">day</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt den Monat und optional den Tag des Monats gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.setMonth.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">monthLabels</codeph>, und zwar mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">January</codeph> bis <codeph class="+ topic/ph pr-d/codeph ">December</codeph> und einem neuen month-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getMonth()</codeph>-Methode aufgerufen, die den Monat zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setMonth()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">month</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> gesetzt ist; daraufhin wird erneut <codeph class="+ topic/ph pr-d/codeph ">getMonth()</codeph> aufgerufen, um den neu eingestellten Monat abzurufen.. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var monthLabels:Array = new Array("January", |
| "February", |
| "March", |
| "April", |
| "May", |
| "June", |
| "July", |
| "August", |
| "September", |
| "October", |
| "November", |
| "December"); |
| |
| var now:Date = new Date(); |
| trace(now.getMonth()); |
| trace(monthLabels[now.getMonth()]); |
| |
| now.setMonth(0); |
| trace(now.getMonth()); // 0 |
| trace(monthLabels[now.getMonth()]); // January |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setSeconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setSeconds</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Sekunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setseconds, setseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Sekunde gemäß Ortszeit ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc><example conref="examples\Date.setSeconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getseconds()</codeph>-Methode aufgerufen, die die Anzahl von Minuten zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setSeconds()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">second</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> gesetzt ist; daraufhin wird erneut<codeph class="+ topic/ph pr-d/codeph ">getSeconds()</codeph> aufgerufen, um die neu eingestellten Sekunden abzurufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getSeconds()); |
| |
| now.setSeconds(0); |
| trace(now.getSeconds()); // 0 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setTime" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setTime</apiName><shortdesc class="- topic/shortdesc "> |
| Legt das Datum in Millisekunden seit dem 1. Januar 1970, 0.00 Uhr fest und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.settime, settime, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, bei der 0 dem 1. Januar, 0.00 Uhr Weltzeit (UTC) entspricht. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt das Datum in Millisekunden seit dem 1. Januar 1970, 0.00 Uhr fest und gibt den neuen Zeitpunkt in Millisekunden zurück. |
| |
| </apiDesc><example conref="examples\Date.setTime.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">setTime()</codeph>-Methode aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">millisecond</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">-1292601600000</codeph> gesetzt ist; dadurch wird die Zeit wie folgt eingestellt: <codeph class="+ topic/ph pr-d/codeph ">Tue Jan 15 00:00:00 GMT-0800 1929</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| |
| now.setTime(-1292601600000); |
| trace(now); // Tue Jan 15 00:00:00 GMT-0800 1929 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setUTCDate" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCDate</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt den Tag des Monats gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutcdate, setutcdate, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">day</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt den Tag des Monats gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Bei Aufruf dieser Methode werden die anderen Felder des <codeph class="+ topic/ph pr-d/codeph ">Date </codeph>-Objekts nicht geändert. Die Methoden <codeph class="+ topic/ph pr-d/codeph ">Date.getUTCDay()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Date.getDay()</codeph> können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert. |
| |
| </apiDesc><example conref="examples\Date.setUTCDate.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCDate()</codeph>-Methode aufgerufen, die den richtigen Tag des Monats zurückgibt. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setUTCDate()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">day</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">1</codeph> gesetzt ist. Mithilfe einer <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung wird bestätigt, dass das Datum richtig gesetzt wurde. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getUTCDate()); // 30 |
| |
| someBirthday.setUTCDate(1); |
| trace(someBirthday); // Fri Nov 1 01:20:00 GMT-0800 1974 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getUTCDay()" class="- topic/link "><linktext class="- topic/linktext ">getUTCDay()</linktext></link><link href="#Date/getDay()" class="- topic/link "><linktext class="- topic/linktext ">getDay()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:setUTCFullYear" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCFullYear</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt das Jahr gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutcfullyear, setutcfullyear, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">year</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die das Jahr mit vier Stellen darstellt, z. B. 2007. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">month</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Januar) bis 11 (Dezember). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">day</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt das Jahr gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. |
| <p class="- topic/p "> |
| Optional können mit dieser Methode auch der Monat und der Tag des Monats eingestellt werden. Bei Aufruf dieser Methode werden die anderen Felder des Objekts nicht geändert. Die Methoden <codeph class="+ topic/ph pr-d/codeph ">Date.getUTCDay()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Date.getDay()</codeph> können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert. |
| </p> |
| |
| </apiDesc><example conref="examples\Date.setUTCFullYear.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCFullYear()</codeph>-Methode aufgerufen, die korrekt die vierstellige Jahreszahl zurückgibt. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setUTCFullYear()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">year</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">1975</codeph> gesetzt ist. Mithilfe einer <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung wird bestätigt, dass das Jahr richtig gesetzt wurde. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 1, 20); |
| trace(someBirthday); // Sat Nov 30 01:20:00 GMT-0800 1974 |
| trace(someBirthday.getUTCFullYear()); // 1974 |
| |
| someBirthday.setUTCFullYear(1975); |
| trace(someBirthday); // Thu Nov 30 01:20:00 GMT-0800 1975 |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getUTCDay()" class="- topic/link "><linktext class="- topic/linktext ">getUTCDay()</linktext></link><link href="#Date/getDay()" class="- topic/link "><linktext class="- topic/linktext ">getDay()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:setUTCHours" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCHours</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Stunde gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutchours, setutchours, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">hour</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Mitternacht) bis 23 (23.00 Uhr). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">minute</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Stunde gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Optional können auch die Minute, Sekunde und Millisekunde angegeben werden. |
| |
| </apiDesc><example conref="examples\Date.setUTCHours.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">someBirthday</codeph> mit den Parametern <codeph class="+ topic/ph pr-d/codeph ">year</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1974</codeph>), <codeph class="+ topic/ph pr-d/codeph ">month</codeph> (<codeph class="+ topic/ph pr-d/codeph ">10</codeph> = November), <codeph class="+ topic/ph pr-d/codeph ">day</codeph> (<codeph class="+ topic/ph pr-d/codeph ">30</codeph>), <codeph class="+ topic/ph pr-d/codeph ">hour</codeph> (<codeph class="+ topic/ph pr-d/codeph ">1</codeph>) und <codeph class="+ topic/ph pr-d/codeph ">minute</codeph> (<codeph class="+ topic/ph pr-d/codeph ">20</codeph>) erstellt. Anschließend werden die <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph>-, <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-, <codeph class="+ topic/ph pr-d/codeph ">getUTCHours()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">getUTCMinutes()</codeph>-Methoden aufgerufen, die die Stunden und Minuten abrufen. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setUTCHours()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">hour</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">12</codeph> gesetzt ist. Anschließend werden die <codeph class="+ topic/ph pr-d/codeph ">getHours()</codeph>-, <codeph class="+ topic/ph pr-d/codeph ">getMinutes()</codeph>-, <codeph class="+ topic/ph pr-d/codeph ">getUTCHours()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">getUTCMinutes()</codeph>-Methoden erneut aufgerufen und die aktualisierte Stunde wird korrekt angezeigt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var someBirthday:Date = new Date(1974, 10, 30, 15, 20); |
| |
| trace(someBirthday); // Sat Nov 30 15:20:00 GMT-0800 1974 |
| trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 15:20 |
| trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 23:20 |
| |
| someBirthday.setUTCHours(12); |
| trace(someBirthday.getHours() + ":" + someBirthday.getMinutes()); // 4:20 |
| trace(someBirthday.getUTCHours() + ":" + someBirthday.getUTCMinutes()); // 12:20 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setUTCMilliseconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCMilliseconds</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Millisekunde gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutcmilliseconds, setutcmilliseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Millisekunde gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. |
| |
| </apiDesc><example conref="examples\Date.setUTCMilliseconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCMilliseconds()</codeph>-Methode aufgerufen, die die Anzahl von Millisekunden gemäß Weltzeit zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird ein weiteres neues Date-Objekt (<codeph class="+ topic/ph pr-d/codeph ">before</codeph>) mit einem zusätzlichen Aufruf von<codeph class="+ topic/ph pr-d/codeph ">setUTCMilliseconds()</codeph> erstellt, wobei der <codeph class="+ topic/ph pr-d/codeph ">millisecond</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">4</codeph> gesetzt ist. <codeph class="+ topic/ph pr-d/codeph ">getUTCMilliseconds()</codeph> wird erneut aufgerufen. Hierdurch werden die neu eingestellten Millisekunden abgerufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(now.getUTCMilliseconds()); |
| |
| var before:Date = new Date(now.setUTCMilliseconds(4)); |
| trace(before); |
| trace(before.getUTCMilliseconds()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setUTCMinutes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCMinutes</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Minute gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutcminutes, setutcminutes, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">minute</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Minute gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Optional können Sie auch die Sekunde und Millisekunde angeben. |
| |
| </apiDesc><example conref="examples\Date.setUTCMinutes.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCMinutes()</codeph>-Methode aufgerufen, die die Anzahl von Minuten gemäß Weltzeit zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird ein weiteres neues Date-Objekt (<codeph class="+ topic/ph pr-d/codeph ">before</codeph>) mit einem zusätzlichen Aufruf von <codeph class="+ topic/ph pr-d/codeph ">setUTCMinutes()</codeph> erstellt, wobei der <codeph class="+ topic/ph pr-d/codeph ">minute</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> gesetzt ist. <codeph class="+ topic/ph pr-d/codeph ">getUTCMinutes()</codeph> wird erneut aufgerufen. Hierdurch werden die neu eingestellten Minuten abgerufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(now.getUTCMinutes()); |
| |
| var before:Date = new Date(now.setUTCMinutes(0)); |
| trace(before); |
| trace(before.getUTCMinutes()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:setUTCMonth" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCMonth</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt den Monat, und optional auch den Tag des Monats, gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutcmonth, setutcmonth, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">month</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 (Januar) bis 11 (Dezember). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">day</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 1 bis 31. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt den Monat, und optional auch den Tag des Monats, gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. Bei Aufruf dieser Methode werden die anderen Felder des Objekts nicht geändert. Die Methoden <codeph class="+ topic/ph pr-d/codeph ">Date.getUTCDay()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Date.getDay()</codeph> können jedoch einen neuen Wert zurückgeben, wenn sich der Wochentag aufgrund des Aufrufs dieser Methode ändert. |
| |
| </apiDesc><example conref="examples\Date.setUTCMonth.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Array-Objekt <codeph class="+ topic/ph pr-d/codeph ">UTCMonthLabels</codeph>, und zwar mit den Elementen <codeph class="+ topic/ph pr-d/codeph ">January</codeph> bis <codeph class="+ topic/ph pr-d/codeph ">December</codeph> und einem neuen UTCMonth-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCMonth()</codeph>-Methode aufgerufen, die den Monat gemäß Weltzeit zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setUTCMonth()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">month</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> gesetzt ist; daraufhin wird erneut <codeph class="+ topic/ph pr-d/codeph ">getUTCMonth()</codeph> aufgerufen, um den neu eingestellten Monat abzurufen.. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var UTCMonthLabels:Array = new Array("January", |
| "February", |
| "March", |
| "April", |
| "May", |
| "June", |
| "July", |
| "August", |
| "September", |
| "October", |
| "November", |
| "December"); |
| |
| var now:Date = new Date(); |
| trace(now.getUTCMonth()); |
| trace(UTCMonthLabels[now.getUTCMonth()]); |
| |
| now.setUTCUTCMonth(0); |
| trace(now.getUTCMonth()); // 0 |
| trace(UTCMonthLabels[now.getUTCMonth()]); // January |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/getDay()" class="- topic/link "><linktext class="- topic/linktext ">getDay()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:setUTCSeconds" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setUTCSeconds</apiName><shortdesc class="- topic/shortdesc "> |
| Stellt die Sekunde, und optional auch die Millisekunde, gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.setutcseconds, setutcseconds, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die neue Zeit in Millisekunden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">second</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 59. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">millisecond</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl von 0 bis 999. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Stellt die Sekunde, und optional auch die Millisekunde, gemäß Weltzeit (UTC) ein, und gibt den neuen Zeitpunkt in Millisekunden zurück. |
| |
| </apiDesc><example conref="examples\Date.setUTCSeconds.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getUTCSeconds()</codeph>-Methode aufgerufen, die die Anzahl von Minuten zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zurückgibt. Dann wird <codeph class="+ topic/ph pr-d/codeph ">setUTCSeconds()</codeph> aufgerufen, wobei der <codeph class="+ topic/ph pr-d/codeph ">second</codeph>-Parameter auf den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> gesetzt ist; daraufhin wird erneut<codeph class="+ topic/ph pr-d/codeph ">getUTCSeconds()</codeph> aufgerufen, um die neu eingestellten Sekunden abzurufen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now.getUTCSeconds()); |
| |
| now.setUTCSeconds(0); |
| trace(now.getUTCSeconds()); // 0 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:toDateString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toDateString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung nur des Wochentags und des Tags des Monats zurück ohne Angabe zu Uhrzeit und Zeitzone.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage name="ActionScript" version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung nur des Wochentags und des Tags des Monats. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung nur des Wochentags und des Tags des Monats zurück ohne Angabe zu Uhrzeit und Zeitzone. Vergleichen Sie dies mit den folgenden Methoden: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Date.toTimeString()</codeph>, die nur die Zeit und die Zeitzone zurückgibt.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Date.toString()</codeph>, die nicht nur den Wochentag und den Tag des Monats zurückgibt, sondern auch die Uhrzeit und die Zeitzone.</li></ul> |
| |
| </apiDesc><example conref="examples\Date.toDateString.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt und anschließend werden die folgenden Methoden innerhalb einer <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung aufgerufen |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">toString</codeph>: zeigt alle Parameter für <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> an.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">toDateString()</codeph>: zeigt die Parameter <codeph class="+ topic/ph pr-d/codeph ">day</codeph>, <codeph class="+ topic/ph pr-d/codeph ">month</codeph> und <codeph class="+ topic/ph pr-d/codeph ">year</codeph> zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> an.</li></ul> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var now:Date = new Date(); |
| trace(now); |
| trace(now.toDateString()); |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/toString()" class="- topic/link "><linktext class="- topic/linktext ">toString()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:toLocaleDateString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleDateString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung nur des Wochentags und des Tags des Monats zurück ohne Angabe zu Uhrzeit und Zeitzone.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage name="ActionScript" version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die <codeph class="+ topic/ph pr-d/codeph ">String</codeph>-Darstellung nur des Wochentags und des Tags des Monats. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung nur des Wochentags und des Tags des Monats zurück ohne Angabe zu Uhrzeit und Zeitzone. Diese Methode gibt denselben Wert zurück wie <codeph class="+ topic/ph pr-d/codeph ">Date.toDateString</codeph>. Vergleichen Sie dies mit den folgenden Methoden: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Date.toTimeString()</codeph>, die nur die Zeit und die Zeitzone zurückgibt.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Date.toString()</codeph>, die nicht nur den Wochentag und den Tag des Monats zurückgibt, sondern auch die Uhrzeit und die Zeitzone.</li></ul> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/toDateString()" class="- topic/link "><linktext class="- topic/linktext ">toDateString()</linktext></link><link href="#Date/toTimeString()" class="- topic/link "><linktext class="- topic/linktext ">toTimeString()</linktext></link><link href="#Date/toString()" class="- topic/link "><linktext class="- topic/linktext ">toString()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:toLocaleString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung des Wochentags, des Tags des Monats, der Uhrzeit gemäß der Ortszeit zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Stringdarstellung eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts in der lokalen Zeitzone. |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung des Wochentags, des Tags des Monats, der Uhrzeit gemäß der Ortszeit zurück. Vergleichen Sie dies mit der Methode <codeph class="+ topic/ph pr-d/codeph ">Date.toString()</codeph>, die dieselben Informationen (plus die Zeitzone) zurückgibt, wobei am Ende des Strings zudem das Jahr erscheint. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:toLocaleTimeString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleTimeString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung nur der Uhrzeit zurück ohne Angabe zu Wochentag, Tag des Monats, Jahr oder Zeitzone.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage name="ActionScript" version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung nur der Uhrzeit und der Zeitzone. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung nur der Uhrzeit zurück ohne Angabe zu Wochentag, Tag des Monats, Jahr oder Zeitzone. Vergleichen Sie dies mit der Methode <codeph class="+ topic/ph pr-d/codeph ">Date.toTimeString()</codeph>, die nur die Uhrzeit und die Zeitzone zurückgibt. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/toTimeString()" class="- topic/link "><linktext class="- topic/linktext ">toTimeString()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung des Wochentags, des Tags des Monats, der Uhrzeit und der Zeitzone zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.tostring, tostring, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung des Wochentags, des Tags des Monats, der Uhrzeit und der Zeitzone zurück. Das Datum für die Ausgabe hat das folgende Format: |
| <pre xml:space="preserve" class="- topic/pre "> |
| Day Mon Date HH:MM:SS TZD YYYY |
| </pre> |
| <p class="- topic/p ">Beispiel:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| Wed Apr 12 15:30:17 GMT-0700 2006 |
| </pre> |
| |
| </apiDesc><example conref="examples\Date.toString.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parametera erstellt. Anschließend wird <codeph class="+ topic/ph pr-d/codeph ">toString</codeph> innerhalb einer <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph> Anweisung aufgerufen, wodurch alle Parameter für <codeph class="+ topic/ph pr-d/codeph ">now</codeph> zum Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> angezeigt werden. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| |
| var now:Date = new Date(); |
| trace(now); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Date:AS3:toTimeString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toTimeString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung nur der Uhrzeit und der Zeitzone zurück ohne Angabe zu Wochentag und Tag des Monats.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage name="ActionScript" version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung nur der Uhrzeit und der Zeitzone. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung nur der Uhrzeit und der Zeitzone zurück ohne Angabe zu Wochentag und Tag des Monats. Vergleichen Sie dies mit der Methode <codeph class="+ topic/ph pr-d/codeph ">Date.toDateString()</codeph>, die nur den Wochentag und den Tag des Monats zurückgibt. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/toDateString()" class="- topic/link "><linktext class="- topic/linktext ">toDateString()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:toUTCString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toUTCString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Stringdarstellung des Wochentags, des Tags des Monats und der Uhrzeit gemäß der Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts in der UTC-Zeitzone. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Stringdarstellung des Wochentags, des Tags des Monats und der Uhrzeit gemäß der Weltzeit (UTC) zurück. Das Datum „1. Februar 2005“ wird beispielsweise als <codeph class="+ topic/ph pr-d/codeph ">Tue Feb 1 00:00:00 2005 UTC</codeph> zurückgegeben. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Date/toString()" class="- topic/link "><linktext class="- topic/linktext ">toString()</linktext></link></related-links></apiOperation><apiOperation id="Date:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt für ein Date-Objekt die Anzahl der Millisekunden zurück, die seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit, vergangen sind.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">date.valueof, valueof, date |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Anzahl an Millisekunden, die zwischen dem 1. Januar 1970 und dem Datum, den das <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt repräsentiert, vergangen sind. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt für ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt die Anzahl der Millisekunden zurück, die seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit, vergangen sind. |
| |
| </apiDesc><example conref="examples\Date.valueOf.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Date-Objekt <codeph class="+ topic/ph pr-d/codeph ">now</codeph> ohne Parameter erstellt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">getTime()</codeph>-Methode aufgerufen, die die Anzahl von Millisekunden zwischen dem Zeitpunkt der Erstellung von <codeph class="+ topic/ph pr-d/codeph ">now</codeph> und dem 1. Januar 1970, 0.00 Uhr abruft. Dann wird <codeph class="+ topic/ph pr-d/codeph ">valueOf()</codeph> aufgerufen, womit ebenfalls diese Anzahl von Millisekunden abgerufen wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| |
| var now:Date = new Date(); |
| trace(now.getTime()); |
| trace(now.valueOf()); |
| </codeblock></example></apiOperationDetail></apiOperation><apiValue id="Date:AS3:dateUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">dateUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Tag des Monats (eine Ganzzahl von 1 bis 31) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Tag des Monats (eine Ganzzahl von 1 bis 31) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Weltzeit (UTC) zurück. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCDate()" class="- topic/link "><linktext class="- topic/linktext ">getUTCDate()</linktext></link><link href="#Date/setUTCDate()" class="- topic/link "><linktext class="- topic/linktext ">setUTCDate()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:date:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">date</apiName><shortdesc class="- topic/shortdesc "> |
| Der von einem Date-Objekt gemäß der Ortszeit angegebenen Tag des Monats (eine Ganzzahl von 1 bis 31).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der von einem <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt gemäß der Ortszeit angegebenen Tag des Monats (eine Ganzzahl von 1 bis 31). Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getDate()" class="- topic/link "><linktext class="- topic/linktext ">getDate()</linktext></link><link href="#Date/setDate()" class="- topic/link "><linktext class="- topic/linktext ">setDate()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:dayUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">dayUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Der Wochentag (0 für Sonntag, 1 für Montag usw.) dieses Date-Objekts gemäß Weltzeit (UTC).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der Wochentag (0 für Sonntag, 1 für Montag usw.) dieses <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC). |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCDay()" class="- topic/link "><linktext class="- topic/linktext ">getUTCDay()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:day:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">day</apiName><shortdesc class="- topic/shortdesc "> |
| Der von dem Date-Objekt gemäß der Ortszeit angegebenen Wochentag (0 für Sonntag, 1 für Montag usw.).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der von dem <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt gemäß der Ortszeit angegebenen Wochentag (0 für Sonntag, 1 für Montag usw.). Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getDay()" class="- topic/link "><linktext class="- topic/linktext ">getDay()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:fullYearUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">fullYearUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Die vierstellige Jahreszahl des Date-Objekts gemäß Weltzeit (UTC).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die vierstellige Jahreszahl des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC). |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCFullYear()" class="- topic/link "><linktext class="- topic/linktext ">getUTCFullYear()</linktext></link><link href="#Date/setUTCFullYear()" class="- topic/link "><linktext class="- topic/linktext ">setUTCFullYear()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:fullYear:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">fullYear</apiName><shortdesc class="- topic/shortdesc "> |
| Die vollständige Jahreszahl (eine vierstellige Zahl, z. B. 2000) eines Date-Objekts gemäß der Ortszeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die vollständige Jahreszahl (eine vierstellige Zahl, z. B. 2000) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getFullYear()" class="- topic/link "><linktext class="- topic/linktext ">getFullYear()</linktext></link><link href="#Date/setFullYear()" class="- topic/link "><linktext class="- topic/linktext ">setFullYear()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:hoursUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">hoursUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Die Stunde (eine Ganzzahl von 0 bis 23) des Date-Objekts gemäß der Weltzeit (UTC).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Stunde (eine Ganzzahl von 0 bis 23) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Weltzeit (UTC). |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCHours()" class="- topic/link "><linktext class="- topic/linktext ">getUTCHours()</linktext></link><link href="#Date/setUTCHours()" class="- topic/link "><linktext class="- topic/linktext ">setUTCHours()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:hours:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">hours</apiName><shortdesc class="- topic/shortdesc "> |
| Die Stunde (eine Ganzzahl von 0 bis 23) des day-Teils eines Date-Objekts gemäß der Ortszeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Stunde (eine Ganzzahl von 0 bis 23) des day-Teils eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getHours()" class="- topic/link "><linktext class="- topic/linktext ">getHours()</linktext></link><link href="#Date/setHours()" class="- topic/link "><linktext class="- topic/linktext ">setHours()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:millisecondsUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">millisecondsUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Der milliseconds-Teil (eine Ganzzahl von 0 bis 999) eines Date-Objekts gemäß Weltzeit (UTC).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der milliseconds-Teil (eine Ganzzahl von 0 bis 999) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC). |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCMilliseconds()" class="- topic/link "><linktext class="- topic/linktext ">getUTCMilliseconds()</linktext></link><link href="#Date/setUTCMilliseconds()" class="- topic/link "><linktext class="- topic/linktext ">setUTCMilliseconds()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:milliseconds:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">milliseconds</apiName><shortdesc class="- topic/shortdesc "> |
| Der milliseconds-Teil (eine Ganzzahl von 0 bis 999) des Date-Objekts gemäß der Ortszeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der milliseconds-Teil (eine Ganzzahl von 0 bis 999) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getMilliseconds()" class="- topic/link "><linktext class="- topic/linktext ">getMilliseconds()</linktext></link><link href="#Date/setMilliseconds()" class="- topic/link "><linktext class="- topic/linktext ">setMilliseconds()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:minutesUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">minutesUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Der minutes-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der minutes-Teil (eine Ganzzahl von 0 bis 59) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC). |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCMinutes()" class="- topic/link "><linktext class="- topic/linktext ">getUTCMinutes()</linktext></link><link href="#Date/setUTCMinutes()" class="- topic/link "><linktext class="- topic/linktext ">setUTCMinutes()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:minutes:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">minutes</apiName><shortdesc class="- topic/shortdesc "> |
| Der minutes-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der minutes-Teil (eine Ganzzahl von 0 bis 59) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getMinutes()" class="- topic/link "><linktext class="- topic/linktext ">getMinutes()</linktext></link><link href="#Date/setMinutes()" class="- topic/link "><linktext class="- topic/linktext ">setMinutes()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:monthUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">monthUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Der month-Teil (von 0 für Januar bis 11 für Dezember) eines Date-Objekts gemäß der Weltzeit (UTC) zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den month-Teil (von 0 für Januar bis 11 für Dezember) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Weltzeit (UTC) zurück. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCMonth()" class="- topic/link "><linktext class="- topic/linktext ">getUTCMonth()</linktext></link><link href="#Date/setUTCMonth()" class="- topic/link "><linktext class="- topic/linktext ">setUTCMonth()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:month:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">month</apiName><shortdesc class="- topic/shortdesc "> |
| Der month-Teil (0 für Januar, 1 für Februar usw.) dieses Date-Objekts gemäß der Ortszeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der month-Teil (0 für Januar, 1 für Februar usw.) dieses <codeph class="+ topic/ph pr-d/codeph "> Date</codeph>-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getMonth()" class="- topic/link "><linktext class="- topic/linktext ">getMonth()</linktext></link><link href="#Date/setMonth()" class="- topic/link "><linktext class="- topic/linktext ">setMonth()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:secondsUTC:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">secondsUTC</apiName><shortdesc class="- topic/shortdesc "> |
| Der seconds-Teil (eine Ganzzahl von 0 bis 59) eines Date-Objekts gemäß Weltzeit (UTC).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der seconds-Teil (eine Ganzzahl von 0 bis 59) eines <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß Weltzeit (UTC). |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getUTCSeconds()" class="- topic/link "><linktext class="- topic/linktext ">getUTCSeconds()</linktext></link><link href="#Date/setUTCSeconds()" class="- topic/link "><linktext class="- topic/linktext ">setUTCSeconds()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:seconds:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">seconds</apiName><shortdesc class="- topic/shortdesc "> |
| Der seconds-Teil (eine Ganzzahl von 0 bis 59) des Date-Objekts gemäß der Ortszeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der seconds-Teil (eine Ganzzahl von 0 bis 59) des <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekts gemäß der Ortszeit. Die Ortszeit wird durch das Betriebssystem festgelegt, auf dem die Flash-Laufzeitumgebungen ausgeführt werden. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getSeconds()" class="- topic/link "><linktext class="- topic/linktext ">getSeconds()</linktext></link><link href="#Date/setSeconds()" class="- topic/link "><linktext class="- topic/linktext ">setSeconds()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:time:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">time</apiName><shortdesc class="- topic/shortdesc "> |
| Die Anzahl der Millisekunden seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit für ein Date-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Anzahl der Millisekunden Gibt seit dem 1. Januar 1970, 0.00 Uhr, Weltzeit (UTC) für ein <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekt. Mit dieser Methode können Sie beim Vergleich von mindestens zwei <codeph class="+ topic/ph pr-d/codeph ">Date</codeph>-Objekten einen bestimmten Zeitpunkt angeben. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getTime()" class="- topic/link "><linktext class="- topic/linktext ">getTime()</linktext></link><link href="#Date/setTime()" class="- topic/link "><linktext class="- topic/linktext ">setTime()</linktext></link></related-links></apiValue><apiValue id="Date:AS3:timezoneOffset:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">timezoneOffset</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Differenz zwischen der Weltzeit (UTC) und der Ortszeit des Computers in Minuten zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Differenz zwischen der Weltzeit (UTC) und der Ortszeit des Computers in Minuten zurück. Dieser Wert gibt die Anzahl von Minuten an, die Sie zur Ortszeit des Computers hinzufügen müssen, damit sie gleich der Weltzeit ist. Ist die Ortszeit des Computers später als die Weltzeit, wird ein negativer Wert zurückgegeben. |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Date/getTimezoneOffset()" class="- topic/link "><linktext class="- topic/linktext ">getTimezoneOffset()</linktext></link></related-links></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:Object" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Object</apiName><shortdesc class="- topic/shortdesc "> |
| Die Object-Klasse ist das Stammelement der ActionScript-Klassenhierarchie zur Laufzeit.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">object, object object, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die <ph class="- topic/ph ">Object</ph>-Klasse ist das Stammelement der ActionScript-Klassenhierarchie. Objekte werden von Konstruktoren mithilfe der <codeph class="+ topic/ph pr-d/codeph ">new</codeph>-Operatorsyntax erstellt und können Eigenschaften dynamisch zugewiesen bekommen. <ph class="- topic/ph ">Objekte können auch erstellt werden, indem, wie im folgenden Code, ein Objektliteral zugewiesen wird:</ph> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">var obj:Object = {a:"foo", b:"bar"}</codeblock> |
| |
| <p class="- topic/p ">Alle Klassen, die nicht ausdrücklich eine Basisklasse deklarieren, erweitern die integrierte Object-Klasse.</p> |
| |
| |
| |
| <p class="- topic/p ">Sie können die Object-Klasse einsetzen, um <i class="+ topic/ph hi-d/i ">assoziative Arrays</i> zu erstellen. Im Grunde ist ein assoziatives Array eine Instanz der Object-Klasse, bei der jedes Schlüssel-Werte-Paar durch eine Eigenschaft und deren Wert dargestellt wird. Ein weiterer Grund für die Deklaration eines assoziativen Arrays mit dem Object-Datentyp besteht darin, dass das assoziative Array auf diese Weise mithilfe von Objektliteralen mit Daten gefüllt werden kann (wenn auch nur unmittelbar bei seiner Erstellung). Im folgenden Beispiel wird ein assoziatives Array mit einem Objektliteral erstellt. Der anschließende Zugriff auf dessen Elemente erfolgt sowohl mit dem Punkt (.)- als auch mit dem Array-Zugriffsoperator. Anschließend wird durch Erstellen einer neuen Eigenschaft ein neues Schlüssel-Werte-Paar hinzugefügt:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myAssocArray:Object = {fname:"John", lname:"Public"}; |
| trace(myAssocArray.fname); // John |
| trace(myAssocArray["lname"]); // Public |
| myAssocArray.initial = "Q"; |
| trace(myAssocArray.initial); // Q</codeblock> |
| |
| <p class="- topic/p ">ActionScript 3.0 verfügt über zwei Arten der Vererbung: Klassenvererbung und Prototypvererbung:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Klassenvererbung ist die primäre Vererbungsart. Sie unterstützt die Vererbung fester Eigenschaften. Eine feste Eigenschaft ist eine Variable oder Methode, die als Teil einer Klassendefinition deklariert worden ist. Jede Klassendefinition wird nun durch ein spezielles Klassenobjekt repräsentiert, das Informationen über die Klasse speichert. </li><li class="- topic/li ">Die Prototypvererbung war in früheren ActionScript-Versionen die einzige Vererbungsart. In ActionScript 3.0 dient sie als alternative Vererbungsform. Mit jeder Klasse ist ein Prototypobjekt verbunden und die Eigenschaften des Prototypobjekts werden von allen Instanzen der Klasse genutzt. Wenn eine Klasseninstanz erstellt wird, besitzt diese einen Verweis auf das Prototypobjekt ihrer Klasse, der als Verknüpfung zwischen der Instanz und ihrem verbundenen Klassenprototypobjekt dient. Wenn während der Laufzeit für eine Klasseninstanz eine bestimmte Eigenschaft nicht gefunden wird, wird das Delegate-Objekt, das identisch ist mit dem Klassenprototypobjekt, auf die Eigenschaft hin überprüft. Enthält das Prototypobjekt die Eigenschaft auch nicht, wird der Vorgang fortgesetzt, indem das Delegate-Objekt des Prototypobjekts in der nächsthöheren Hierarchieebene sucht, bis die Flash-Laufzeitumgebung die Eigenschaft findet. </li></ul> |
| |
| <p class="- topic/p ">Klassen- und Prototypvererbung können nebeneinander existieren, wie Sie im folgenden Beispiel sehen können:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| class A { |
| var x = 1 |
| prototype.px = 2 |
| } |
| dynamic class B extends A { |
| var y = 3 |
| prototype.py = 4 |
| } |
| |
| var b = new B() |
| b.x // 1 via class inheritance |
| b.px // 2 via prototype inheritance from A.prototype |
| b.y // 3 |
| b.py // 4 via prototype inheritance from B.prototype |
| |
| B.prototype.px = 5 |
| b.px // now 5 because B.prototype hides A.prototype |
| |
| b.px = 6 |
| b.px // now 6 because b hides B.prototype</codeblock> |
| |
| <p class="- topic/p ">Wenn Sie Funktionen anstelle von Klassen verwenden, können Sie eine eigene Prototypvererbungsstruktur erstellen. Mit Klassen wird die Prototypvererbungsstruktur in der Klassenvererbungsstruktur widergespiegelt. Da Prototypobjekte jedoch dynamisch sind, können Sie prototypgestützte Eigenschaften auch während der Laufzeit hinzufügen oder löschen.</p> |
| |
| </apiDesc><example conref="examples\ObjectExample.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der Klassen <codeph class="+ topic/ph pr-d/codeph ">ObjectExample</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Circle</codeph> der dynamische Charakter der Object-Klasse veranschaulicht. Außerdem wird gezeigt, wie Value-Objekte in Shape-Objekte umgewandelt und zur Bühne an den angegebenen x/y-Koordinaten hinzugefügt werden können. |
| |
| <p class="- topic/p ">Im folgenden Beispiel werden die Value-Objekte <codeph class="+ topic/ph pr-d/codeph ">firstInitObj</codeph> und <codeph class="+ topic/ph pr-d/codeph ">secondInitObj</codeph> erstellt. Die benutzerdefinierte Klasse <codeph class="+ topic/ph pr-d/codeph ">Circle</codeph> akzeptiert das Value-Objekt, durchläuft es wiederholt und stellt seine entsprechenden internen Eigenschaften gemäß den im Value-Objekt definierten Werten ein.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ObjectExample extends Sprite { |
| public function ObjectExample() { |
| var firstInitObj:Object = new Object(); |
| firstInitObj.bgColor = 0xFF0000; |
| firstInitObj.radius = 25; |
| firstInitObj.xCenter = 25; |
| firstInitObj.yCenter = 25; |
| |
| var firstCircle:Circle = new Circle(firstInitObj); |
| addChild(firstCircle); |
| firstCircle.x = 50; |
| firstCircle.y = 50; |
| |
| var secondInitObj:Object = {bgColor:0xCCCCCC, radius:50, xCenter:50, yCenter:50}; |
| |
| var secondCircle:Circle = new Circle(secondInitObj); |
| addChild(secondCircle); |
| secondCircle.x = 100; |
| secondCircle.y = 100; |
| } |
| |
| } |
| } |
| |
| import flash.display.Shape; |
| |
| class Circle extends Shape { |
| public var bgColor:Number = 0xFFFFFF; |
| public var radius:Number = 0; |
| public var xCenter:Number = 0; |
| public var yCenter:Number = 0; |
| |
| public function Circle(initObj:Object) { |
| for(var i:String in initObj) { |
| this[i] = initObj[i]; |
| } |
| draw(); |
| } |
| |
| public function draw():void { |
| graphics.beginFill(bgColor); |
| graphics.drawCircle(xCenter, yCenter, radius); |
| graphics.endFill(); |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#Object/prototype" class="- topic/link "><linktext class="- topic/linktext ">prototype</linktext></link></related-links><apiConstructor id="Object:Object" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Object</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein Object-Objekt und speichert eine Referenz auf die Konstruktormethode in der constructor-Eigenschaft des Objekts.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein Object-Objekt und speichert eine Referenz auf die Konstruktormethode in der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph> des Objekts. |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="Object:AS3:hasOwnProperty" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasOwnProperty</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><category class="- topic/category ">Method |
| </category></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn die Eigenschaft beim Zielobjekt durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph> angegeben wird, lautet dieser Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Eigenschaft des Objekts. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. Diese Methode gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn das Zielobjekt eine Eigenschaft aufweist, die dem String entspricht, der durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph> festgelegt ist; andernfalls gibt sie <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurück. Bei den folgenden Eigenschaften gibt diese Methode für Objekte den Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, die Instanzen einer Klasse sind (im Gegensatz zu Klassenobjekten): |
| <ul class="- topic/ul "><li class="- topic/li ">Feste Instanzeigenschaften: Variablen, Konstanten oder Methoden, die von der Objektklasse definiert und nicht statisch sind;</li><li class="- topic/li ">Geerbte feste Instanzeigenschaften: Variablen, Konstanten oder Methoden, die von der Objektklasse geerbt sind;</li><li class="- topic/li ">Dynamische Eigenschaften: Eigenschaften, die zu einem Objekt hinzugefügt werden, nachdem es instanziiert ist (also außerhalb seiner Klassendefinition). Damit Sie dynamische Eigenschaften hinzufügen können, muss die Klasse, die das Objekt definiert, mit dem Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">dynamic</codeph> deklariert worden sein.</li></ul> |
| <p class="- topic/p ">Bei den folgenden Eigenschaften gibt diese Methode für solche Objekte den Wert <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurück, die Instanzen einer Klasse sind:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Statische Eigenschaften: Variablen, Konstanten oder Methoden, die in der Klasse, die das Objekt definiert, oder einer übergeordneten Klasse mit dem Schlüsselwort „static“ definiert worden sind;</li><li class="- topic/li ">Prototypeigenschaften: Eigenschaften, die für ein Prototypobjekt definiert wurden, das Teil der Prototypkette des Objekts ist. In ActionScript 3.0 wird die Prototypkette nicht für die Klassenvererbung eingesetzt, existiert aber weiterhin als alternative Vererbungsform. So kann beispielsweise eine Instanz der Array-Klasse auf die Methode <codeph class="+ topic/ph pr-d/codeph ">valueOf()</codeph> zugreifen, weil sie in <codeph class="+ topic/ph pr-d/codeph ">Object.prototype</codeph> existiert, was wiederum Teil der Prototypkette der Array-Klasse ist. Obwohl Sie <codeph class="+ topic/ph pr-d/codeph ">valueOf()</codeph> für eine Array-Instanz verwenden können ist der Wert von <codeph class="+ topic/ph pr-d/codeph ">hasOwnProperty("valueOf")</codeph> für diese Instanz <codeph class="+ topic/ph pr-d/codeph ">false</codeph>.</li></ul> |
| |
| <p class="- topic/p ">ActionScript 3.0 besitzt auch Klassenobjekte, die direkte Repräsentationen von Klassendefinitionen darstellen. Wird die Methode <codeph class="+ topic/ph pr-d/codeph ">hasOwnProperty()</codeph> für Klassenobjekte aufgerufen, gibt sie nur dann den Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn eine Eigenschaft eine statische Eigenschaft ist, die für das betreffende Klassenobjekt definiert worden ist. Wenn Sie beispielsweise eine Unterklasse von Array mit dem Namen „CustomArray“ erstellen und in CustomArray eine statische Eigenschaft mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">foo</codeph> definieren, gibt ein Aufruf von <codeph class="+ topic/ph pr-d/codeph ">CustomArray.hasOwnProperty("foo")</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück. Für die statische Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">DESCENDING</codeph> hingegen, die in der Array-Klasse definiert wurde, gibt ein Aufruf von <codeph class="+ topic/ph pr-d/codeph ">CustomArray.hasOwnProperty("DESCENDING")</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurück.</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">override</codeph> verwenden. So implementiert eine Unterklasse von Object beispielsweise <codeph class="+ topic/ph pr-d/codeph ">function hasOwnProperty():Boolean</codeph> anstatt die Basisklasse per „override“ außer Kraft zu setzen.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Object:AS3:isPrototypeOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">isPrototypeOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn sich das Objekt in der Prototypkette des Objekts befindet, das vom Parameter <codeph class="+ topic/ph pr-d/codeph ">theClass</codeph> angegeben wird, lautet der Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">theClass</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Klasse, auf die das angegebene Objekt verweisen kann. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. Diese Methode gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn sich das Objekt in der Prototypkette des Objekts befindet, das vom Parameter <codeph class="+ topic/ph pr-d/codeph ">theClass</codeph> angegeben wird. Die Methode gibt <codeph class="+ topic/ph pr-d/codeph ">false</codeph> nicht nur dann zurück, wenn das Zielobjekt in der Prototypkette des <codeph class="+ topic/ph pr-d/codeph ">theClass</codeph>-Objekts fehlt, sondern auch dann, wenn der <codeph class="+ topic/ph pr-d/codeph ">theClass</codeph>-Parameter kein Objekt ist. |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">override</codeph> verwenden. So implementiert eine Unterklasse von Object beispielsweise <codeph class="+ topic/ph pr-d/codeph ">function isPrototypeOf():Boolean</codeph> anstatt die Basisklasse per „override“ außer Kraft zu setzen.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Object:AS3:propertyIsEnumerable" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">propertyIsEnumerable</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following example creates a generic object, adds a property to the object, then checks whether the object is enumerable. By way of contrast, the example also shows that a built-in property, the <code>Array.length</code> property, is not enumerable. |
| <listing> |
| var myObj:Object = new Object(); |
| myObj.prop1 = "hello"; |
| trace(myObj.propertyIsEnumerable("prop1")); // true |
| |
| var myArray = new Array(); |
| trace(myArray.propertyIsEnumerable("length")); // false |
| </listing> |
| |
| </maelexample></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn die durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph> angegebene Eigenschaft durchlaufen werden kann, lautet dieser Wert<codeph class="+ topic/ph pr-d/codeph ">true</codeph>; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Eigenschaft des Objekts. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. Wenn <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, ist die Eigenschaft vorhanden und kann in einer <codeph class="+ topic/ph pr-d/codeph ">for..in</codeph>-Schleife durchlaufen werden. Die Eigenschaft muss im Zielobjekt vorhanden sein, da diese Methode nicht die Prototypkette des Zielobjekts prüft. |
| |
| <p class="- topic/p ">Eigenschaften, die Sie erstellen, können durchlaufen werden, integrierte Eigenschaften können jedoch im Allgemeinen nicht durchlaufen werden.</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">override</codeph> verwenden. So implementiert eine Unterklasse von Object beispielsweise <codeph class="+ topic/ph pr-d/codeph ">function propertyIsEnumerable():Boolean</codeph> anstatt die Basisklasse per „override“ außer Kraft zu setzen.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Object:setPropertyIsEnumerable" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setPropertyIsEnumerable</apiName><shortdesc class="- topic/shortdesc "> |
| Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Eigenschaft des Objekts. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">isEnum</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">true</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc "> Ist eine dynamische Eigenschaft auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph> gesetzt, kommt sie in <codeph class="+ topic/ph pr-d/codeph ">for..in</codeph>-Schleifen nicht vor, und die Methode <codeph class="+ topic/ph pr-d/codeph ">propertyIsEnumerable()</codeph> gibt <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurück. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. Die Eigenschaft muss im Zielobjekt vorhanden sein, da diese Methode nicht die Prototypkette des Zielobjekts prüft. |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Object/propertyIsEnumerable()" class="- topic/link "><linktext class="- topic/linktext ">propertyIsEnumerable()</linktext></link></related-links></apiOperation><apiOperation id="Object:toLocaleString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">object, object.tolocalestring, tolocalestring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Stringdarstellung dieses Objekts, lokalen Konventionen entsprechend formatiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. |
| |
| <p class="- topic/p ">Die Standardimplementierung dieser Methode führt keine gebietsschemaspezifische Formatierung aus und gibt denselben String wie<codeph class="+ topic/ph pr-d/codeph ">toString</codeph> zurück. Unterklassen sollten ggf. ihre eigenen, das Gebietsschema berücksichtigenden Implementierungen bereitstellen.</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">override</codeph> verwenden. So implementiert eine Unterklasse von Object beispielsweise <codeph class="+ topic/ph pr-d/codeph ">function toLocaleString():String</codeph>, anstatt die Basisklasse per „override“ außer Kraft zu setzen.</p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Object/toString()" class="- topic/link "><linktext class="- topic/linktext ">Object.toString()</linktext></link></related-links></apiOperation><apiOperation id="Object:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das angegebene Objekt als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">object, object.tostring, tostring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das angegebene Objekt als String zurück. |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">override</codeph> verwenden. So implementiert eine Unterklasse von Object beispielsweise <codeph class="+ topic/ph pr-d/codeph ">function toString():String</codeph> anstatt die Basisklasse per „override“ außer Kraft zu setzen.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Object:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Grundwert des angegebenen Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">object, object.valueof, valueof |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Grundwert des angegebenen Objekts oder das Objekt selbst. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Grundwert des angegebenen Objekts zurück. Wenn das Objekt keinen Grundwert aufweist, wird das Objekt selbst zurückgegeben. |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Methoden der Object-Klasse werden für den Prototyp des Objekts dynamisch erstellt. Um diese Methode in eine Unterklasse von Object umzudefinieren, sollten Sie nicht das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">override</codeph> verwenden. So implementiert eine Unterklasse von Object beispielsweise <codeph class="+ topic/ph pr-d/codeph ">function valueOf():Object</codeph> anstatt die Basisklasse per „override“ außer Kraft zu setzen.</p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Object/toString()" class="- topic/link "><linktext class="- topic/linktext ">Object.toString()</linktext></link></related-links></apiOperation><apiValue id="Object:constructor" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">constructor</apiName><shortdesc class="- topic/shortdesc "> |
| Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Object, Object.constructor, constructor |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Object</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. Ist ein Objekt eine Instanz einer Klasse, enthält die <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft einen Verweis auf das Klassenobjekt. Wird ein Objekt mit einer Konstruktorfunktion erstellt, enthält die <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft einen Verweis auf die Konstruktorfunktion. Verwechseln Sie eine Konstruktorfunktion jedoch nicht mit den Konstruktormethoden einer Klasse. Eine Konstruktorfunktion ist ein Function-Objekt, das zum Erstellen von Objekten verwendet wird, und stellt eine Alternative dar zum Verwenden des Schlüsselworts <codeph class="+ topic/ph pr-d/codeph ">class</codeph> für das Definieren einer Klasse. |
| |
| <p class="- topic/p ">Wenn Sie eine Klasse mithilfe des Schlüsselworts <codeph class="+ topic/ph pr-d/codeph ">class</codeph> definieren, wird das Prototypobjekt der Klasse einer Eigenschaft mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph> zugewiesen, die einen Verweis auf das Klassenobjekt enthält. Eine Instanz der Klasse erbt diese Eigenschaft von dem Prototypobjekt. Der folgende Code erstellt beispielsweise eine neue Klasse, <codeph class="+ topic/ph pr-d/codeph ">A</codeph>, sowie eine Klasseninstanz mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myA</codeph>:</p> |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| dynamic class A {} |
| trace(A.prototype.constructor); // [class A] |
| trace(A.prototype.constructor == A); // true |
| var myA:A = new A(); |
| trace(myA.constructor == A); // true</codeblock> |
| |
| <p class="- topic/p ">Fortgeschrittene Benutzer verwenden vielleicht anstelle des Schlüsselworts <codeph class="+ topic/ph pr-d/codeph ">function</codeph> lieber das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">class</codeph>, um ein Function-Objekt zu definieren, das als Vorlage für die Erstellung von Objekten eingesetzt werden kann. Eine solche Funktion nennt man eine Konstruktorfunktion, da sie zusammen mit dem Operator <codeph class="+ topic/ph pr-d/codeph ">new</codeph> verwendet werden kann, um Objekte zu erstellen. Wenn Sie eine Konstruktorfunktion mithilfe des Schlüsselworts <codeph class="+ topic/ph pr-d/codeph ">function</codeph> definieren, wird das Prototypobjekt der Klasse einer Eigenschaft mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph> zugewiesen, die einen Verweis auf die Konstruktorfunktion enthält. Wenn Sie die Konstruktorfunktion verwenden, um ein Objekt zu erstellen, erbt das Objekt die <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft vom Prototypobjekt der Konstruktorfunktion. Der folgende Code erstellt beispielsweise eine neue Konstruktorfunktion, <codeph class="+ topic/ph pr-d/codeph ">f</codeph>, sowie ein Objekt mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myF</codeph>:</p> |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| function f() {} |
| trace(f.prototype.constructor); // function Function() {} |
| trace(f.prototype.constructor == f); // true |
| var myF = new f(); |
| trace(myF.constructor == f); // true</codeblock> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis</b>: Die <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft ist änderbar, d. h., der Benutzercode kann ihren Wert durch eine Zuweisungsanweisung ändern. Es wird nicht empfohlen, den Wert der <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft zu ändern, doch wenn Sie Code schreiben, der von dem Wert der <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft abhängig ist, sollten Sie sicherstellen, dass der Wert nicht zurückgesetzt wird. Der Wert kann nur geändert werden, wenn über das Prototypobjekt auf die Eigenschaft zugegriffen wird (z. B. <codeph class="+ topic/ph pr-d/codeph ">className.prototype.constructor</codeph>).</p> |
| <p class="- topic/p ">Wenn Sie auf die <codeph class="+ topic/ph pr-d/codeph ">constructor</codeph>-Eigenschaft zugreifen und sie im Strict-Modus kompilieren, erhalten Sie einen Fehler beim Kompilieren, da die Konstruktoreigenschaft vom Prototypobjekt abhängt, das eine Laufzeiteinheit ist. Wenn Sie den Standardmodus verwenden oder wenn die Klassenbeschreibung „dynamic“ festlegt, wird der Code ausgeführt, ohne einen Fehler zu generieren.</p> |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#Class" class="- topic/link "><linktext class="- topic/linktext ">Klasse</linktext></link><link href="#Function" class="- topic/link "><linktext class="- topic/linktext ">Funktion</linktext></link><link href="#Object/prototype" class="- topic/link "><linktext class="- topic/linktext ">prototype</linktext></link></related-links></apiValue><apiValue id="Object:prototype" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">prototype</apiName><shortdesc class="- topic/shortdesc "> |
| Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><maelexample>The following example creates a class named Shape and a subclass of Shape named Circle. |
| <listing version="2.0"> |
| // Shape class defined in external file named Shape.as |
| class Shape { |
| function Shape() {} |
| } |
| |
| // Circle class defined in external file named Circle.as |
| class Circle extends Shape{ |
| function Circle() {} |
| } |
| </listing> |
| The Circle class can be used to create two instances of Circle: |
| <listing version="2.0"> |
| var oneCircle:Circle = new Circle(); |
| var twoCircle:Circle = new Circle(); |
| </listing> |
| The following trace statement shows that the <code>prototype</code> property of the Circle class points to its superclass Shape. The identifier <code>Shape</code> refers to the constructor function of the Shape class. |
| <listing version="2.0"> |
| trace(Circle.prototype.constructor == Shape); // true |
| </listing> |
| The following trace statement shows how you can use the <code>prototype</code> property and the <code>__proto__</code> property together to move two levels up the inheritance hierarchy (or prototype chain). The <code>Circle.prototype.__proto__</code> property contains a reference to the superclass of the Shape class. |
| <listing version="2.0"> |
| trace(Circle.prototype.__proto__ == Shape.prototype); // true |
| </listing> |
| |
| |
| </maelexample></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Object</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts. Die <codeph class="+ topic/ph pr-d/codeph ">prototype</codeph>-Eigenschaft wird automatisch erstellt und an die erstellten Klassen oder Funktionsobjekte angehängt. Diese Eigenschaft ist insofern statisch, als sie spezifisch für die Klasse oder Funktion gilt, die Sie erstellen. Wenn Sie beispielsweise eine benutzerdefinierte Klasse erstellen, wird der Wert der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">prototype</codeph> von allen Instanzen der Klasse verwendet und ist nur als Klasseneigenschaft zugänglich. Instanzen Ihrer Klasse können die <codeph class="+ topic/ph pr-d/codeph ">prototype</codeph>-Eigenschaft nicht direkt erreichen. |
| |
| <p class="- topic/p ">Das Prototypobjekt einer Klasse ist eine spezielle Instanz dieser Klasse, die eine Funktionalität bereitstellt, durch die ein Status von allen Instanzen einer Klasse genutzt werden kann. Wenn während der Laufzeit für eine Klasseninstanz eine bestimmte Eigenschaft nicht gefunden wird, wird das Delegate-Objekt, das identisch ist mit dem Klassenprototypobjekt, auf die Eigenschaft hin überprüft. Enthält das Prototypobjekt die Eigenschaft auch nicht, wird der Vorgang fortgesetzt, indem das Delegate-Objekt des Prototypobjekts in der nächsthöheren Hierarchieebene sucht, bis die Flash-Laufzeitumgebung die Eigenschaft findet. </p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> In ActionScript 3.0 ist die Prototypvererbung nicht die primäre Vererbungsart. Vielmehr ist die Klassenvererbung, die die Vererbung fester Klassen in Klassendefinitionen unterbringt, die primäre Vererbungsart in ActionScript 3.0.</p> |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:URIError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">URIError</apiName><shortdesc class="- topic/shortdesc "> |
| Eine URIError-Ausnahme wird ausgelöst, wenn eine der globalen Funktionen für die URI-Verarbeitung auf eine Weise eingesetzt wird, die mit ihrer Definition nicht kompatibel ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, URIError |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine URIError-Ausnahme wird ausgelöst, wenn eine der globalen Funktionen für die URI-Verarbeitung auf eine Weise eingesetzt wird, die mit ihrer Definition nicht kompatibel ist. Diese Ausnahme wird ausgelöste, wenn ein ungültiger URI für eine Funktion angegeben wird, die einen gültigen URI erwartet, wie z. B. die Methode <codeph class="+ topic/ph pr-d/codeph ">Socket.connect()</codeph>. |
| |
| |
| </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="flash.net.xml#Socket/connect()" class="- topic/link "><linktext class="- topic/linktext ">flash.net.Socket.connect()</linktext></link></related-links><apiConstructor id="URIError:URIError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">URIError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues URIError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die mit dem URIError-Objekt verbundene Meldung. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues URIError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:SecurityError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SecurityError</apiName><shortdesc class="- topic/shortdesc "> |
| Die SecurityError-Klasse wird ausgelöst, wenn irgendeine Art von Sicherheitsverletzung eintritt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, SecurityError |
| |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Ausnahme <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph> wird ausgelöst, wenn irgendeine Art von Sicherheitsverletzung eintritt. |
| <p class="- topic/p "> |
| Beispiele für Sicherheitsfehler:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Es findet ein nicht autorisierter Zugriff auf eine Eigenschaft oder ein nicht autorisierter Aufruf einer Methode statt, über die Grenzen einer Sicherheits-Sandbox hinweg.</li><li class="- topic/li ">Es wurde versucht, auf eine URL-Adresse zuzugreifen die von der Sicherheits-Sandbox nicht zugelassen ist.</li><li class="- topic/li ">Es wurde versucht, eine Socketverbindung zu einer nicht autorisierten Portnummer herzustellen, z. B. zu einem Port mit einer höheren Nummer als 65535.</li><li class="- topic/li ">Es wurde versucht, auf die Kamera oder das Mikrofon eines Benutzers zuzugreifen, und die Zugriffsanforderung wurde vom Benutzer abgelehnt.</li></ul> |
| |
| </apiDesc><example conref="examples\SecurityErrorExample.as" class="- topic/example "> Dieses Beispiel veranschaulicht, wie <codeph class="+ topic/ph pr-d/codeph ">SecurityError</codeph>-Fehler erzeugt und in einer <codeph class="+ topic/ph pr-d/codeph ">try...catch</codeph>-Anweisung verarbeitet werden kann, indem versucht wird, eine Verbindung zu einem Port mit einer höheren Nummer als der maximal zulässigen herzustellen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.net.Socket; |
| |
| public class SecurityErrorExample extends Sprite { |
| |
| public function SecurityErrorExample() { |
| try { |
| var host:String = "www.[yourDomain].com"; |
| var socket:Socket = new Socket(); |
| socket.connect(host, 65536); |
| } |
| catch(e:SecurityError) { |
| trace(e); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><apiConstructor id="SecurityError:SecurityError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">SecurityError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues SecurityError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues SecurityError-Objekt. |
| |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:ReferenceError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">ReferenceError</apiName><shortdesc class="- topic/shortdesc "> |
| Beim Versuch, auf ein versiegeltes (nicht dynamisches) Objekt zu verweisen, wird eine ReferenceError-Ausnahme ausgelöst.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, ReferenceError |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Beim Versuch, auf ein versiegeltes (nicht dynamisches) Objekt zu verweisen, wird eine ReferenceError-Ausnahme ausgelöst. Verweise auf nicht definierte Variablen resultieren in ReferenceError-Ausnahmen, die Sie über mögliche Fehler informieren und bei der Fehlersuche im Anwendungscode unterstützen sollen. |
| <p class="- topic/p ">Allerdings ist es möglich, auf nicht definierte Eigenschaften einer dynamischen Klasse zu verweisen ohne eine ReferenceError-Ausnahme zu verursachen. Weitere Informationen hierzu finden Sie in der Beschreibung des Schlüsselworts <codeph class="+ topic/ph pr-d/codeph ">dynamic</codeph>.</p> |
| |
| </apiDesc><example conref="examples\ReferenceErrorExample.as" class="- topic/example "> Dieses Beispiel veranschaulicht, wie eine <codeph class="+ topic/ph pr-d/codeph ">ReferenceError</codeph>-Ausnahme erzeugt und in einer<codeph class="+ topic/ph pr-d/codeph ">try..catch</codeph>-Anweisung verarbeitet wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ReferenceErrorExample extends Sprite { |
| |
| public function ReferenceErrorExample() { |
| try { |
| this["someMember"] = true; |
| } |
| catch(e:ReferenceError) { |
| trace(e); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="statements.html#dynamic" class="- topic/link "><linktext class="- topic/linktext ">dynamic-Schlüsselwort</linktext></link></related-links><apiConstructor id="ReferenceError:ReferenceError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">ReferenceError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues ReferenceError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die mit dem ReferenceError-Objekt verbundene Meldung. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues ReferenceError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:RangeError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">RangeError</apiName><shortdesc class="- topic/shortdesc "> |
| Es wird eine RangeError-Ausnahme ausgelöst, wenn ein numerischer Wert außerhalb des akzeptierbaren Bereichs liegt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, RangeError |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Es wird eine RangeError-Ausnahme ausgelöst, wenn ein numerischer Wert außerhalb des akzeptierbaren Bereichs liegt. Wenn Sie mit Arrays arbeiten und auf die Indexposition eines Arrays verweisen, die gar nicht existiert, wird eine RangeError-Ausnahme ausgelöst. Bei Verwendung der Methoden <codeph class="+ topic/ph pr-d/codeph ">Number.toExponential()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">Number.toPrecision()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Number.toFixed()</codeph> wird eine RangeError-Ausnahme ausgelöst, wenn sich die Argumente außerhalb des akzeptierbaren Zahlenbereichs befinden. Sie können <codeph class="+ topic/ph pr-d/codeph ">Number.toExponential()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">Number.toPrecision()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">Number.toFixed()</codeph> erweitern, um einen solchen RangeError-Fehler zu vermeiden. |
| <p product="flash" class="- topic/p ">Auch die folgenden Situationen können diese Ausnahme verursachen: |
| <ul class="- topic/ul "><li class="- topic/li ">Jede API einer Flash-Laufzeitumgebung, die eine Zahl für die Tiefe erwartet, wird mit einer unzulässigen Tiefennummer aufgerufen.</li><li class="- topic/li ">Jede API einer Flash-Laufzeitumgebung, die eine Zahl für die Bildposition erwartet, wird mit einer unzulässigen Bildnummer aufgerufen.</li><li class="- topic/li ">Jede API einer Flash-Laufzeitumgebung, die eine Zahl für die Ebenennummer erwartet, wird mit einer unzulässigen Ebenennummer aufgerufen.</li></ul> |
| </p> |
| </apiDesc><example conref="examples\RangeErrorExample.as" class="- topic/example "> Dieses Beispiel veranschaulicht, wie eine <codeph class="+ topic/ph pr-d/codeph ">RangeError</codeph>-Ausnahme erzeugt und in einer<codeph class="+ topic/ph pr-d/codeph ">try..catch</codeph>-Anweisung verarbeitet wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class RangeErrorExample extends Sprite { |
| |
| public function RangeErrorExample() { |
| var child:Sprite = new Sprite(); |
| try { |
| addChildAt(child, 1); |
| } |
| catch(e:RangeError) { |
| trace(e); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#Number/toExponential()" class="- topic/link "><linktext class="- topic/linktext ">Number.toExponential()</linktext></link><link href="#Number/toPrecision()" class="- topic/link "><linktext class="- topic/linktext ">Number.toPrecision()</linktext></link><link href="#Number/toFixed()" class="- topic/link "><linktext class="- topic/linktext ">Number.toFixed()</linktext></link></related-links><apiConstructor id="RangeError:RangeError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">RangeError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues RangeError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die mit dem RangeError-Objekt verbundene Meldung. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues RangeError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:int" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">int</apiName><shortdesc class="- topic/shortdesc "> |
| Die int-Klasse ermöglicht Ihnen die Arbeit mit einem Datentyp, der eine 32-Bit-Ganzzahl mit Vorzeichen repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">int object, int, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die int-Klasse ermöglicht Ihnen die Arbeit mit einem Datentyp, der eine 32-Bit-Ganzzahl mit Vorzeichen repräsentiert. Der von der int-Klasse repräsentierte Wertebereich liegt zwischen -2.147.483.648 (-2^31) und 2.147.483.647 (2^31-1). |
| <p class="- topic/p ">Die konstanten Eigenschaften der int-Klasse, <codeph class="+ topic/ph pr-d/codeph ">MAX_VALUE</codeph> <codeph class="+ topic/ph pr-d/codeph ">MIN_VALUE</codeph>, sind statisch, d. h., Sie können sie verwenden, ohne dass ein Objekt nötig ist. Somit ist kein Konstruktor erforderlich. Die Methoden sind allerdings nicht statisch, d. h., Sie benötigen ein Objekt, um sie zu verwenden. Sie können ein int-Objekt erstellen, indem Sie den int-Klassenkonstruktor verwenden oder eine Variable vom Typ int deklarieren und der Variable einen Literalwert zuweisen.</p> |
| <p class="- topic/p ">Der int-Datentyp ist nützlich für Schleifenzähler und andere Situationen, in denen keine Gleitkommazahl benötigt wird, und ähnelt dem int-Datentyp in Java und C++. Der Standardwert einer Variable vom Typ int lautet <codeph class="+ topic/ph pr-d/codeph ">0</codeph></p> |
| <p class="- topic/p ">Wenn Sie mit Zahlen arbeiten, die den Wert <codeph class="+ topic/ph pr-d/codeph ">int.MAX_VALUE</codeph> überschreiten, sollten Sie es in Betracht ziehen, den Datentyp Number zu verwenden. </p> |
| <p class="- topic/p ">Im folgenden Beispiel wird die Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> der int-Klasse aufgerufen, die den String <codeph class="+ topic/ph pr-d/codeph ">1234</codeph> zurückgibt: </p> |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myint:int = 1234; |
| myint.toString(); |
| </codeblock> |
| <p class="- topic/p ">Im folgenden Beispiel wird der Wert der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">MIN_VALUE</codeph> einer Variablen zugewiesen, die ohne den Konstruktor deklariert wurde:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| var smallest:int = int.MIN_VALUE; |
| </pre> |
| |
| </apiDesc><example conref="examples\IntExample.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">IntExample</codeph>-Klasse veranschaulicht, wie Sie mit int-Datentypen arbeiten und ihre Gültigkeit prüfen: |
| <ol class="- topic/ol "><li class="- topic/li ">Im Konstruktor werden zwei int-Variablen <codeph class="+ topic/ph pr-d/codeph ">a</codeph> und <codeph class="+ topic/ph pr-d/codeph ">b</codeph> deklariert.</li><li class="- topic/li ">Diese beiden int-Variablen werden mithilfe der Methode <codeph class="+ topic/ph pr-d/codeph ">addIntegers()</codeph> hinzugefügt.</li><li class="- topic/li ">Einer dritten int-Variablen <codeph class="+ topic/ph pr-d/codeph ">c</codeph> wird das Ergebnis von <codeph class="+ topic/ph pr-d/codeph ">parseInteger()</codeph> zugewiesen. Sie überprüft die Gültigkeit des ihr übergebenen Strings, um sicherzustellen, dass es sich um eine Ganzzahl im für int-Datentypen akzeptierbaren Zahlenbereich handelt. Ist dies der Fall, wird ein „int“ gleich der Ganzzahl des Strings zurückgegeben.</li><li class="- topic/li ">Die int-Variablen <codeph class="+ topic/ph pr-d/codeph ">a</codeph> und <codeph class="+ topic/ph pr-d/codeph ">c</codeph> werden mihilfe von <codeph class="+ topic/ph pr-d/codeph ">addIntegers()</codeph> hinzugefügt.</li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class IntExample extends Sprite { |
| public function IntExample() { |
| var a:int = 512; |
| var b:int = -128; |
| |
| trace(addIntegers(a, b)); // 384 |
| |
| var c:int = parseInteger("32"); |
| |
| trace(addIntegers(a, c)); // 544 |
| } |
| |
| public function addIntegers(a:int, b:int):int { |
| return a + b; |
| } |
| |
| public function parseInteger(str:String):int { |
| var num:Number = parseInt(str); |
| if(!isNaN(num) && num <= int.MAX_VALUE && num >= int.MIN_VALUE) { |
| return int(num); |
| } |
| |
| return 0; |
| } |
| |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="uint.html" class="- topic/link "><linktext class="- topic/linktext ">uint</linktext></link><link href="Number.html" class="- topic/link "><linktext class="- topic/linktext ">Number</linktext></link></related-links><apiConstructor id="int:int" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">int</apiName><shortdesc class="- topic/shortdesc "> |
| Konstruktor; erstellt ein neues int-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">new number, constructor |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">num</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der numerische Wert des zu erstellenden int-Objekts oder ein Wert, der in eine Zahl umgewandelt werden soll. Wenn <codeph class="+ topic/ph pr-d/codeph ">value</codeph> nicht angegeben wird, gilt der Standardwert 0. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konstruktor; erstellt ein neues int-Objekt. Wenn Sie mit <codeph class="+ topic/ph pr-d/codeph ">int.toString()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">int.valueOf()</codeph> arbeiten, müssen Sie den int-Konstruktor verwenden. Wenn Sie mit den Eigenschaften eines int-Objekts arbeiten, verwenden Sie keinen Konstruktor. Der <codeph class="+ topic/ph pr-d/codeph ">new int</codeph>-Konstruktor dient hauptsächlich als Platzhalter. Ein int-Objekt entspricht nicht der Funktion <codeph class="+ topic/ph pr-d/codeph ">int()</codeph>, die einen Parameter in einen Grundwert umwandelt. |
| |
| </apiDesc><example class="- topic/example ">Der folgende Code erstellt neue int-Objekte: |
| <pre xml:space="preserve" class="- topic/pre "> |
| var n1:int = new int(3.4); |
| var n2:int = new int(-10); |
| </pre> |
| |
| |
| </example></apiConstructorDetail><related-links class="- topic/related-links "><link href="#int/toString()" class="- topic/link "><linktext class="- topic/linktext ">int.toString()</linktext></link><link href="#int/valueOf()" class="- topic/link "><linktext class="- topic/linktext ">int.valueOf()</linktext></link></related-links></apiConstructor><apiOperation id="int:AS3:toExponential" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toExponential</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Exponentialschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> nicht zwischen 0 und 20 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fractionDigits</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Exponentialschreibweise als String zurück. Der String enthält eine Ziffer vor der Dezimalstelle und bis zu 20 Nachkommastellen, gemäß der Angabe im Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph>. |
| </apiDesc><example conref="examples\Number.toExponential.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings in Exponentialschreibweise durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(2)</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 315003; |
| trace(num.toExponential(2)); // 3.15e+5 |
| |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="int:AS3:toFixed" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toFixed</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Festkommaschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> nicht zwischen 0 und 20 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fractionDigits</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Festkommaschreibweise als String zurück. Festkommaschreibweise bedeutet, dass der String eine bestimmte Anzahl an Nachkommastellen enthält, und zwar gemäß der Angabe im Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph>. Die zulässigen Werte für den Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> liegen zwischen 0 und 20. Wird ein Wert außerhalb dieses Bereichs angegeben, wird eine Ausnahme ausgelöst. |
| |
| </apiDesc><example conref="examples\Number.toFixed.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>, mit dem auf drei Dezimalstellen aufgerundet wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 7.31343; |
| trace(num.toFixed(3)); // 7.313 |
| </codeblock></example><example conref="examples\Number.toFixed.2.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(2)</codeph>, mit dem nachgestellte Nullen hinzugefügt werden. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 4; |
| trace(num.toFixed(2)); // 4.00 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="int:AS3:toPrecision" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toPrecision</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">precision</codeph> nicht zwischen 1 und 21 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">precision</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 1 und 21 (einschließlich), die die gewünschte Anzahl an Nachkommastellen für die Darstellung des Strings repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück. Der String enthält die im Parameter <codeph class="+ topic/ph pr-d/codeph ">precision</codeph> angegebene Anzahl an Ziffern. |
| </apiDesc><example conref="examples\Number.toPrecision.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>. Der String wird in Festkommaschreibweise zurückgegeben, da Exponentialschreibweise nicht erforderlich ist. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 31.570; |
| trace(num.toPrecision(3)); // 31.6 |
| </codeblock></example><example conref="examples\Number.toPrecision.2.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>. Der String wird in Exponentialschreibweise zurückgegeben, da die Anzahl an Stellen der sich ergebenden Zahl nicht ausreichen für die Festkommaschreibweise. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 4000; |
| trace(num.toPrecision(3)); // 4.00e+3 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="int:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das angegebene int-Objekt als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.tostring, tostring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">radix</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt die numerische Basis (von 2 bis 36) an, die bei der Umwandlung von Zahlen in Strings verwendet werden soll. Wenn Sie den Parameter <codeph class="+ topic/ph pr-d/codeph ">radix</codeph> nicht angeben, wird als Standardwert 10 verwendet. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das angegebene <codeph class="+ topic/ph pr-d/codeph ">int</codeph>-Objekt als String zurück. |
| |
| </apiDesc><example class="- topic/example ">Im folgenden Beispiel wird 2 und 8 für den <codeph class="+ topic/ph pr-d/codeph ">radix</codeph>-Parameter verwendet und eine Zeichenfolge ausgegeben, in der die entsprechende Angabe der Zahl 9 enthalten ist. |
| <pre xml:space="preserve" class="- topic/pre "> |
| var myint:int = new int(9); |
| trace(myint.toString(2)); // 1001 |
| trace(myint.toString(8)); // 11 |
| </pre> |
| <p class="- topic/p ">Das folgende Beispiel ergibt einen Hexadezimalwert.</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| var r:int = new int(250); |
| var g:int = new int(128); |
| var b:int = new int(114); |
| var rgb:String = "0x"+ r.toString(16)+g.toString(16)+b.toString(16); |
| trace(rgb); // 0xfa8072 |
| </pre> |
| |
| </example></apiOperationDetail></apiOperation><apiOperation id="int:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Grundwert des angegebenen int-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.valueof, valueof, value of |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein int-Wert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Grundwert des angegebenen int-Objekts zurück. |
| |
| </apiDesc><example class="- topic/example ">Das folgende Beispiel ergibt den Grundwert des <codeph class="+ topic/ph pr-d/codeph ">numSocks</codeph>-Objekts. |
| <pre xml:space="preserve" class="- topic/pre "> |
| var numSocks:int = new int(2); |
| trace(numSocks.valueOf()); // 2 |
| </pre> |
| |
| </example></apiOperationDetail></apiOperation><apiValue id="int:MAX_VALUE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">MAX_VALUE</apiName><shortdesc class="- topic/shortdesc "> |
| Die größte darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich 2.147.483.647.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">int, int.max_value, max_value, max value |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">2147483647</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die größte darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich 2.147.483.647. |
| |
| </apiDesc><example class="- topic/example ">Der folgende ActionScript-Code <ph outputclass="flashonly" class="- topic/ph ">zeigt</ph> <ph outputclass="flexonly" class="- topic/ph ">schreibt </ph>das größte und kleinste darstellbare „int“-Objekt <ph outputclass="flashonly" class="- topic/ph ">im Bedienfeld „Ausgabe“ an</ph><ph outputclass="flexonly" class="- topic/ph ">in die Protokolldatei</ph>: |
| <pre xml:space="preserve" class="- topic/pre "> |
| trace("int.MIN_VALUE = "+int.MIN_VALUE); |
| trace("int.MAX_VALUE = "+int.MAX_VALUE); |
| </pre> |
| <p class="- topic/p ">Mit diesem Code werden die folgenden Werte <ph outputclass="flexonly" class="- topic/ph ">protokolliert</ph><ph outputclass="flashonly" class="- topic/ph ">angezeigt</ph>: </p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| int.MIN_VALUE = -2147483648 |
| int.MAX_VALUE = 2147483647 |
| </pre> |
| |
| |
| </example></apiValueDetail></apiValue><apiValue id="int:MIN_VALUE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">MIN_VALUE</apiName><shortdesc class="- topic/shortdesc "> |
| Die kleinste darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich -2.147.483.648.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">int, int.min_value, min_value, min value |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">-2147483648</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die kleinste darstellbare vorzeichenbehaftete 32-Bit-Ganzzahl, nämlich -2.147.483.648. |
| |
| </apiDesc><example class="- topic/example ">Der folgende ActionScript-Code <ph outputclass="flashonly" class="- topic/ph ">zeigt </ph> <ph outputclass="flexonly" class="- topic/ph ">schreibt </ph>das größte und kleinste darstellbare „int“-Objekt <ph outputclass="flashonly" class="- topic/ph ">im Bedienfeld „Ausgabe“ an</ph><ph outputclass="flexonly" class="- topic/ph ">in die Protokolldatei</ph>: |
| <pre xml:space="preserve" class="- topic/pre "> |
| trace("int.MIN_VALUE = "+int.MIN_VALUE); |
| trace("int.MAX_VALUE = "+int.MAX_VALUE); |
| </pre> |
| <p class="- topic/p ">Mit diesem Code werden die folgenden Werte <ph outputclass="flexonly" class="- topic/ph ">protokolliert</ph><ph outputclass="flashonly" class="- topic/ph ">angezeigt</ph>: </p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| int.MIN_VALUE = -2147483648 |
| int.MAX_VALUE = 2147483647 |
| </pre> |
| |
| |
| </example></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:Number" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Number</apiName><shortdesc class="- topic/shortdesc "> |
| Ein Datentyp, der eine Gleitkommazahl nach IEEE -754 mit doppelter Genauigkeit repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number object, number, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Bei der Number-Klasse handelt es sich um ein einfaches Wrapper-Objekt für den <codeph class="+ topic/ph pr-d/codeph ">Number</codeph>-Datentyp. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein Datentyp, der eine Gleitkommazahl nach IEEE -754 mit doppelter Genauigkeit repräsentiert. Sie können Grundwerte manipulieren, indem Sie die der Number-Klasse zugeordneten Methoden und Eigenschaften verwenden. Diese Klasse ist mit der Number-Klasse in JavaScript identisch. |
| <p class="- topic/p ">Die Eigenschaften der Number-Klasse sind statisch, d. h., Sie können sie verwenden, ohne dass ein Objekt nötig ist. Somit ist kein Konstruktor erforderlich.</p> |
| <p class="- topic/p ">Der Datentyp Number hält sich an den IEEE-754-Standard (doppelt genau). </p> |
| <p class="- topic/p ">Der Datentyp Number ist nützlich, wenn Sie Gleitkommawerte verwenden müssen. Flash-Laufzeitumgebungen behandeln die Datentypen int und uint effektiver als Number, doch ist Number praktisch in Situationen, in denen der erforderliche Wertebereich den Wertebereich der Datentypen int und uint überschreitet. Die Number-Klasse kann zur Darstellung von Ganzzahlwerten verwendet werden, die weit über den gültigen Bereich der Datentypen int und uint hinausgehen. Der Datentyp Number kann bis zu 53 Bits verwenden, um ganzzahlige Werte darzustellen, im Gegensatz zu 32 Bits bei int und uint. Der Standardwert einer als Number eingegebenen Variable ist <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not a Number, keine Zahl).</p> |
| |
| </apiDesc><example conref="examples\NumberExample.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie eine Zahl mit sechs Nachkommastellen durch Abrunden auf eine Zahl mit zwei Nachkommastellen verkürzt wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| |
| public class NumberExample extends Sprite { |
| public function NumberExample() { |
| var num:Number = new Number(10.456345); |
| var str:String = num.toFixed(2); |
| trace(num); // 10.456345 |
| trace(str); // 10.46 |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="int.html" class="- topic/link "><linktext class="- topic/linktext ">int</linktext></link><link href="uint.html" class="- topic/link "><linktext class="- topic/linktext ">uint</linktext></link></related-links><apiConstructor id="Number:Number" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Number</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein Number-Objekt mit dem angegebenen Wert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">new number, constructor |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">num</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der numerische Wert der zu erstellenden Number-Instanz oder ein Wert, der in eine Zahl umgewandelt werden soll. Der Standardwert ist 0, wenn <codeph class="+ topic/ph pr-d/codeph ">num</codeph> nicht angegeben wird. Den Konstruktor ohne <codeph class="+ topic/ph pr-d/codeph ">num</codeph>-Parameter zu verwenden ist nicht dasselbe wie die Deklaration einer Variable vom Typ Number, ohne ihr einen Wert zuzuweisen (z. B. <codeph class="+ topic/ph pr-d/codeph ">var myNumber:Number</codeph>), wobei der Standardwert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> ist. Eine Zahl ohne zugewiesenen Wert ist nicht definiert und ist ein Äquivalent zu <codeph class="+ topic/ph pr-d/codeph ">new Number(undefined)</codeph>. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Erstellt ein Number-Objekt mit dem angegebenen Wert. |
| |
| </apiTipText></apiTipTexts></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein Number-Objekt mit dem angegebenen Wert. Dieser Konstruktor hat denselben Effekt wie die native public-Funktion <codeph class="+ topic/ph pr-d/codeph ">Number()</codeph>, mit der ein Objekt eines anderen Typs in einen numerischen Grundwert umgewandelt wird. |
| |
| </apiDesc></apiConstructorDetail><related-links class="- topic/related-links "><link href="#Number/toString()" class="- topic/link "><linktext class="- topic/linktext ">Number.toString()</linktext></link><link href="#Number/valueOf()" class="- topic/link "><linktext class="- topic/linktext ">Number.valueOf()</linktext></link></related-links></apiConstructor><apiOperation id="Number:AS3:toExponential" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toExponential</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Exponentialschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> nicht zwischen 0 und 20 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fractionDigits</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Exponentialschreibweise als String zurück. Der String enthält eine Ziffer vor der Dezimalstelle und bis zu 20 Nachkommastellen, gemäß der Angabe im Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph>. |
| </apiDesc><example conref="examples\Number.toExponential.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings in Exponentialschreibweise durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(2)</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 315003; |
| trace(num.toExponential(2)); // 3.15e+5 |
| |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Number:AS3:toFixed" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toFixed</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Festkommaschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> nicht zwischen 0 und 20 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fractionDigits</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Festkommaschreibweise als String zurück. Festkommaschreibweise bedeutet, dass der String eine bestimmte Anzahl an Nachkommastellen enthält, und zwar gemäß der Angabe im Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph>. Die zulässigen Werte für den Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> liegen zwischen 0 und 20. Wird ein Wert außerhalb dieses Bereichs angegeben, wird eine Ausnahme ausgelöst. |
| |
| </apiDesc><example conref="examples\Number.toFixed.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>, mit dem auf drei Dezimalstellen aufgerundet wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 7.31343; |
| trace(num.toFixed(3)); // 7.313 |
| </codeblock></example><example conref="examples\Number.toFixed.2.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(2)</codeph>, mit dem nachgestellte Nullen hinzugefügt werden. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 4; |
| trace(num.toFixed(2)); // 4.00 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Number:AS3:toPrecision" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toPrecision</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">precision</codeph> nicht zwischen 1 und 21 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">precision</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 1 und 21 (einschließlich), die die gewünschte Anzahl an Nachkommastellen für die Darstellung des Strings repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück. Der String enthält die im Parameter <codeph class="+ topic/ph pr-d/codeph ">precision</codeph> angegebene Anzahl an Ziffern. |
| </apiDesc><example conref="examples\Number.toPrecision.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>. Der String wird in Festkommaschreibweise zurückgegeben, da Exponentialschreibweise nicht erforderlich ist. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 31.570; |
| trace(num.toPrecision(3)); // 31.6 |
| </codeblock></example><example conref="examples\Number.toPrecision.2.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>. Der String wird in Exponentialschreibweise zurückgegeben, da die Anzahl an Stellen der sich ergebenden Zahl nicht ausreichen für die Festkommaschreibweise. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 4000; |
| trace(num.toPrecision(3)); // 4.00e+3 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="Number:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das angegebene Number-Objekt (myNumber) als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.tostring, tostring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die numerische Repräsentation des Number-Objekts als String. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">radix</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">10</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt die numerische Basis (von 2 bis 36) an, die bei der Umwandlung von Zahlen in Strings verwendet werden soll. Wenn Sie den Parameter <codeph class="+ topic/ph pr-d/codeph ">radix</codeph> nicht angeben, wird als Standardwert 10 verwendet. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt die Zahl als String zurück, wobei der angegebene radix-Parameter als numerische Basis verwendet wird. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das angegebene Number-Objekt (<codeph class="+ topic/ph pr-d/codeph "><i class="+ topic/ph hi-d/i ">myNumber</i></codeph>) als Zeichenfolge zurück. Ist der Wert des Number-Objekts eine Dezimalzahl ohne führende Null (z. B. <codeph class="+ topic/ph pr-d/codeph ">.4</codeph>), fügt <codeph class="+ topic/ph pr-d/codeph ">Number.toString()</codeph> die führende Null hinzu (<codeph class="+ topic/ph pr-d/codeph ">0.4</codeph>). |
| |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Number:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Grundwerttyp des angegebenen Number-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.valueof, valueof, value of |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Grundwert dieses Number-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Grundwerttyp des angegebenen Number-Objekts zurück. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Grundwerttyp des angegebenen Number-Objekts zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="Number:MAX_VALUE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">MAX_VALUE</apiName><shortdesc class="- topic/shortdesc "> |
| Die größte darstellbare Zahl (IEEE-754, doppelt genau).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.max_value, max_value, max value |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Die größte darstellbare Zahl (IEEE-754, doppelt genau). |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die größte darstellbare Zahl (IEEE-754, doppelt genau). Diese Zahl lautet ungefähr 1.79E+308. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Number:MIN_VALUE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">MIN_VALUE</apiName><shortdesc class="- topic/shortdesc "> |
| Die kleinste darstellbare Zahl (IEEE-754, doppelt genau).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.min_value, min_value, min value |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Die kleinste darstellbare Zahl (doppeltgenau nach IEEE-754). |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die kleinste darstellbare Zahl (IEEE-754, doppelt genau). Diese Zahl beträgt ungefähr 5E-324. Die kleinste darstellbare Zahl insgesamt ist <codeph class="+ topic/ph pr-d/codeph ">-Number.MAX_VALUE</codeph>. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Number:NEGATIVE_INFINITY" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">NEGATIVE_INFINITY</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den IEEE-754-Wert an, der für negative Unendlichkeit steht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.negative_infinity, negative_infinity, negative infinity, infinity |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den IEEE-754-Wert an, der für negative Unendlichkeit steht. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den IEEE-754-Wert an, der für negative Unendlichkeit steht. Der Wert dieser Eigenschaft ist identisch mit dem der Konstanten <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph>. |
| <p class="- topic/p "> |
| Negative Unendlichkeit ist ein spezieller numerischer Wert, der zurückgegeben wird, wenn eine mathematische Operation oder Funktion einen negativen Wert zurückgibt, der außerhalb des darstellbaren Bereichs liegt. |
| </p> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Number:NaN" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">NaN</apiName><shortdesc class="- topic/shortdesc "> |
| Der Wert für NaN (Not A Number, keine Zahl) nach IEEE-754.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.nan, nan, not a number |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Der Wert für NaN (Not A Number, keine Zahl) nach IEEE-754. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der Wert für <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not A Number, keine Zahl) nach IEEE-754. |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="package.html#isNaN()" class="- topic/link "><linktext class="- topic/linktext ">isNaN() globale Funktion</linktext></link></related-links></apiValue><apiValue id="Number:POSITIVE_INFINITY" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">POSITIVE_INFINITY</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den IEEE-754-Wert an, der für positive Unendlichkeit steht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.positive_infinity, positive_infinity, positive infinity, infinity |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den IEEE-754-Wert an, der für positive Unendlichkeit steht. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den IEEE-754-Wert an, der für positive Unendlichkeit steht. Der Wert dieser Eigenschaft ist identisch mit dem der Konstanten <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph>. |
| <p class="- topic/p "> |
| Positive Unendlichkeit ist ein spezieller numerischer Wert, der zurückgegeben wird, wenn eine mathematische Operation oder Funktion einen positiven Wert zurückgibt, der außerhalb des darstellbaren Bereichs liegt. |
| </p> |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:DefinitionError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">DefinitionError</apiName><shortdesc class="- topic/shortdesc "> |
| Die DefinitionError-Klasse repräsentiert einen Fehler, der auftritt, wenn der Benutzercode versucht, einen Bezeichner zu definieren, der bereits definiert wurde.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid> |
| |
| </helpid></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein DefinitionError-Fehler wird ausgelöst, wenn der Code versucht eine Klasse, Schnittstelle oder Funktion neu zu definieren. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die DefinitionError-Klasse repräsentiert einen Fehler, der auftritt, wenn der Benutzercode versucht, einen Bezeichner zu definieren, der bereits definiert wurde. Dieser Fehler tritt häufig beim neu Definieren von Klassen, Schnittstellen und Funktionen auf. |
| |
| </apiDesc></apiClassifierDetail><apiConstructor id="DefinitionError:DefinitionError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">DefinitionError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues DefinitionError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues DefinitionError-Objekt. |
| |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:Function" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Function</apiName><shortdesc class="- topic/shortdesc "> |
| Eine Funktion ist die grundlegende Codeeinheit, die in ActionScript aufgerufen werden kann.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Function, Function object, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Die Function-Klasse wird für integrierte Funktionen verwendet. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine Funktion ist die grundlegende Codeeinheit, die in ActionScript aufgerufen werden kann. Sowohl benutzerdefinierte als auch integrierte Funktionen in ActionScript werden durch Function-Objekte repräsentiert, die Instanzen der Function-Klasse sind. |
| <p class="- topic/p ">Die Methoden einer Klasse unterscheiden sich etwas von Function-Objekten. Im Gegensatz zu einem gewöhnlichen Function-Objekt ist eine Methode eng an das zugehörige Klassenobjekt gebunden. Daher besitzt eine Methode oder Eigenschaft eine Definition, die von allen Instanzen derselben Klasse genutzt wird. Methoden können aus einer Instanz extrahiert werden, und werden als „gebundene“ Methoden bezeichnet (da sie die Verknüpfung zur Originalinstanz beibehalten). Bei einer gebundenen Methode zeigt das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">this</codeph> auf das Objekt, das ursprünglich die Methode implementiert hat. Bei einer Funktion zeigt <codeph class="+ topic/ph pr-d/codeph ">this</codeph> auf das Objekt, das zum Zeitpunkt des Funktionsaufruf verknüpft war.</p> |
| |
| |
| </apiDesc><example conref="examples\FunctionExample.as" class="- topic/example "> Im folgenden Beispiel werden mithilfe der Klassen <codeph class="+ topic/ph pr-d/codeph ">FunctionExample</codeph>, <codeph class="+ topic/ph pr-d/codeph ">SimpleCollection</codeph>, <codeph class="+ topic/ph pr-d/codeph ">EventBroadcaster</codeph> und <codeph class="+ topic/ph pr-d/codeph ">EventListener</codeph> verschiedene Verwendungsweisen von Funktionen in ActionScript veranschaulicht. Dies wird in den folgenden Schritten erreicht: |
| <ol class="- topic/ol "><li class="- topic/li ">Mit dem Konstruktor für <codeph class="+ topic/ph pr-d/codeph ">FunctionExample</codeph> wird eine lokale Variable mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">simpleColl</codeph> erstellt. Sie wird mit einem Array aus Ganzzahlen gefüllt, die zwischen den Werten <codeph class="+ topic/ph pr-d/codeph ">1</codeph> und <codeph class="+ topic/ph pr-d/codeph ">8</codeph> liegen. </li><li class="- topic/li ">Das <codeph class="+ topic/ph pr-d/codeph ">simpleColl</codeph>-Objekt wird mithilfe von <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph> gedruckt.</li><li class="- topic/li ">Ein EventListener-Objekt, <codeph class="+ topic/ph pr-d/codeph ">listener</codeph>, wird zu <codeph class="+ topic/ph pr-d/codeph ">simpleColl</codeph> hinzugefügt.</li><li class="- topic/li ">Beim Aufrufen der Funktionen <codeph class="+ topic/ph pr-d/codeph ">insert()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">remove()</codeph> reagiert der Listener auf ihre Ereignisse.</li><li class="- topic/li ">Es wird ein zweites SimpleCollection-Objekt mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">greaterThanFourColl</codeph> erstellt.</li><li class="- topic/li ">Dem <codeph class="+ topic/ph pr-d/codeph ">greaterThanFourColl</codeph>-Objekt wird das Ergebnis von <codeph class="+ topic/ph pr-d/codeph ">simpleColl.select()</codeph> zusammen mit dem Argument <codeph class="+ topic/ph pr-d/codeph ">4</codeph> und einer anonymen Funktion zugewiesen. Bei der Auswahlmethode des SimpleCollection-Objekts handelt es sich um einen internen Iterator, der den anonymen Funktionsparameter als Block verwendet.</li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class FunctionExample extends Sprite { |
| public function FunctionExample() { |
| var simpleColl:SimpleCollection; |
| simpleColl = new SimpleCollection(0, 1, 2, 3, 4, 5, 6, 7, 8); |
| trace(simpleColl); // 0, 1, 2, 3, 4, 5, 6, 7, 8 |
| |
| var listener:EventListener = new EventListener(); |
| simpleColl.addListener(listener); |
| simpleColl.insert(9); // itemInsertedHandler: 9 |
| simpleColl.remove(8); // itemRemovedHandler: 8 |
| trace(simpleColl); // 0, 1, 2, 3, 4, 5, 6, 7, 9 |
| |
| var greaterThanFourColl:SimpleCollection; |
| greaterThanFourColl = simpleColl.select(4, function(item:int, value:int){ return item > value }); |
| trace(greaterThanFourColl); // 5, 6, 7, 9 |
| } |
| } |
| } |
| |
| import flash.display.Sprite; |
| |
| class EventBroadcaster { |
| private var listeners:Array; |
| |
| public function EventBroadcaster() { |
| listeners = new Array(); |
| } |
| |
| public function addListener(obj:Object):void { |
| removeListener(obj); |
| listeners.push(obj); |
| } |
| |
| public function removeListener(obj:Object):void { |
| for(var i:uint = 0; i < listeners.length; i++) { |
| if(listeners[i] == obj) { |
| listeners.splice(i, 1); |
| } |
| } |
| } |
| |
| public function broadcastEvent(evnt:String, ...args):void { |
| for(var i:uint = 0; i < listeners.length; i++) { |
| listeners[i][evnt].apply(listeners[i], args); |
| } |
| } |
| } |
| |
| class SimpleCollection extends EventBroadcaster { |
| private var arr:Array; |
| public function SimpleCollection(... args) { |
| arr = (args.length == 1 && !isNaN(args[0])) ? new Array(args[0]) : args; |
| } |
| |
| public function insert(obj:Object):void { |
| remove(obj); |
| arr.push(obj); |
| broadcastEvent("itemInsertedHandler", obj); |
| } |
| |
| public function remove(obj:Object):void { |
| for(var i:uint = 0; i < arr.length; i++) { |
| if(arr[i] == obj) { |
| var obj:Object = arr.splice(i, 1)[0]; |
| broadcastEvent("itemRemovedHandler", obj); |
| } |
| } |
| } |
| |
| public function select(val:int, fn:Function):SimpleCollection { |
| var col:SimpleCollection = new SimpleCollection(); |
| for(var i:uint = 0; i < arr.length; i++) { |
| if(fn.call(this, arr[i], val)) { |
| col.insert(arr[i]); |
| } |
| } |
| return col; |
| } |
| |
| public function toString():String { |
| var str:String = new String(); |
| for(var i:uint = 0; i < arr.length - 1; i++) { |
| str += arr[i] + ", "; |
| } |
| str += arr[arr.length - 1]; |
| return str; |
| } |
| } |
| |
| class EventListener { |
| public function EventListener() { |
| } |
| |
| public function itemInsertedHandler(obj:Object):void { |
| trace("itemInsertedHandler: " + obj); |
| } |
| |
| public function itemRemovedHandler(obj:Object):void { |
| trace("itemRemovedHandler: " + obj); |
| } |
| } |
| </codeblock></example></apiClassifierDetail><apiOperation id="Function:AS3:apply" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">apply</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Wert von thisObject an, der in sämtlichen von ActionScript aufgerufenen Funktionen verwendet werden soll.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Function, Function.apply, apply |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Alle Werte, die durch die aufgerufene Funktion angegeben werden. |
| |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisArg</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">unknown</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt, auf das die Funktion angewendet wird. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">argArray</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">unknown</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array, dessen Elemente als Parameter an die Funktion übergeben werden. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt die Objektinstanz an, für die die Funktion aufgerufen wird. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Wert von <codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph> an, der in sämtlichen von ActionScript aufgerufenen Funktionen verwendet werden soll. Diese Methode gibt außerdem die Parameter an, die an eine aufgerufene Funktion übergeben werden. Da es sich bei <codeph class="+ topic/ph pr-d/codeph ">apply()</codeph> um eine Methode der Function-Klasse handelt, ist sie gleichzeitig auch eine Methode aller Function-Objekte in ActionScript. |
| <p class="- topic/p ">Die Parameter werden im Gegensatz zu <codeph class="+ topic/ph pr-d/codeph ">Function.call()</codeph>, das Parameter als eine durch Komma getrennte Liste definiert, als Array-Objekte angegeben. Dies ist besonders dann nützlich, wenn die Anzahl der zu übergebenden Parameter erst bei der eigentlichen Skriptausführung bekannt wird.</p> |
| <p class="- topic/p ">Gibt den Wert zurück, der von der aufgerufenen Funktion als Rückgabewert angegeben wurde.</p> |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Function/call()" class="- topic/link "><linktext class="- topic/linktext ">Function.call()</linktext></link></related-links></apiOperation><apiOperation id="Function:AS3:call" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">call</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die durch ein Function-Objekt dargestellte Funktion auf.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Function, Function.call, call |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisArg</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiData class="- topic/ph reference/ph apiRef/apiData ">unknown</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das den Wert von <codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph> innerhalb des Hauptteils der Funktion angibt. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der/die Parameter, der/die an die Funktion übergeben wird/werden. Sie können keinen oder beliebig viele Parameter angeben. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ruft diese Funktion auf. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die durch ein Function-Objekt dargestellte Funktion auf. Da jede Funktion in ActionScript durch ein Function-Objekt dargestellt wird, unterstützen alle Funktionen diese Methode. |
| <p class="- topic/p ">In den meisten Fällen kann der Funktionsaufrufoperator (<codeph class="+ topic/ph pr-d/codeph ">()</codeph>) anstelle dieser Methode verwendet werden. Der Funktionsaufrufoperator erzeugt kompakten und leicht lesbaren Code. Diese Methode bietet sich besonders dann an, wenn der <codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>-Parameter im Funktionsaufruf explizit gesteuert werden muss. Wenn eine Funktion als Methode eines Objekts aufgerufen wird, wird, wie im folgenden Beispiel, im Hauptteil der Funktion <codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph> normalerweise auf <codeph class="+ topic/ph pr-d/codeph ">myObject</codeph> gesetzt:</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| myObject.myMethod(1, 2, 3); |
| </codeblock> |
| <p class="- topic/p ">In bestimmten Fällen sollten Sie mit <codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph> auf ein anderes Objekt Bezug nehmen, z. B. wenn eine Funktion als Methode eines Objekts aufgerufen werden muss, aber nicht als Methode dieses Objekts gespeichert ist:</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| myObject.myMethod.call(myOtherObject, 1, 2, 3); |
| </codeblock> |
| <p class="- topic/p ">Sie können für den Parameter <codeph class="+ topic/ph pr-d/codeph ">null</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph> übergeben, um eine Funktion als normale Funktion und nicht als Methode eines Objekts aufzurufen. Die folgenden Funktionsaufrufe sind beispielsweise gleichwertig:</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| Math.sin(Math.PI / 4) |
| Math.sin.call(null, Math.PI / 4) |
| </codeblock> |
| |
| <p class="- topic/p ">Gibt den Wert zurück, der von der aufgerufenen Funktion als Rückgabewert angegeben wurde.</p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Function/apply()" class="- topic/link "><linktext class="- topic/linktext ">Function.apply()</linktext></link></related-links></apiOperation></apiClassifier><apiClassifier languages="" id="globalClassifier:SyntaxError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">SyntaxError</apiName><shortdesc class="- topic/shortdesc "> |
| Eine SyntaxError-Ausnahme wird ausgegeben, wenn ein Parsingfehler aus einem der folgenden Gründe auftritt:</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, SyntaxError |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine SyntaxError-Ausnahme wird ausgegeben, wenn ein Parsingfehler aus einem der folgenden Gründe auftritt: |
| <ul class="- topic/ul "><li class="- topic/li ">Ein ungültiger regulärer Ausdruck wird von der RegExp-Klasse analysiert.</li><li class="- topic/li ">Ungültiger XML-Inhalt wird von der XML-Klasse analysiert.</li></ul> |
| |
| </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="#RegExp" class="- topic/link "><linktext class="- topic/linktext ">RegExp-Klasse</linktext></link><link href="#XML" class="- topic/link "><linktext class="- topic/linktext ">XML-Klasse</linktext></link></related-links><apiConstructor id="SyntaxError:SyntaxError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">SyntaxError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues SyntaxError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die mit dem SyntaxError-Objekt verbundene Meldung. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues SyntaxError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:XMLList" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">XMLList</apiName><shortdesc class="- topic/shortdesc "> |
| Die XMLList-Klasse enthält Methoden zur Arbeit mit einem oder mehreren XML-Elementen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die XMLList-Klasse enthält Methoden zur Arbeit mit einem oder mehreren XML-Elementen. Ein XMLList-Objekt kann eines oder mehrere XML-Objekte oder -Elemente (einschließlich mehrere Knoten und Attribute) repräsentieren. Dadurch haben Sie die Möglichkeit, Methoden für die Elemente als Gruppe oder für einzelne Elemente in der Sammlung aufzurufen. |
| <p class="- topic/p ">Wenn ein XMLList-Objekt nur ein XML-Element aufweist, können Sie die Methoden der XML-Klasse direkt auf das XMLList-Objekt anwenden. Im folgenden Beispiel ist <codeph class="+ topic/ph pr-d/codeph ">example.two</codeph> ein XMLList-Objekt mit einer Länge von 1, sodass Sie eine XML-Methode darauf anwenden können.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var example2 = <example><two>2</two></example>;</codeblock> |
| <p class="- topic/p ">Wenn Sie versuchen, Methoden der XML-Klasse auf ein XMLList-Objekt anzuwenden, dass mehrere XML-Objekte enthält, wird eine Ausnahme ausgelöst. Durchlaufen Sie stattdessen die XMLList-Sammlung (beispielsweise mit einer <codeph class="+ topic/ph pr-d/codeph ">for each..in</codeph>-Anweisung), und wenden Sie Methoden auf jedes einzelne XML-Objekt in der Sammlung an.</p> |
| |
| </apiDesc><example conref="examples\XMLListExample.as" class="- topic/example "> Im folgenden Beispiel wird eine XML-Eigenschaft namens <codeph class="+ topic/ph pr-d/codeph ">books</codeph> erstellt, und mehrere Elemente werden mit<codeph class="+ topic/ph pr-d/codeph ">book publisher</codeph> und <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Tags zum Knoten <codeph class="+ topic/ph pr-d/codeph ">books</codeph> hinzugefügt. Anschließend wird die <codeph class="+ topic/ph pr-d/codeph ">showBooksByPublisher()</codeph>-Methode aufgerufen und auf die XMLList-Sammlung angewendet; jedes Element, das dem Herausgeber „Addison-Wesley“ entspricht, wird zurückgegeben. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class XMLListExample extends Sprite { |
| private var books:XML; |
| |
| public function XMLListExample() { |
| books = <books> |
| <book publisher="Addison-Wesley" name="Design Patterns" /> |
| <book publisher="Addison-Wesley" name="The Pragmatic Programmer" /> |
| <book publisher="Addison-Wesley" name="Test Driven Development" /> |
| <book publisher="Addison-Wesley" name="Refactoring to Patterns" /> |
| <book publisher="O'Reilly Media" name="The Cathedral & the Bazaar" /> |
| <book publisher="O'Reilly Media" name="Unit Test Frameworks" /> |
| </books>; |
| |
| showBooksByPublisher("Addison-Wesley"); |
| } |
| |
| private function showBooksByPublisher(name:String):void { |
| var results:XMLList = books.book.(@publisher == name); |
| showList(results); |
| } |
| |
| private function showList(list:XMLList):void { |
| var item:XML; |
| for each(item in list) { |
| trace("item: " + item.toXMLString()); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#XML" class="- topic/link "><linktext class="- topic/linktext ">XML</linktext></link><link href="statements.html#for_each..in" class="- topic/link "><linktext class="- topic/linktext ">for each..in</linktext></link><link href="#Namespace" class="- topic/link "><linktext class="- topic/linktext ">Namespace</linktext></link><link href="#QName" class="- topic/link "><linktext class="- topic/linktext ">QName</linktext></link></related-links><apiConstructor id="XMLList:XMLList" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">XMLList</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues XMLList-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Jedes Objekt, das mithilfe von <codeph class="+ topic/ph pr-d/codeph ">XMLList()</codeph>, einer Funktion oberster Ebene, in ein XMLList-Objekt konvertieren werden kann. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues XMLList-Objekt. |
| |
| </apiDesc></apiConstructorDetail><related-links class="- topic/related-links "><link href="#global/XMLList()" class="- topic/link "><linktext class="- topic/linktext ">XMLList()-Funktion auf oberster Ebene</linktext></link></related-links></apiConstructor><apiOperation id="XMLList:AS3:attribute" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attribute</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die attribute()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit den Ergebnissen zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.attribute, attribute |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit übereinstimmenden XML-Objekten oder ein leeres XMLList-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">attributeName</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name des Attributs, dass Sie in ein XMLList-Objekt einbinden wollen. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">attribute()</codeph>-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit den Ergebnissen zurück. Die Ergebnisse entsprechen dem angegebenen <codeph class="+ topic/ph pr-d/codeph ">attributeName</codeph>-Parameter. Wenn es keine Übereinstimmung gibt, gibt die <codeph class="+ topic/ph pr-d/codeph ">attribute()</codeph>-Methode ein leeres XMLList-Objekt zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/attribute()" class="- topic/link "><linktext class="- topic/linktext ">XML.attribute()</linktext></link><link href="#XML/attributes()" class="- topic/link "><linktext class="- topic/linktext ">XML.attributes()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:attributes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attributes</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die attributes()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Attributen für jedes XML-Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.attributes, attributes |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit Attributen für jedes XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">attributes()</codeph>-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Attributen für jedes XML-Objekt zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/attribute()" class="- topic/link "><linktext class="- topic/linktext ">XML.attribute()</linktext></link><link href="#XML/attributes()" class="- topic/link "><linktext class="- topic/linktext ">XML.attributes()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:child" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">child</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die child()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt zurück, das die Ergebnisse in der richtigen Reihenfolge enthält.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.child, child |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit untergeordneten Knoten, die dem input-Parameter entsprechen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">propertyName</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Elementname oder die Ganzzahl des untergeordneten XML-Elements. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">child()</codeph>-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt zurück, das die Ergebnisse in der richtigen Reihenfolge enthält. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/child()" class="- topic/link "><linktext class="- topic/linktext ">XML.child()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:children" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">children</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die children()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.children, children |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit den Knoten, die dem XML-Objekt untergeordnet sind. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">children()</codeph>-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/children()" class="- topic/link "><linktext class="- topic/linktext ">XML.children()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:comments" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">comments</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die comments()-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Kommentaren zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.comments, comments |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit den Kommentaren im XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">comments()</codeph>-Methode für jedes XML-Objekt auf und gibt ein XMLList-Objekt mit Kommentaren zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/comments()" class="- topic/link "><linktext class="- topic/linktext ">XML.comments()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:contains" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">contains</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob das XMLList-Objekt ein XML-Objekt enthält, das dem angegebenen value-Parameter entspricht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.contains, contains |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">value</codeph>, wenn das XMLList-Objekt das im Parameter <codeph class="+ topic/ph pr-d/codeph ">true</codeph> deklarierte XML-Objekt enthält; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XML-Objekt, das mit dem aktuellen XMLList-Objekt verglichen werden soll. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob das XMLList-Objekt ein XML-Objekt enthält, das dem angegebenen <codeph class="+ topic/ph pr-d/codeph ">value</codeph>-Parameter entspricht. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:copy" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">copy</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Kopie des gegebenen XMLList-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.copy, copy |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Kopie des XMLList-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Kopie des gegebenen XMLList-Objekts zurück. Die Kopie ist ein Duplikat der gesamten Knotenbaumstruktur. Das kopierte XML-Objekt hat kein übergeordnetes Objekt und gibt den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> zurück, wenn Sie versuchen, die <codeph class="+ topic/ph pr-d/codeph ">parent()</codeph>-Methode aufzurufen. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:descendants" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">descendants</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt alle untergeordneten Elemente (direkt untergeordnete und über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts zurück, die dem gegebenen name-Parameter entsprechen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.descendants, descendants |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt der übereinstimmenden untergeordneten Elemente (direkt untergeordnete sowie über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts in der ursprünglichen Liste. Wenn es keine untergeordneten Elemente gibt, wird ein leeres XMLList-Objekt zurückgegeben. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">*</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name des zu vergleichenden Elements. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt alle untergeordneten Elemente (direkt untergeordnete und über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts zurück, die dem gegebenen <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter entsprechen. Der <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter kann ein QName-Objekt sein, ein Objekt des Datentyps String oder jeglichen sonstigen Datentyps, der sich in einen String konvertieren lässt. |
| |
| <p class="- topic/p ">Um alle untergeordneten Elemente zurückzugeben, verwenden Sie den Sternparameter (~~). Wird kein Parameter übergeben, wird der String „~~“ übergeben, sodass alle untergeordneten Elemente des XML-Objekts zurückgegeben werden.</p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/descendants()" class="- topic/link "><linktext class="- topic/linktext ">XML.descendants()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:elements" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">elements</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die elements()-Methode jedes XML-Objekts auf.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.elements, elements |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit den übereinstimmenden untergeordneten Elementen im XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">*</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name des zu vergleichenden Elements. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">elements()</codeph>-Methode jedes XML-Objekts auf. Der Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph> wird an die Methode <codeph class="+ topic/ph pr-d/codeph ">descendants()</codeph> übergeben. Wird kein Parameter übergeben, wird der String „~~“ an die Methode <codeph class="+ topic/ph pr-d/codeph ">descendants()</codeph> übergeben. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/elements()" class="- topic/link "><linktext class="- topic/linktext ">XML.elements()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:hasComplexContent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasComplexContent</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob das XMLList-Objekt komplexen Inhalt enthält.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.hasComplexContent, hasComplexContent |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn das XMLList-Objekt einen komplexen Inhalt hat; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob das XMLList-Objekt komplexen Inhalt enthält. Man betrachtet den Inhalt eines XMLList-Objekts als komplex, wenn es nicht leer ist oder eine der folgenden Bedingungen erfüllt ist: |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Das XMLList-Objekt enthält ein einziges XML-Element mit komplexem Inhalt.</li><li class="- topic/li ">Das XMLList-Objekt enthält Elemente.</li></ul> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XMLList/hasSimpleContent()" class="- topic/link "><linktext class="- topic/linktext ">hasSimpleContent()</linktext></link><link href="#XML/hasComplexContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasComplexContent()</linktext></link><link href="#XML/hasSimpleContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasSimpleContent()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:hasOwnProperty" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasOwnProperty</apiName><shortdesc class="- topic/shortdesc "> |
| Sucht nach der durch „p“ angegebenen Eigenschaft.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.hasOwnProperty, hasOwnProperty |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn der Parameter vorhanden ist; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">p</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die zu vergleichende Eigenschaft. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft nach der durch <codeph class="+ topic/ph pr-d/codeph ">p</codeph> angegebenen Eigenschaft. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:hasSimpleContent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasSimpleContent</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob das XMLList-Objekt einfachen Inhalt enthält.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.hasSimpleContent, hasSimpleContent |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn das XMLList-Objekt einen einfachen Inhalt hat; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob das XMLList-Objekt einfachen Inhalt enthält. Man betrachtet den Inhalt eines XMLList-Objekts als einfach, wenn eine oder mehrere der folgenden Bedingungen erfüllt sind: |
| <ul class="- topic/ul "><li class="- topic/li ">Das XMLList-Objekt ist leer.</li><li class="- topic/li ">Das XMLList-Objekt enthält ein einziges XML-Element mit einfachem Inhalt.</li><li class="- topic/li ">Das XMLList-Objekt enthält keine Elemente.</li></ul> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XMLList/hasComplexContent()" class="- topic/link "><linktext class="- topic/linktext ">hasComplexContent()</linktext></link><link href="#XML/hasComplexContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasComplexContent()</linktext></link><link href="#XML/hasSimpleContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasSimpleContent()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:length" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">length</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Anzahl der Eigenschaften im XMLList-Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.length, length |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Anzahl der Eigenschaften im XMLList-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Anzahl der Eigenschaften im XMLList-Objekt zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:normalize" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">normalize</apiName><shortdesc class="- topic/shortdesc "> |
| Führt benachbarte Textknoten zusammen und entfernt leere Textknoten für alle Textknoten im XMLList-Objekt, alle XML-Objekte im XMLList-Objekt und die untergeordneten Elemente aller XML-Objekte im XMLList-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.normalize, normalize |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das normalisierte XMLList-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt benachbarte Textknoten zusammen und entfernt leere Textknoten für alle Textknoten im XMLList-Objekt, alle XML-Objekte im XMLList-Objekt und die untergeordneten Elemente aller XML-Objekte im XMLList-Objekt. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:parent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">parent</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den übergeordneten Knoten des XMLList-Objekts zurück, wenn alle Elemente im XMLList-Objekt denselben übergeordneten Knoten besitzen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.parent, parent |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt das übergeordnete XML-Objekt zurück. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den übergeordneten Knoten des XMLList-Objekts zurück, wenn alle Elemente im XMLList-Objekt denselben übergeordneten Knoten besitzen. Hat das XMLList-Objekt keine oder unterschiedliche übergeordnete Knoten, gibt die Methode den Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:processingInstructions" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">processingInstructions</apiName><shortdesc class="- topic/shortdesc "> |
| Wird ein name-Parameter bereitgestellt, werden alle untergeordneten Knoten des XMLList-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen enthalten.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.processingInstructions, processingInstructions |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt, das die Verarbeitungsanweisungen für jedes XML-Objekt enthält. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">*</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name der gesuchten Verarbeitungsanweisung. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wird ein <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter bereitgestellt, werden alle untergeordneten Knoten des XMLList-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen enthalten. Ohne Parameter listet diese Methode alle untergeordneten Knoten des XMLList-Objekts auf, die irgendwelche Verarbeitungsanweisungen enthalten. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/processingInstructions()" class="- topic/link "><linktext class="- topic/linktext ">XML.processingInstructions()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:propertyIsEnumerable" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">propertyIsEnumerable</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob sich die Eigenschaft „p“ in dem Satz an Eigenschaften befindet, die in einer auf das XMLList-Objekt angewendeten „for..in“-Anweisung durchlaufen werden können.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.propertyIsEnumerable, propertyIsEnumerable |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn die Eigenschaft in einer <codeph class="+ topic/ph pr-d/codeph ">for..in</codeph>-Anweisung durchlaufen werden kann, lautet der Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">p</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Indexposition einer zu überprüfenden Eigenschaft. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob sich die Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">p</codeph> in dem Satz an Eigenschaften befindet, die in einer auf das XML-Objekt angewendeten <codeph class="+ topic/ph pr-d/codeph ">for..in</codeph>-Anweisung durchlaufen werden können. Es ergibt sich der <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn <codeph class="+ topic/ph pr-d/codeph ">toNumber(p)</codeph> größer oder gleich 0 und kleiner als die Länge des XMLList-Objekts ist. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XMLList:AS3:text" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">text</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die text()-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.text, text |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit allen XML-Eigenschaften des XMLList-Objekts, die XML-Textknoten darstellen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die <codeph class="+ topic/ph pr-d/codeph ">text()</codeph>-Methode für jedes XML-Objekt zurück und gibt ein XMLList-Objekt mit den Ergebnissen zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/text()" class="- topic/link "><linktext class="- topic/linktext ">XML.text()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.toString, toString |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des XML-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück. Nach welchen Regeln diese Konvertierung vollzogen wird, ist abhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt hat: |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Hat das XML-Objekt einen einfachen Inhalt, gibt <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> den String-Inhalt des XML-Objekts zurück, wobei das Start-Tag, vorhandene Attribute, Namespace-Deklarationen und das Endtag entfernt werden.</li></ul> |
| |
| <ul class="- topic/ul "><li class="- topic/li "> Hat das XML-Objekt einen komplexen Inhalt, gibt <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> das gesamte XML-Objekt als XML-kodierten String zurück, einschließlich Start-Tag, Attributen, Namespace-Deklarationen und End-Tag.</li></ul> |
| |
| <p class="- topic/p ">Damit jedes Mal das gesamte XML-Objekt zurückgegeben wird, verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph>.</p> |
| |
| |
| </apiDesc><example conref="examples\XMLToStringExample1.as" class="- topic/example "> Im folgende Beispiel wird veranschaulicht, was die <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Methode zurückgibt, wenn das XML-Objekt einen einfachen Inhalt hat: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var test:XML = <type name="Joe">example</type>; |
| trace(test.toString()); //example |
| </codeblock></example><example conref="examples\XMLToStringExample2.as" class="- topic/example "> Im folgende Beispiel wird veranschaulicht, was die <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Methode zurückgibt, wenn das XML-Objekt einen komplexen Inhalt hat: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var test:XML = |
| <type name="Joe"> |
| <base name="Bob"></base> |
| example |
| </type>; |
| trace(test.toString()); |
| // <type name="Joe"> |
| // <base name="Bob"/> |
| // example |
| // </type> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XMLList/hasComplexContent()" class="- topic/link "><linktext class="- topic/linktext ">hasComplexContent()</linktext></link><link href="#XMLList/hasSimpleContent()" class="- topic/link "><linktext class="- topic/linktext ">hasSimpleContent()</linktext></link><link href="#XMLList/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">toXMLString()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:toXMLString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toXMLString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.toXMLString, toXMLString |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des XML-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt alle XML-Objekte in einem XMLList-Objekt als String zurück. Im Gegensatz zur Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> gibt die Methode <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph> immer das Start-Tag, vorhandene Attribute und das End-Tag des XML-Objekts zurück, unabhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt hat. (Die Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> entfernt alle diese Elemente für XML-Objekte mit einfachem Inhalt.) |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#XMLList/toString()" class="- topic/link "><linktext class="- topic/linktext ">toString()</linktext></link></related-links></apiOperation><apiOperation id="XMLList:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das XMLList-Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XMLList, XMLList.valueOf, valueOf |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt das aktuelle XMLList-Objekt zurück. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das XMLList-Objekt zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation></apiClassifier><apiClassifier languages="" id="globalClassifier:Boolean" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Boolean</apiName><shortdesc class="- topic/shortdesc "> |
| Ein Boolean-Objekt ist ein Datentyp, der einen der zwei für logische Operationen verwendeten Werte annehmen kann, entweder „true“ oder „false“.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><refpath>Objects/Core/Boolean/ |
| |
| </refpath></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein Boolean-Objekt ist ein Datentyp, der einen der zwei für logische Operationen verwendeten Werte annehmen kann, entweder <codeph class="+ topic/ph pr-d/codeph ">true</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. Mit der Boolean-Klasse können Sie den Grunddatentyp oder die Stringdarstellung eines Boolean-Objekts abrufen. |
| |
| <p class="- topic/p ">Um ein Boolean-Objekt zu erstellen, können Sie den Konstruktor der globalen Funktion verwenden oder einen Literalwert zuweisen. Es spielt keine Rolle, welches Verfahren Sie verwenden; in ActionScript 3.0 sind alle drei Verfahren gleichwertig. (In JavaScript wird dies unterschiedlich gehandhabt, denn dort unterscheidet sich ein Boolean-Objekt vom Grunddatentyp Boolean.)</p> |
| |
| <p class="- topic/p ">Die folgenden Codezeilen sind äquivalent:</p> |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var flag:Boolean = true; |
| var flag:Boolean = new Boolean(true); |
| var flag:Boolean = Boolean(true); |
| </codeblock> |
| |
| </apiDesc><example conref="examples\BooleanExample.as" class="- topic/example "> Im folgenden Beispiel wird zwischen den entsprechenden Werten des Boolean-Objekts umgeschaltet und die Werte werden angezeigt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class BooleanExample extends Sprite { |
| private var flag:Boolean; |
| |
| public function BooleanExample() { |
| trace(flag); // false |
| toggle(); |
| trace(flag); // true |
| toggle(); |
| trace(flag); // false |
| } |
| |
| private function toggle():void{ |
| flag = !flag; |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><apiConstructor id="Boolean:Boolean" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Boolean</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein Boolean-Objekt mit dem angegebenen Wert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">new boolean, constructor |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">expression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein beliebiger Ausdruck. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein Boolean-Objekt mit dem angegebenen Wert. Wenn Sie den Parameter <codeph class="+ topic/ph pr-d/codeph ">expression</codeph> weglassen, wird das Boolean-Objekt mit dem Wert <codeph class="+ topic/ph pr-d/codeph ">false</codeph> initialisiert. Geben Sie dagegen einen Wert für den Parameter <codeph class="+ topic/ph pr-d/codeph ">expression</codeph> an, wertet die Methode diesen aus und gibt das Ergebnis als booleschen Wert entsprechend der Regeln der allgemeinen <codeph class="+ topic/ph pr-d/codeph ">Boolean()</codeph>-Funktion zurück. |
| |
| </apiDesc><example class="- topic/example ">Der folgende Code erstellt ein neues Boolean-Objekt, das mit dem Wert <codeph class="+ topic/ph pr-d/codeph ">false</codeph> initialisiert wird, und den Namen <codeph class="+ topic/ph pr-d/codeph ">myBoolean</codeph> trägt: |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myBoolean:Boolean = new Boolean(); |
| </codeblock> |
| |
| </example></apiConstructorDetail><related-links class="- topic/related-links "><link href="package.html#Boolean()" class="- topic/link "><linktext class="- topic/linktext ">Boolescher Ausdruck() globale Funktion</linktext></link></related-links></apiConstructor><apiOperation id="Boolean:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt die Stringdarstellung („true“ bzw. „false“) des Boolean-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">boolean.toString, toString |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der String <codeph class="+ topic/ph pr-d/codeph ">"true"</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">"false"</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt die Stringdarstellung (<codeph class="+ topic/ph pr-d/codeph ">"true"</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">"false"</codeph>) des Boolean-Objekts zurück. Die Ausgabe wird nicht lokalisiert und ist <codeph class="+ topic/ph pr-d/codeph ">"true"</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">"false"</codeph>, und zwar unabhängig von der Systemsprache. |
| |
| </apiDesc><example class="- topic/example ">In diesem Beispiel wird eine Variable vom Typ Boolean erstellt, und anschließend wird deren Wert für die Verwendung in einem Stringarray mithilfe von <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> in einen String umgewandelt: |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myStringArray:Array = new Array("yes", "could be"); |
| var myBool:Boolean = 0; |
| myBool.toString(); |
| myStringArray.push(myBool); |
| trace(myStringArray); // yes,could be,false |
| </codeblock> |
| |
| |
| </example></apiOperationDetail></apiOperation><apiOperation id="Boolean:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt „true“ zurück, wenn der Wert des angegebenen Boolean-Objekts wahr ist; andernfalls „false“.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">boolean.valueOf, valueOf |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein boolescher Wert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn der Wert des angegebenen Boolean-Objekts wahr ist; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><example class="- topic/example ">Aus dem folgenden Beispiel geht die Funktionsweise dieser Methode hervor. Es zeigt außerdem, dass der Wert eines neuen Boolean-Objekts <codeph class="+ topic/ph pr-d/codeph ">false</codeph> lautet: |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myBool:Boolean = new Boolean(); |
| trace(myBool.valueOf()); // false |
| myBool = (6==3+3); |
| trace(myBool.valueOf()); // true |
| </codeblock> |
| |
| |
| </example></apiOperationDetail></apiOperation></apiClassifier><apiClassifier languages="" id="globalClassifier:Error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Error</apiName><shortdesc class="- topic/shortdesc "> |
| Die Error-Klasse enthält Informationen zu einem Fehler in Ihrem Skript.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein Fehler wird ausgelöst, wenn in einem Skript ein Fehler auftritt. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die Error-Klasse enthält Informationen zu einem Fehler in Ihrem Skript. Wenn Sie ActionScript 3.0-Anwendungen entwickeln und Ihren kompilierten Programmcode in der Debugger-Version einer Flash-Laufzeitumgebung ausführen, werden in einem speziellen Dialogfeld Ausnahmen vom Typ Error angezeigt, oder von einer Unterklasse. Dadurch wird Ihnen die Fehlersuche im Code erleichtert. Ein Error-Objekt wird mit der Konstruktorfunktion <codeph class="+ topic/ph pr-d/codeph ">Error</codeph> erstellt. Gewöhnlich lösen Sie in einem <codeph class="+ topic/ph pr-d/codeph ">try</codeph>-Codeblock ein neues Error-Objekt aus, das mithilfe eines<codeph class="+ topic/ph pr-d/codeph ">catch</codeph>- oder <codeph class="+ topic/ph pr-d/codeph ">finally</codeph>-Codeblocks abgefangen werden kann. |
| <p class="- topic/p ">Sie können auch eine Unterklasse der Error-Klasse erstellen und Instanzen dieser Unterklasse ausgeben.</p> |
| |
| </apiDesc><example conref="examples\ErrorExample.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">ErrorExample</codeph>-Klasse gezeigt, wie ein benutzerdefinierter Fehler erzeugt werden kann. Dies wird in den folgenden Schritten erreicht: |
| <ol class="- topic/ol "><li class="- topic/li ">Eine lokale Variable <codeph class="+ topic/ph pr-d/codeph ">nullArray</codeph> vom Typ Array wird zwar deklariert, es muss jedoch beachten werden, dass kein neues Array-Objekt erstellt wird.</li><li class="- topic/li ">Der Konstruktor versucht mithilfe der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>-Methode einen Wert in das nicht initialisierte Array zu laden. Diese Methode befindet sich in einem Codesegment zur Fehlerverarbeitung, mit dem ein benutzerdefinierter Fehler mithilfe der <codeph class="+ topic/ph pr-d/codeph ">CustomError</codeph>-Klasse abgefangen und <codeph class="+ topic/ph pr-d/codeph ">Error</codeph> erweitert wird.</li><li class="- topic/li ">Wenn ein benutzerdefinierter Fehler ausgelöst wird, wird er vom Konstruktor abgefangen. Anschließend gibt er eine Fehlermeldung mithilfe der <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung aus. </li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package |
| { |
| import flash.display.Sprite; |
| public class ErrorExample extends Sprite |
| { |
| private var nullArray:Array; |
| public function ErrorExample() |
| { |
| try |
| { |
| nullArray.push("item"); |
| } |
| catch(e:Error) |
| { |
| throw new CustomError("nullArray is null"); |
| } |
| } |
| } |
| } |
| |
| class CustomError extends Error |
| { |
| public function CustomError(message:String) |
| { |
| super(message); |
| } |
| } |
| </codeblock></example></apiClassifierDetail><apiConstructor id="Error:Error" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Error</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues Error-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, constructor |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der mit dem Error-Objekt verknüpft ist. Dieser Parameter ist optional. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">id</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die Verweisnummer der zugeordneten Fehlermeldung. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Erstellt eine neue Error-Instanz mit der angegebenen Fehlermeldung. |
| |
| </apiTipText></apiTipTexts></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues Error-Objekt. Wenn <codeph class="+ topic/ph pr-d/codeph ">message</codeph> angegeben ist, wird dieser Wert der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">Error.message</codeph> des Objekts zugewiesen. |
| |
| |
| </apiDesc><example conref="examples\Error.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Error-Objekt <codeph class="+ topic/ph pr-d/codeph ">err</codeph> erstellt. Anschließend wird mithilfe des <codeph class="+ topic/ph pr-d/codeph ">Error()</codeph>-Konstruktors der String <codeph class="+ topic/ph pr-d/codeph ">"New Error Message"</codeph> dem Error-Objekt <codeph class="+ topic/ph pr-d/codeph ">err</codeph> zugewiesen. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var err:Error = new Error(); |
| trace(err.toString()); // Error |
| |
| err = new Error("New Error Message"); |
| trace(err.toString()); // Error: New Error Message |
| </codeblock></example></apiConstructorDetail><related-links class="- topic/related-links "><link href="statements.html#throw" class="- topic/link "><linktext class="- topic/linktext ">statements.html#throw</linktext></link><link href="statements.html#try..catch..finally" class="- topic/link "><linktext class="- topic/linktext ">statements.html#try..catch..finally</linktext></link></related-links></apiConstructor><apiOperation id="Error:getStackTrace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">getStackTrace</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt zum Zeitpunkt der Fehlerentstehung den Call-Stack für den Fehler als String zurück (nur bei der Debugger-Version des Flash Players und bei AIR Debug Launcher (ADL)); gibt Null zurück, wenn nicht die Debugger-Version des Flash Players oder ADL verwendet wird.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, call stack |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Stringdarstellung des Call-Stack. |
| |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt den Call-Stack für einen Fehler in lesbarer Form zurück. |
| |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt zum Zeitpunkt der Fehlerentstehung den Call-Stack für den Fehler als String zurück (nur bei der Debugger-Version des Flash Players und bei AIR Debug Launcher (ADL)); gibt <codeph class="+ topic/ph pr-d/codeph ">null</codeph> zurück, wenn nicht die Debugger-Version des Flash Players oder ADL verwendet wird. Wie im folgenden Beispiel ersichtlich, ist die erste Zeile des Rückgabewerts die Stringdarstellung des Ausnahmeobjekts, gefolgt von den Stack-Trace-Elementen: |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| TypeError: null cannot be converted to an object |
| at com.xyz.OrderEntry.retrieveData(OrderEntry.as:995) |
| at com.xyz.OrderEntry.init(OrderEntry.as:200) |
| at com.xyz.OrderEntry.$construct(OrderEntry.as:148) |
| </codeblock> |
| |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Error:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| |
| Gibt in der Standardeinstellung den String „Error“ oder, sofern definiert, den in der Error.message-Eigenschaft enthaltenen Wert zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error.toString, toString |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiIsOverride class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiIsOverride "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Fehlermeldung. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt entweder die Fehlermeldung zurück oder das Wort „Error“, falls keine Meldung definiert ist. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| |
| Gibt in der Standardeinstellung den String <codeph class="+ topic/ph pr-d/codeph ">"Error"</codeph> oder, sofern definiert, den in der <codeph class="+ topic/ph pr-d/codeph ">Error.message</codeph>-Eigenschaft enthaltenen Wert zurück. |
| |
| </apiDesc><example conref="examples\Error.toString.1.as" class="- topic/example "> Im folgenden Beispiel wird ein neues Error-Objekt <codeph class="+ topic/ph pr-d/codeph ">err</codeph> erstellt. Anschließend wird mithilfe des <codeph class="+ topic/ph pr-d/codeph ">Error()</codeph>-Konstruktors der String <codeph class="+ topic/ph pr-d/codeph ">"New Error Message"</codeph> dem Error-Objekt <codeph class="+ topic/ph pr-d/codeph ">err</codeph> zugewiesen. Abschließend wird die <codeph class="+ topic/ph pr-d/codeph ">message</codeph>-Eigenschaft auf <codeph class="+ topic/ph pr-d/codeph ">"Another New Error Message"</codeph> gesetzt, womit <codeph class="+ topic/ph pr-d/codeph ">"New Error Message"</codeph> überschrieben wird. |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var err:Error = new Error(); |
| trace(err.toString()); // Error |
| |
| err = new Error("New Error Message"); |
| trace(err.toString()); // Error: New Error Message |
| |
| err.message = "Another New Error Message"; |
| trace(err.toString()); // Error: Another New Error Message |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Error/message" class="- topic/link "><linktext class="- topic/linktext ">Error.message</linktext></link><link href="statements.html#throw" class="- topic/link "><linktext class="- topic/linktext ">statements.html#throw</linktext></link><link href="statements.html#try..catch..finally" class="- topic/link "><linktext class="- topic/linktext ">statements.html#try..catch..finally</linktext></link></related-links></apiOperation><apiValue id="Error:message" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">message</apiName><shortdesc class="- topic/shortdesc "> |
| Enthält die mit dem Error-Objekt verbundene Meldung.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error.message, message |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Enthält die mit der Error-Instanz verbundene Fehlermeldung. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Enthält die mit dem Error-Objekt verbundene Meldung. Der Standardwert dieser Eigenschaft lautet "<codeph class="+ topic/ph pr-d/codeph ">Error</codeph>". Sie können eine <codeph class="+ topic/ph pr-d/codeph ">message</codeph>-Eigenschaft angeben, wenn Sie ein neues Error-Objekt erstellen, indem Sie den Fehlerstring an die <codeph class="+ topic/ph pr-d/codeph ">Error</codeph>-Konstruktorfunktion übergeben. |
| |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="statements.html#throw" class="- topic/link "><linktext class="- topic/linktext ">statements.html#throw</linktext></link><link href="statements.html#try..catch..finally" class="- topic/link "><linktext class="- topic/linktext ">statements.html#try..catch..finally</linktext></link></related-links></apiValue><apiValue id="Error:name" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">name</apiName><shortdesc class="- topic/shortdesc "> |
| Enthält den Namen des Error-Objekts.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error.name, name |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Der Name der Error-Instanz. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Enthält den Namen des Error-Objekts. Der Standardwert dieser Eigenschaft lautet "<codeph class="+ topic/ph pr-d/codeph ">Error</codeph>". |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="statements.html#throw" class="- topic/link "><linktext class="- topic/linktext ">statements.html#throw</linktext></link><link href="statements.html#try..catch..finally" class="- topic/link "><linktext class="- topic/linktext ">statements.html#try..catch..finally</linktext></link></related-links></apiValue><apiValue id="Error:errorID:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">errorID</apiName><shortdesc class="- topic/shortdesc "> |
| Enthält die Verweisnummer der zugeordneten Fehlermeldung.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error.errorID, errorID |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Enthält die Fehlernummer. |
| |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Enthält die Verweisnummer der zugeordneten Fehlermeldung. Bei einem selbst definierten Error-Objekt entspricht diese Nummer dem Wert des im Konstruktor bereitgestellten <codeph class="+ topic/ph pr-d/codeph ">id</codeph>-Parameters. |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:TypeError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">TypeError</apiName><shortdesc class="- topic/shortdesc "> |
| Es wird eine TypeError-Ausnahme ausgelöst, wenn sich der tatsächliche Typ eines Operanden vom erwarteten unterscheidet.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Error, TypeError |
| |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Error</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Es wird eine TypeError-Ausnahme ausgelöst, wenn sich der tatsächliche Typ eines Operanden vom erwarteten unterscheidet. |
| <p class="- topic/p "> |
| Darüber hinaus wird diese Ausnahme in den folgenden Fällen ausgelöst: |
| <ul class="- topic/ul "><li class="- topic/li ">Der tatsächliche Parameter einer Funktion oder Methode konnte dem formalen Parametertyp nicht aufgezwungen werden.</li><li class="- topic/li ">Einer Variable wird ein Wert zugewiesen, konnte aber dem Variablentyp nicht aufgezwungen werden.</li><li class="- topic/li ">Die rechte Seite des <codeph class="+ topic/ph pr-d/codeph ">is</codeph>- oder <codeph class="+ topic/ph pr-d/codeph ">instanceof</codeph>-Operators besitzt einen ungültigen Typ.</li><li class="- topic/li ">Das Schlüsselwort <codeph class="+ topic/ph pr-d/codeph ">super</codeph> wurde in unzulässiger Weise eingesetzt.</li><li class="- topic/li ">Das Nachschlagen einer Eigenschaft resultiert in mehreren Bindungen und ist daher mehrdeutig.</li><li class="- topic/li ">Eine Methode wird für ein inkompatibles Objekt aufgerufen. So wird beispielsweise eine TypeError-Ausnahme ausgelöst, wenn eine RegExp-Klassenmethode einem generischen Objekt „aufgepfropft“ und dann aufgerufen wurde.</li></ul> |
| </p> |
| |
| </apiDesc><example conref="examples\TypeErrorExample.as" class="- topic/example "> Dieses Beispiel veranschaulicht, wie eine TypeError-Ausnahme erzeugt und in einer <codeph class="+ topic/ph pr-d/codeph ">try..catch</codeph>-Anweisung verarbeitet wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.DisplayObject; |
| import flash.display.Sprite; |
| |
| public class TypeErrorExample extends Sprite { |
| public function TypeErrorExample() { |
| try { |
| var child:Object = new Object(); |
| addChild(DisplayObject(child)); |
| } |
| catch(e:TypeError) { |
| trace(e); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="operators.html#is" class="- topic/link "><linktext class="- topic/linktext ">is-Operator</linktext></link><link href="operators.html#instanceof" class="- topic/link "><linktext class="- topic/linktext ">instanceof-Operator</linktext></link><link href="statements.html#super" class="- topic/link "><linktext class="- topic/linktext ">super-Anweisung</linktext></link><link href="#RegExp" class="- topic/link "><linktext class="- topic/linktext ">RegExp-Klasse</linktext></link></related-links><apiConstructor id="TypeError:TypeError" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">TypeError</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues TypeError-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">message</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Enthält die mit dem TypeError-Objekt verbundene Meldung. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues TypeError-Objekt. |
| </apiDesc></apiConstructorDetail></apiConstructor></apiClassifier><apiClassifier languages="" id="globalClassifier:arguments" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">arguments</apiName><shortdesc class="- topic/shortdesc "> |
| Ein arguments-Objekt dient zum Speichern der Argumente einer Funktion und zum Zugriff auf diese Argumente.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="8" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein arguments-Objekt dient zum Speichern der Argumente einer Funktion und zum Zugriff auf diese Argumente. |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein arguments-Objekt dient zum Speichern der Argumente einer Funktion und zum Zugriff auf diese Argumente. Im Hauptabschnitt einer Funktion können Sie auf ihr arguments-Objekt zugreifen, indem Sie die Variable für lokale Argumente verwenden. |
| <p class="- topic/p "> |
| Die Argumente werden als Arrayelemente gespeichert: Das erste ist über <codeph class="+ topic/ph pr-d/codeph ">arguments[0]</codeph> zugänglich, das zweite über <codeph class="+ topic/ph pr-d/codeph ">arguments[1]</codeph> usw. Die <codeph class="+ topic/ph pr-d/codeph ">arguments.length</codeph>-Eigenschaft gibt die Anzahl der an die Funktion übergebenen Argumente an. Die Anzahl der übergebenen Argumente muss jedoch nicht unbedingt mit der in der Funktion deklarierten Anzahl übereinstimmen. |
| </p> |
| <p class="- topic/p "> |
| Im Gegensatz zu früheren ActionScript-Versionen besitzt ActionScript 3.0 keine <codeph class="+ topic/ph pr-d/codeph ">arguments.caller</codeph>-Eigenschaft. Um auf die Funktion zu verweisen, die die aktuelle aufgerufen hat, müssen Sie einen Verweis auf diese Funktion als Argument übergeben. Ein Beispiel für diese Technik finden Sie im Beispiel für <codeph class="+ topic/ph pr-d/codeph ">arguments.callee</codeph>. |
| </p> |
| <p class="- topic/p ">ActionScript 3.0 umfasst ein neues <codeph class="+ topic/ph pr-d/codeph ">...(rest)</codeph>-Schlüsselwort, das anstelle der arguments-Klasse empfohlen wird.</p> |
| |
| </apiDesc><example conref="examples\ArgumentsExample.as" class="- topic/example "> Das folgende Beispiel veranschaulicht die Verwendung von verschiedenen <codeph class="+ topic/ph pr-d/codeph ">arguments</codeph>-Eigenschaften, wie etwa <codeph class="+ topic/ph pr-d/codeph ">callee</codeph> und <codeph class="+ topic/ph pr-d/codeph ">length</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ArgumentsExample extends Sprite { |
| public function ArgumentsExample() { |
| println("Hello World"); |
| } |
| |
| public function println(str:String):void { |
| trace(arguments.callee == this.println); // true |
| trace(arguments.length); // 1 |
| trace(arguments[0]); // Hello World |
| trace(str); // Hello World |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="statements.html#..._(rest)_parameter" class="- topic/link "><linktext class="- topic/linktext ">...(rest)</linktext></link><link href="#Function" class="- topic/link "><linktext class="- topic/linktext ">Funktion</linktext></link></related-links><apiValue id="arguments:callee" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">callee</apiName><shortdesc class="- topic/shortdesc "> |
| Ein Verweis auf die derzeit ausgeführte Funktion.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="8" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Function</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Ein Verweis auf die derzeit ausgeführte Funktion. |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein Verweis auf die derzeit ausgeführte Funktion. |
| |
| </apiDesc><example conref="examples\arguments.callee.1.as" class="- topic/example "> Im folgenden Code wird veranschaulicht, wie ein Verweis auf die Funktion hergestellt wird, durch die die Funktion <codeph class="+ topic/ph pr-d/codeph ">secondFunction()</codeph> aufgerufen wird. Die <codeph class="+ topic/ph pr-d/codeph ">firstFunction()</codeph>-Funktion enthält das boolesche Argument<codeph class="+ topic/ph pr-d/codeph ">true</codeph>, um zu demonstrieren, dass <codeph class="+ topic/ph pr-d/codeph ">secondFunction()</codeph> erfolgreich <codeph class="+ topic/ph pr-d/codeph ">firstFunction()</codeph> aufruft, und um eine Endlosschleife zu verhindern, in der eine Funktion die andere aufruft. |
| |
| <p class="- topic/p ">Da der <codeph class="+ topic/ph pr-d/codeph ">callSecond</codeph>-Parameter <codeph class="+ topic/ph pr-d/codeph ">true</codeph> lautet, ruft <codeph class="+ topic/ph pr-d/codeph ">firstFunction()</codeph> die <codeph class="+ topic/ph pr-d/codeph ">secondFunction()</codeph>-Funktion auf und übergibt als einziges Argument einen Verweis auf sich selbst. Die <codeph class="+ topic/ph pr-d/codeph ">secondFunction()</codeph>-Funktion empfängt dieses Argument und speichert es mithilfe des Parameters <codeph class="+ topic/ph pr-d/codeph ">caller</codeph>, der den Datentyp Function aufweist. Anschließend wird aus der <codeph class="+ topic/ph pr-d/codeph ">secondFunction()</codeph>-Funktion heraus mit dem <codeph class="+ topic/ph pr-d/codeph ">caller</codeph>-Parameter die <codeph class="+ topic/ph pr-d/codeph ">firstFunction</codeph>-Funktion aufgerufen. Dieses Mal ist das Argument <codeph class="+ topic/ph pr-d/codeph ">callSecond</codeph> jedoch auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph> gesetzt.</p> |
| <p class="- topic/p ">Wenn die Ausführung zu <codeph class="+ topic/ph pr-d/codeph ">firstFunction()</codeph> zurückkehrt, wird die <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Anweisung ausgeführt, da <codeph class="+ topic/ph pr-d/codeph ">callSecond</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">false</codeph> aufweist.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ArgumentsExample extends Sprite { |
| private var count:int = 1; |
| |
| public function ArgumentsExample() { |
| firstFunction(true); |
| } |
| |
| public function firstFunction(callSecond:Boolean) { |
| trace(count + ": firstFunction"); |
| if(callSecond) { |
| secondFunction(arguments.callee); |
| } |
| else { |
| trace("CALLS STOPPED"); |
| } |
| } |
| |
| public function secondFunction(caller:Function) { |
| trace(count + ": secondFunction\n"); |
| count++; |
| caller(false); |
| } |
| } |
| } |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="arguments:length" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">length</apiName><shortdesc class="- topic/shortdesc "> |
| Anzahl der an die Funktion übergebenen Argumente.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="8" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Die Anzahl der an die Funktion übergebenen Parameter. |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Anzahl der an die Funktion übergebenen Argumente. Diese Anzahl kann von der in der Funktion deklarierten Anzahl abweichen. |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:String" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">String</apiName><shortdesc class="- topic/shortdesc "> |
| Die String-Klasse ist ein Datentyp, der einen String repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string object, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die String-Klasse ist ein Datentyp, der einen String repräsentiert. Die String-Klasse stellt Methoden und Eigenschaften bereit, die die Bearbeitung des Grunddatentyps String erlauben. Mit der Funktion <codeph class="+ topic/ph pr-d/codeph ">String()</codeph> können Sie den Wert jedes Objekts in ein Objekt mit dem Datentyp String umwandeln. |
| <p class="- topic/p "> |
| Da alle Stringindizes die Basis null haben, ist die Indexposition für das letzte Zeichen eines <codeph class="+ topic/ph pr-d/codeph ">x</codeph>-Strings <codeph class="+ topic/ph pr-d/codeph ">x.length - 1</codeph>. |
| </p><p class="- topic/p "> |
| Sie können jede Methode der String-Klasse aufrufen, ob Sie nun die Konstruktormethode <codeph class="+ topic/ph pr-d/codeph ">new String()</codeph> verwenden, um eine neue Stringvariable zu erstellen, oder einfach ein Stringliteral als Wert angeben. Im Gegensatz zu früheren ActionScript-Versionen, macht es keinen Unterschied, ob Sie den Konstruktor verwenden, die globale Funktion oder einfach einen Stringliteralwert zuweisen. Die folgenden Codezeilen sind äquivalent: |
| </p> |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var str:String = new String("foo"); |
| var str:String = "foo"; |
| var str:String = String("foo");</codeblock> |
| <p class="- topic/p ">Wenn Sie eine Stringvariable auf <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> setzen, erzwingt die Flash-Laufzeitumgebung für <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph>. Somit setzt die Anweisung</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| var s:String = undefined;</pre> |
| den Wert auf <codeph class="+ topic/ph pr-d/codeph ">null</codeph> statt <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>. Verwenden Sie die Funktion <codeph class="+ topic/ph pr-d/codeph ">String()</codeph>, wenn Sie <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> benötigen. |
| </apiDesc><example conref="examples\StringExample.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der StringExample- und StringHelper-Klassen veranschaulicht, wie verschiedene Methoden der String-Klasse eingesetzt werden. Dies wird in den folgenden Schritten erreicht: |
| <ol class="- topic/ol "><li class="- topic/li ">Der Konstruktor für StringExample deklariert mehrere lokale String-Instanzen, die mit verschiedenen Strings und einem neuen StringHelper-Objekt initialisiert werden.</li><li class="- topic/li ">Das StringHelper-Klasse weist die folgende Methoden auf: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>: Ruft die <codeph class="+ topic/ph pr-d/codeph ">split()</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">join()</codeph>-Methoden von String auf, um einen Teilstring des Strings zu entfernen, der mit einem neuen übergeben wurde.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">trim()</codeph>: Ruft sowohl <codeph class="+ topic/ph pr-d/codeph ">trimBack()</codeph> als auch <codeph class="+ topic/ph pr-d/codeph ">trimFront()</codeph> mithilfe der übergebenen Strings auf und gibt den aktualisierten String zurück.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">trimFront()</codeph>: Entfernt rekursiv alle Zeichen, die mit dem Parameter <codeph class="+ topic/ph pr-d/codeph ">char</codeph> übereinstimmen, und zwar vom Anfang des Strings in Richtung Ende, bis das erste Zeichen im String erreicht ist, das nicht mit <codeph class="+ topic/ph pr-d/codeph ">char</codeph> übereinstimmt, und gibt den aktualisierten String zurück.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">trimBack()</codeph>: Entfernt rekursiv alle Zeichen, die mit dem Parameter <codeph class="+ topic/ph pr-d/codeph ">char</codeph> übereinstimmen, und zwar vom Ende des Strings in Richtung Anfrang, bis das letzte Zeichen im String erreicht ist, das nicht mit <codeph class="+ topic/ph pr-d/codeph ">char</codeph> übereinstimmt, und gibt den aktualisierten String zurück.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">stringToCharacter()</codeph>: Gibt das erste Zeichen des übergebenen Strings zurück.</li></ul> |
| </li><li class="- topic/li ">Anschließend werden drei Strings erstellt, und zwar mithilfe der deklarierten Stringvariablen, mit einem Aufruf der <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>-Methode, um den zweiten String zu erstellen und mit <codeph class="+ topic/ph pr-d/codeph ">trim()</codeph>, um den dritten String zu erstellen.</li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| 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); |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="package.html#String()" class="- topic/link "><linktext class="- topic/linktext ">String(), globale Funktion</linktext></link></related-links><apiConstructor id="String:String" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">String</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues String-Objekt, das mit dem angegebenen String initialisiert wird.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, new string, new, constructor |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Ausgangswert des neuen String-Objekts. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues String-Objekt, das mit dem angegebenen String initialisiert wird. |
| |
| <p class="- topic/p "> |
| <b class="+ topic/ph hi-d/b ">Hinweis: </b>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. |
| </p> |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="String:AS3:charAt" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">charAt</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das Zeichen zurück, das sich an der durch den Parameter index angegebenen Position befindet.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.charat, charat, character at |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Zeichen mit der angegebenen Indexposition. Oder ein leerer String, wenn die angegebene Indexposition außerhalb des Bereichs der Indexpositionen dieses Strings liegt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">index</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Position eines Zeichens im String angibt. Die Position des ersten Zeichens wird durch <codeph class="+ topic/ph pr-d/codeph ">0</codeph> und die des letzten Zeichens durch <codeph class="+ topic/ph pr-d/codeph ">my_str.length - 1</codeph> angegeben. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das Zeichen zurück, das sich an der durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">index</codeph> angegebenen Position befindet. Wenn <codeph class="+ topic/ph pr-d/codeph ">index</codeph> keine Zahl zwischen 0 und <codeph class="+ topic/ph pr-d/codeph ">string.length - 1</codeph> ist, wird ein leerer String zurückgegeben. |
| <p class="- topic/p "> |
| Diese Methode ähnelt <codeph class="+ topic/ph pr-d/codeph ">String.charCodeAt()</codeph>, es wird jedoch ein ganzzahliger 16-Bit-Zeichencode zurückgegeben und kein Zeichen. |
| </p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/charCodeAt()" class="- topic/link "><linktext class="- topic/linktext ">charCodeAt()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:charCodeAt" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">charCodeAt</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den numerischen Unicode-Zeichencode des Zeichens an der angegebenen Indexposition zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.charcodeat, charcodeat, character code at |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt den numerischen Unicode-Zeichencode des Zeichens an der angegebenen Indexposition zurück. Oder <codeph class="+ topic/ph pr-d/codeph "> NaN</codeph>, wenn die angegebene Indexposition außerhalb des Bereichs der Indexpositionen dieses Strings liegt. |
| <p class="- topic/p ">Unicode-Werte sind in der <xref href="http://www.unicode.org/ucd/" scope="external" class="- topic/xref ">Unicode Character Database</xref>-Spezifikation definiert. </p> |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">index</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Position eines Zeichens im String angibt. Die Position des ersten Zeichens wird durch <codeph class="+ topic/ph pr-d/codeph ">0</codeph> und die des letzten Zeichens durch <codeph class="+ topic/ph pr-d/codeph ">my_str.length - 1</codeph> angegeben. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den numerischen Unicode-Zeichencode des Zeichens an der durch <codeph class="+ topic/ph pr-d/codeph ">index</codeph> festgelegten Stelle zurück. Wenn <codeph class="+ topic/ph pr-d/codeph ">index</codeph> keine Zahl zwischen 0 und <codeph class="+ topic/ph pr-d/codeph "> string.length - 1</codeph> ist, wird <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> zurückgegeben. |
| <p class="- topic/p "> |
| Diese Methode ähnelt <codeph class="+ topic/ph pr-d/codeph ">String.charAt()</codeph>, es wird jedoch ein ganzzahliger 16-Bit-Zeichencode zurückgegeben und nicht das eigentliche Zeichen. |
| </p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/charAt()" class="- topic/link "><linktext class="- topic/linktext ">charAt()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:concat" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">concat</apiName><shortdesc class="- topic/shortdesc "> |
| 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.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.concat, concat, concatenate |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein neuer String, für den dieser String mit den angegebenen Parametern verkettet wurde. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Null oder mehr zu verkettende Werte. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 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. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="String:AS3:fromCharCode" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">fromCharCode</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String mit den Zeichen zurück, die den in den Parametern angegebenen Unicode-Zeichencodes entsprechen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.fromcharcode, fromcharcode, from character code |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Stringwert des angegebenen Unicode-Zeichencodes. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">charCodes</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Reihe dezimaler Ganzzahlen, die Unicode-Werte repräsentieren. |
| <p class="- topic/p ">Unicode-Werte sind in der <xref href="http://www.unicode.org/ucd/" scope="external" class="- topic/xref ">Unicode Character Database</xref>-Spezifikation definiert. </p> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String mit den Zeichen zurück, die den in den Parametern angegebenen Unicode-Zeichencodes entsprechen. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="String:AS3:indexOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">indexOf</apiName><shortdesc class="- topic/shortdesc "> |
| Durchsucht den String und gibt die Position des ersten Vorkommens von „val“ nach (einschließlich) „startIndex“ innerhalb des aufrufenden Strings zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.indexof, indexof, index |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position des ersten Vorkommens des angegebenen Teilstrings oder <codeph class="+ topic/ph pr-d/codeph ">-1</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der String, nach dem gesucht werden soll. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine optionale Ganzzahl, die die Startindexposition der Suche angibt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Durchsucht den String und gibt die Position des ersten Vorkommens von <codeph class="+ topic/ph pr-d/codeph ">val</codeph> nach (einschließlich) <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> 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 <codeph class="+ topic/ph pr-d/codeph ">val</codeph> nicht gefunden wird, gibt die Methode -1 zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/lastIndexOf()" class="- topic/link "><linktext class="- topic/linktext ">lastIndexOf()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:lastIndexOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">lastIndexOf</apiName><shortdesc class="- topic/shortdesc "> |
| 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.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.lastindexof, lastindexof, last index of |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position des letzten Vorkommens des angegebenen Teilstrings oder -1, wenn er nicht gefunden wird. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">val</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der String, nach dem gesucht werden soll. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7FFFFFFF</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine optionale Ganzzahl, die angibt, von welcher Indexposition aus nach <codeph class="+ topic/ph pr-d/codeph ">val</codeph> gesucht werden soll. Standard ist der maximale für eine Indexposition erlaubte Wert. Wird <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> nicht angegeben, beginnt die Suche beim letzten Element im String. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Durchsucht den String von rechts nach links und gibt die Indexposition des letzten Vorkommens von <codeph class="+ topic/ph pr-d/codeph ">val</codeph> innerhalb des aufrufenden Strings zurück, das vor der <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph>-Position gefunden wurde. Die Indexposition basiert auf null, d. h., das erste Zeichen befindet sich auf Indexposition 0 und das letzte auf <codeph class="+ topic/ph pr-d/codeph ">string.length - 1</codeph>. Wenn <codeph class="+ topic/ph pr-d/codeph ">val</codeph> nicht gefunden wird, gibt die Methode <codeph class="+ topic/ph pr-d/codeph ">-1</codeph> zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/indexOf()" class="- topic/link "><linktext class="- topic/linktext ">indexOf()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:localeCompare" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">localeCompare</apiName><shortdesc class="- topic/shortdesc "> |
| Vergleicht die Sortierreihenfolge von zwei oder mehr Strings und gibt das Ergebnis des Vergleichs als Ganzzahl zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Wert 0, wenn die Strings gleich sind. Andernfalls eine negative Ganzzahl, wenn der ursprüngliche String vor dem Stringargument kommt und eine positive Ganzzahl, wenn das Stringargument vor dem ursprünglichen String kommt. In beiden Fällen repräsentieren die absoluten Werte den Unterschied zwischen den beiden Strings. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">other</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der zu vergleichende Stringwert. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">values</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Optionaler Satz von weiteren zu vergleichenden Strings. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 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 (<codeph class="+ topic/ph pr-d/codeph ">==</codeph>) oder Ungleichheit (<codeph class="+ topic/ph pr-d/codeph ">!=</codeph>) operators. Sind die Strings äquivalent, lautet der Rückgabewert 0. Kommt der ursprüngliche Stringwert vor dem durch <codeph class="+ topic/ph pr-d/codeph ">other</codeph> 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 <codeph class="+ topic/ph pr-d/codeph ">other</codeph>, ist der Rückgabewert eine positive Ganzzahl, deren absoluter Wert die Anzahl von Zeichen repräsentiert, die die beiden Stringwerte voneinander trennt. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="String:AS3:match" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">match</apiName><shortdesc class="- topic/shortdesc "> |
| Vergleicht das angegebene Muster (pattern) mit dem String.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><oldexample><pre xml:space="preserve" class="- topic/pre "><code> |
| var myPattern:RegExp = /sh./g; |
| // The dot (.) matches any character. |
| var str:String = "She sells seashells by the seashore."; |
| trace(str.match(myPattern)); |
| |
| // Output: she,sho |
| |
| myPattern = /sh./gi; |
| // This time, make it case insensitive (with the i flag). |
| str = "She sells seashells by the seashore."; |
| trace(str.match(myPattern)); |
| |
| // Output: She,she,sho |
| |
| myPattern = RegExp = new RegExp("sh(.)", "gi") |
| // Note the grouping parentheses. |
| str = "She sells seashells by the seashore."; |
| trace(str.match(myPattern)); |
| |
| // Output: She,e,she,e,sho,o |
| // Note that the result array is |
| // [[She,e],[she,e],[sho,o]] |
| </code></pre> |
| |
| </oldexample></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array an Strings, der aus allen Teilstrings in dem String besteht, die mit dem angegebenen Muster (<codeph class="+ topic/ph pr-d/codeph ">pattern</codeph>) übereinstimmen. |
| |
| <p class="- topic/p ">Handelt es sich bei <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> um einen regulären Ausdruck, um ein Array mit mehreren übereinstimmenden Teilsstrings zurückzugeben, muss in dem regulären Ausdruck das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (global) gesetzt sein: </p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (global) <i class="+ topic/ph hi-d/i ">nicht</i> gesetzt, enthält der Rückgabe-Array nicht mehr als eine Übereinstimmung und die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks bleibt unverändert.</li><li class="- topic/li ">Ist das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (global) <i class="+ topic/ph hi-d/i ">gesetzt</i>, beginnt die Methode die Suche am Anfang des Strings (Indexposition 0). Ist ein übereinstimmender Teilstring ein leerer String (was bei einem regulären Ausdruck wie <codeph class="+ topic/ph pr-d/codeph ">/x~~/</codeph> durchaus passieren kann), fügt die Methode diesen leeren String in das Array an Übereinstimmungen ein, und sucht dann an der nächsten Indexposition weiter. Die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks wird auf 0 gesetzt, nachdem die Methode abgeschlossen ist. </li></ul> |
| |
| <p class="- topic/p ">Wenn die Suche keinen Treffer ergibt, gibt die Methode ein leeres Array zurück. Wenn Sie keinen Wert oder einen nicht definierten Wert) als <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph>-Parameter angeben, gibt die Methode den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> zurück.</p> |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">pattern</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Muster, mit dem die Fundstelle übereinstimmen soll. Dabei kann es sich um einen beliebigen Objekttyp handeln, typischerweise wird aber ein String oder ein regulärer Ausdruck verwendet. Handelt es sich bei <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> weder um einen regulären Ausdruck noch um einen String, konvertiert die Methode den Wert in einen String, bevor sie ausgeführt wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Vergleicht das angegebene Muster (<codeph class="+ topic/ph pr-d/codeph ">pattern</codeph>) mit dem String. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#RegExp" class="- topic/link "><linktext class="- topic/linktext ">RegExp</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:replace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">replace</apiName><shortdesc class="- topic/shortdesc "> |
| Vergleicht das angegebene Muster mit dem String und gibt einen neuen String zurück, in dem die erste Übereinstimmung mit Muster durch den von „repl“ angegebenen Inhalt ersetzt ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Ergebnisstring. Beachten Sie, dass der Quellstring unverändert bleibt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">pattern</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Muster, mit dem die Fundstelle übereinstimmen soll. Dabei kann es sich um einen beliebigen Objekttyp handeln, typischerweise wird aber ein String oder ein regulärer Ausdruck verwendet. Wenn Sie für den Parameter <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> ein Objekt beliebigen Typs angeben (also weder String noch regulärer Ausdruck), wird die Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> auf den Parameter angewendet, und anschließend wird die Methode <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph> ausgeführt, wobei der Ergebnisstring als <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> verwendet wird. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">repl</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">In der Regel wird der String anstelle des übereinstimmenden Inhalts eingefügt. Sie können für diesen Parameter jedoch auch eine Funktion angeben. Wenn Sie eine Funktion angeben, wird der von der Funktion zurückgegebene String anstelle des übereinstimmenden Inhalts eingesetzt. |
| |
| <p class="- topic/p ">Wenn Sie für den Parameter <codeph class="+ topic/ph pr-d/codeph ">repl</codeph> einen String angeben und für den Parameter <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> einen regulären Ausdruck, können Sie die folgenden speziellen <i class="+ topic/ph hi-d/i ">$-Ersetzungscodes</i> im <codeph class="+ topic/ph pr-d/codeph ">repl</codeph>-String angeben.</p> |
| |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry NOWRAP="true" class="- topic/entry ">$ Code |
| </entry><entry class="- topic/entry ">Ersatztext |
| </entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$$</codeph> |
| </entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$</codeph> |
| </entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$&</codeph> |
| </entry><entry class="- topic/entry ">Der übereinstimmende Teilstring. |
| </entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$`</codeph> |
| </entry><entry class="- topic/entry ">Der Teil des Strings, der vor dem übereinstimmenden Teilstring kommt. Beachten Sie, dass dieser Code das nach links gerichtete, halbe Anführungszeichen ohne Tropfen (`) verwendet (und nicht das gerade, Anführungszeichen ohne Tropfen (') oder das nach linksgerichtete Anführungszeichen mit Tropfen (). |
| </entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$'</codeph> |
| </entry><entry class="- topic/entry ">Der Teil des Strings, der nach dem übereinstimmenden Teilstring kommt. Beachten Sie, dass dieser Code halbe Anführungszeichen ohne Tropfen (') verwendet. |
| </entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$</codeph><i class="+ topic/ph hi-d/i ">n</i> |
| </entry><entry class="- topic/entry ">Die <i class="+ topic/ph hi-d/i ">n</i>. erfasste, in Klammern eingeschlossene Gruppe, wobei <i class="+ topic/ph hi-d/i ">n</i> für eine Ziffer zwischen 1 und 9 steht und hinter <codeph class="+ topic/ph pr-d/codeph ">$</codeph><i class="+ topic/ph hi-d/i ">n</i> kein Dezimalpunkt steht. |
| </entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$</codeph><i class="+ topic/ph hi-d/i ">nn</i> |
| </entry><entry class="- topic/entry ">Die <i class="+ topic/ph hi-d/i ">nn</i>. erfasste, in Klammern eingeschlossene Gruppe, wobei <i class="+ topic/ph hi-d/i ">nn</i> für eine zweistellige Dezimalzahl (01-99) steht. Ist die <i class="+ topic/ph hi-d/i ">nn</i>. Erfassung nicht definiert, ist der Ersetzungstext ein leerer String. |
| </entry></row></tbody></tgroup></adobetable> |
| |
| <p class="- topic/p ">So zeigt das folgende Beispiel die Verwendung der Ersetzungscodes <codeph class="+ topic/ph pr-d/codeph ">$2</codeph> und <codeph class="+ topic/ph pr-d/codeph ">$1</codeph>, die die erste und zweite erfasste, übereinstimmende Gruppe repräsentieren:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">var str:String = "flip-flop"; |
| var pattern:RegExp = /(\w+)-(\w+)/g; |
| trace(str.replace(pattern, "$2-$1")); // flop-flip</codeblock> |
| |
| <p class="- topic/p ">Wenn Sie für <codeph class="+ topic/ph pr-d/codeph ">repl</codeph> eine Funktion angeben, übergibt die Methode <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph> die folgenden Parameter an die Funktion: |
| </p> |
| |
| <ul class="- topic/ul "><li class="- topic/li "> |
| Der übereinstimmende Teil des Strings. |
| </li><li class="- topic/li "> |
| Jede erfasste Übereinstimmung mit einer in Klammern eingeschlossene Gruppe wird als nächstes Argument bereitgestellt. Die Anzahl der in dieser Weise übergebenen Argumente hängt von der Anzahl der Übereinstimmungen mit einer in Klammern eingeschlossene Gruppe ab. Um die Anzahl der Übereinstimmungen mit einer in Klammern eingeschlossene Gruppe zu bestimmen, verwenden Sie <codeph class="+ topic/ph pr-d/codeph ">arguments.length - 3</codeph> innerhalb des Funktionscodes. |
| </li><li class="- topic/li "> |
| Die Indexposition im String, an der die Übereinstimmung beginnt. |
| </li><li class="- topic/li "> |
| Der vollständige String. |
| </li></ul> |
| |
| <p class="- topic/p ">Berücksichtigen Sie beispielsweise Folgendes:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| 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]; |
| }</codeblock> |
| |
| |
| <p class="- topic/p ">Der Aufruf an die Methode <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph> verwendet eine Funktion als <codeph class="+ topic/ph pr-d/codeph ">repl</codeph>-Parameter. Der reguläre Ausdruck (<codeph class="+ topic/ph pr-d/codeph ">/([a-z]([0-9]/g</codeph>) wird zweimal gefunden. Das erste Mal entspricht das Muster dem Teilstring <codeph class="+ topic/ph pr-d/codeph ">"abc12"</codeph>, und die folgende Liste an Argumenten wird an die Funktion übergeben: |
| </p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| {"abc12", "abc", "12", 0, "abc12 def34"}</codeblock> |
| |
| |
| <p class="- topic/p ">Das zweite Mal entspricht das Muster dem Teilstring <codeph class="+ topic/ph pr-d/codeph ">"def23"</codeph>, und die folgende Liste an Argumenten wird an die Funktion übergeben: |
| </p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| {"def34", "def", "34", 6, "abc123 def34"}</codeblock> |
| |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Vergleicht das angegebene <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> mit dem String und gibt einen neuen String zurück, in dem die erste Übereinstimmung mit <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> durch den von <codeph class="+ topic/ph pr-d/codeph ">repl</codeph> angegebenen Inhalt ersetzt ist. Der Parameter <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> kann ein String oder ein regulärer Ausdruck sein. Der Parameter <codeph class="+ topic/ph pr-d/codeph ">repl</codeph> 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. |
| |
| <p class="- topic/p ">Im folgenden Beispiel wird die erste Instanz von „sh“ ersetzt (wobei Groß-/Kleinschreibung beachtet wird): </p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myPattern:RegExp = /sh/; |
| var str:String = "She sells seashells by the seashore."; |
| trace(str.replace(myPattern, "sch")); |
| // She sells seaschells by the seashore.</codeblock> |
| |
| <p class="- topic/p ">Im folgenden Beispiel werden alle Instanzen von „sh“ (bei Beachtung der Groß-/Kleinschreibung) ersetzt, da im regulären Ausdruck das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (global) gesetzt ist. </p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| 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.</codeblock> |
| |
| <p class="- topic/p ">Im folgenden Beispiel werden alle Instanzen von „sh“ ersetzt, da im regulären Ausdruck das <codeph class="+ topic/ph pr-d/codeph ">g</codeph>-Flag (global) gesetzt ist, und die Groß-/Kleinschreibung wird <i class="+ topic/ph hi-d/i ">nicht</i> beachtet, da das <codeph class="+ topic/ph pr-d/codeph ">i</codeph>-Flag (ignorCase) gesetzt ist:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| 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.</codeblock> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#RegExp" class="- topic/link "><linktext class="- topic/linktext ">RegExp</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:search" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">search</apiName><shortdesc class="- topic/shortdesc "> |
| Sucht nach dem angegebenen Muster (pattern) und gibt die Indexposition des ersten übereinstimmenden Teilstrings zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><oldexample><pre xml:space="preserve" class="- topic/pre "><code> |
| var str:String = "She sells seashells by the seashore."; |
| var myPattern:RegExp = /sh/; |
| // This time, make it case insensitive (with the i flag). |
| trace(str.match(myPattern)); |
| |
| // Output: 13 |
| // (The substring match starts at character position 13.) |
| |
| var myPattern:RegExp = /sh/i; |
| trace(str.match(myPattern)); |
| |
| // Output: 0 |
| // (The substring match starts at character position 0 |
| // -- the first character of the source string.) |
| </code></pre> |
| |
| </oldexample></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Indexposition des ersten übereinstimmenden Teilstrings bzw. <codeph class="+ topic/ph pr-d/codeph ">-1</codeph>, wenn keine Übereinstimmung gefunden wird. Beachten Sie, dass der String nullindiziert ist, d. h., das erste Zeichen des Strings befindet sich auf Indexposition 0 und das letzte auf <codeph class="+ topic/ph pr-d/codeph ">string.length - 1</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">pattern</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Muster, mit dem die Fundstelle übereinstimmen soll. Dabei kann es sich um einen beliebigen Objekttyp handeln, typischerweise wird aber ein String oder ein regulärer Ausdruck verwendet. Handelt es sich bei <codeph class="+ topic/ph pr-d/codeph ">pattern</codeph> weder um einen regulären Ausdruck noch um einen String, konvertiert die Methode den Wert in einen String, bevor sie ausgeführt wird. Beachten Sie, dass die Methode bei regulären Ausdrücken das globale Flag („g“) ignoriert, und ebenso die <codeph class="+ topic/ph pr-d/codeph ">lastIndex</codeph>-Eigenschaft des regulären Ausdrucks ignoriert (und ihn unverändert lässt). Wenn Sie einen nicht definierten Wert (oder keinen Wert) übergeben, gibt die Methode den Wert <codeph class="+ topic/ph pr-d/codeph ">-1</codeph> zurück. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sucht nach dem angegebenen Muster (<codeph class="+ topic/ph pr-d/codeph ">pattern</codeph>) und gibt die Indexposition des ersten übereinstimmenden Teilstrings zurück. Gibt es keinen übereinstimmenden Teilstring, gibt die Methode den Wert <codeph class="+ topic/ph pr-d/codeph ">-1</codeph> zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#RegExp" class="- topic/link "><linktext class="- topic/linktext ">RegExp</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:slice" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">slice</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der das durch startIndex angegebene Zeichen und alle Zeichen bis zu dem durch endIndex angegebenen Zeichen (aber nicht einschließlich) enthält.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.slice, slice |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Teilstring, der auf den angegebenen Indexpositionen basiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Indexposition mit der Basis Null des Segmentanfangs. Ist <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> eine negative Zahl, wird das Segment von rechts nach links erstellt, wobei -1 das letzte Zeichen bezeichnet. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">endIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7fffffff</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die 1+ die Indexposition des Segmentendes angibt. Das durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> indizierte Zeichen wird nicht in den extrahierten String aufgenommen. Wenn <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> negativ ist, wird der Endpunkt ausgehend vom Ende des Strings ermittelt, wobei -1 das letzte Zeichen des Strings ist. Standard ist der maximale für eine Indexposition erlaubte Wert. Wenn Sie diesen Parameter weglassen, wird <codeph class="+ topic/ph pr-d/codeph ">String.length</codeph> verwendet. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der das durch <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> angegebene Zeichen und alle Zeichen bis zu dem durch <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> angegebenen Zeichen (jedoch nicht einschließlich) enthält. Das ursprüngliche String-Objekt wird nicht geändert. Wenn der Parameter <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> nicht angegeben wird, endet der Teilstring am Ende des Strings. Wenn das durch <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> indizierte Zeichen mit dem durch <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> indizierten Zeichen übereinstimmt oder rechts von diesem liegt, gibt die Methode einen leeren String zurück. |
| |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/substr()" class="- topic/link "><linktext class="- topic/linktext ">substr()</linktext></link><link href="#String/substring()" class="- topic/link "><linktext class="- topic/linktext ">substring()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:split" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">split</apiName><shortdesc class="- topic/shortdesc "> |
| Unterteilt ein String-Objekt in ein Array an Teilstrings, und immer dort, wo der Parameter „delimiter“ vorkommt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.split, split |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array mit Teilstrings. |
| |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">delimiter</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Muster, das angibt, wo dieser String aufgeteilt werden soll. Dabei kann es sich um einen beliebigen Objekttyp handeln, typischerweise wird aber ein String oder ein regulärer Ausdruck verwendet. Handelt es sich bei <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> weder um einen regulären Ausdruck noch um einen String, konvertiert die Methode den Wert in einen String, bevor sie ausgeführt wird. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">limit</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7fffffff</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die maximale Anzahl von Elementen, die in das Array platziert werden sollen. Standard ist der zulässige Höchstwert. |
| |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Unterteilt ein String-Objekt in ein Array an Teilstrings, und immer dort, wo der Parameter <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> vorkommt. |
| |
| <p class="- topic/p ">Handelt es sich beim Parameter <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> 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:</p> |
| |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var str:String = "ab"; |
| var results:Array = str.split(/a~~?/); // results == ["","b"] |
| |
| results = str.split(/a~~/); // results == ["","b"].)</codeblock> |
| |
| |
| <p class="- topic/p ">Handelt es sich beim Parameter <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> 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 <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> gesucht wird. Beispiel</p> |
| |
| <codeblock rev="3.0" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| 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."]</codeblock> |
| |
| |
| <p class="- topic/p ">Wird der Parameter <codeph class="+ topic/ph pr-d/codeph ">limit</codeph> angegeben, wird der zurückgegebene Array nichts anderes als die angegebene Anzahl an Elementen enthalten.</p> |
| <p class="- topic/p ">Wenn <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> 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.</p> |
| |
| <p class="- topic/p ">Wenn der Parameter <codeph class="+ topic/ph pr-d/codeph ">delimiter</codeph> nicht definiert ist, wird der gesamte String in das erste Element des zurückgegebenen Arrays gestellt. </p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array/join()" class="- topic/link "><linktext class="- topic/linktext ">Array.join()</linktext></link><link href="#RegExp" class="- topic/link "><linktext class="- topic/linktext ">RegExp</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:substr" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">substr</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen Teilstring zurück, der aus den Zeichen besteht, die an dem angegebenen startIndex beginnen und eine durch „len“ festgelegte Länge besitzen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.substr, substr, substring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Teilstring, der auf den Parametern basiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Indexposition des ersten Zeichens angibt, das zum Erstellen des Teilstrings verwendet werden soll. Wenn <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> negativ ist, wird der Anfangsindex ausgehend vom Ende des Strings ermittelt, wobei <codeph class="+ topic/ph pr-d/codeph ">-1</codeph> das letzte Zeichen des Strings ist. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">len</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7fffffff</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Anzahl der in den Teilstring aufzunehmenden Zeichen. Standard ist der zulässige Höchstwert. Wenn <codeph class="+ topic/ph pr-d/codeph ">len</codeph> nicht angegeben wird, enthält der Teilstring alle Zeichen von <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> bis zum Ende des Strings. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen Teilstring zurück, der aus den Zeichen besteht, die an dem angegebenen <codeph class="+ topic/ph pr-d/codeph "> startIndex</codeph> beginnen und eine durch <codeph class="+ topic/ph pr-d/codeph ">len</codeph> festgelegte Länge besitzen. Der ursprüngliche String bleibt unverändert. |
| |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="String:AS3:substring" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">substring</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der aus dem von „startIndex“ angegebenen Zeichen und allen Zeichen bis zu endIndex - 1 besteht.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.substring, substring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Teilstring, der auf den Parametern basiert. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Indexposition des ersten Zeichens angibt, das zum Erstellen des Teilstrings verwendet wird. Gültige Werte für <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> sind <codeph class="+ topic/ph pr-d/codeph ">0</codeph> bis <codeph class="+ topic/ph pr-d/codeph ">String.length</codeph>. Ist <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> ein negativer Wert, wird <codeph class="+ topic/ph pr-d/codeph ">0 </codeph> verwendet. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">endIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7fffffff</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die 1+ die Indexposition des letzten Zeichens im extrahierten String angibt. Gültige Werte für <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> sind <codeph class="+ topic/ph pr-d/codeph ">0</codeph> bis <codeph class="+ topic/ph pr-d/codeph ">String.length</codeph>. Das bei <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> angegebene Zeichen ist nicht im Teilstring enthalten. Standard ist der maximale für eine Indexposition erlaubte Wert. Wenn Sie diesen Parameter weglassen, wird <codeph class="+ topic/ph pr-d/codeph ">String.length</codeph> verwendet. Wenn dieser Parameter ein negativer Wert ist, wird <codeph class="+ topic/ph pr-d/codeph ">0</codeph> verwendet. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der aus dem von <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> angegebenen Zeichen und allen Zeichen bis zu <codeph class="+ topic/ph pr-d/codeph ">endIndex - 1</codeph> besteht. Wenn <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> nicht angegeben ist, wird <codeph class="+ topic/ph pr-d/codeph ">String.length</codeph> verwendet. Wenn die Werte von <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> und <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> identisch sind, gibt die Methode einen leeren String zurück. Wenn der Wert von <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> größer ist als der Wert von <codeph class="+ topic/ph pr-d/codeph "> endIndex</codeph>, werden die Parameter vor Ausführung der Funktion automatisch ausgetauscht. Der ursprüngliche String bleibt unverändert. |
| |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="String:AS3:toLocaleLowerCase" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleLowerCase</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Kopie dieses Strings zurück, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Kopie dieses Strings, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 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 <codeph class="+ topic/ph pr-d/codeph ">toLowerCase()</codeph>. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/toLowerCase()" class="- topic/link "><linktext class="- topic/linktext ">toLowerCase()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:toLocaleUpperCase" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleUpperCase</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Kopie dieses Strings zurück, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Kopie dieses Strings, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 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 <codeph class="+ topic/ph pr-d/codeph ">toUpperCase()</codeph>. |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/toUpperCase()" class="- topic/link "><linktext class="- topic/linktext ">toUpperCase()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:toLowerCase" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLowerCase</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Kopie dieses Strings zurück, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.tolowercase, tolowercase, to lowercase |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Kopie dieses Strings, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Kopie dieses Strings zurück, in der alle Großbuchstaben in Kleinbuchstaben umgewandelt wurden. Der ursprüngliche String bleibt unverändert. |
| |
| <p class="- topic/p ">Diese Methode konvertiert alle Zeichen (nicht einfach A–Z), für die es in Unicode Kleinbuchstaben gibt:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var str:String = " JOSÉ BARÇA"; |
| trace(str.toLowerCase()); // josé barça</codeblock> |
| |
| <p class="- topic/p ">Diese Zuordnungen von Groß- und Kleinbuchstaben sind in der <xref href="http://www.unicode.org/ucd/" scope="external" class="- topic/xref ">Unicode Character Database</xref>-Spezifikation definiert. </p> |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/toUpperCase()" class="- topic/link "><linktext class="- topic/linktext ">toUpperCase()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:toUpperCase" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toUpperCase</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Kopie dieses Strings zurück, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.touppercase, touppercase, to uppercase |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Kopie dieses Strings, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden. |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Kopie dieses Strings zurück, in der alle Kleinbuchstaben in Großbuchstaben umgewandelt wurden. Der ursprüngliche String bleibt unverändert. |
| |
| <p class="- topic/p ">Diese Methode konvertiert alle Zeichen (nicht einfach a–z), für die es in Unicode Großbuchstaben gibt:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var str:String = "José Barça"; |
| trace(str.toUpperCase()); // JOSÉ BARÇA</codeblock> |
| |
| <p class="- topic/p ">Diese Zuordnungen von Groß- und Kleinbuchstaben sind in der <xref href="http://www.unicode.org/ucd/" scope="external" class="- topic/xref ">Unicode Character Database</xref>-Spezifikation definiert. </p> |
| |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/toLowerCase()" class="- topic/link "><linktext class="- topic/linktext ">toLowerCase()</linktext></link></related-links></apiOperation><apiOperation id="String:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Grundwert einer String-Instanz zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><oldexample>The following example creates a new instance of the String class |
| and then shows that the <code>valueOf</code> method returns |
| the <i class="+ topic/ph hi-d/i ">primitive</i> value, rather than a reference to the new instance. |
| |
| <listing version="2.0"> |
| var str:String = new String("Hello World"); |
| var value:String = str.valueOf(); |
| trace(str instanceof String); // true |
| trace(value instanceof String); // false |
| trace(str === value); // false</listing> |
| |
| |
| </oldexample></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Wert des Strings. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| 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, <codeph class="+ topic/ph pr-d/codeph ">valueOf()</codeph> automatisch aufrufen, kommt es selten vor, dass Sie diese Methode explizit aufrufen müssen. |
| |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="String:length:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">length</apiName><shortdesc class="- topic/shortdesc "> |
| Eine Ganzzahl, die die Anzahl der Zeichen im angegebenen String-Objekt angibt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">string, string.length, length |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="read" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Eine Ganzzahl, die die Anzahl der Zeichen im angegebenen String-Objekt angibt. |
| <p class="- topic/p "> |
| Da alle Stringindizes die Basis null haben, ist die Indexposition für das letzte Zeichen eines <codeph class="+ topic/ph pr-d/codeph ">x</codeph>-Strings <codeph class="+ topic/ph pr-d/codeph ">x.length - 1</codeph>. |
| </p> |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:Class" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Class</apiName><shortdesc class="- topic/shortdesc "> |
| Ein Class-Objekt wird für jede Klassendefinition in einem Programm erstellt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Class |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein Class-Objekt wird für jede Klassendefinition in einem Programm erstellt. Jedes Class-Objekt ist eine Instanz der Class-Klasse. Das Class-Objekt enthält die statischen Eigenschaften und Methoden der Klasse. Das Klassenobjekt erstellt Instanzen der Klasse, wenn es mit dem Operator <codeph class="+ topic/ph pr-d/codeph ">new</codeph> erstellt worden ist. |
| |
| <p class="- topic/p ">Einige Methoden, wie etwa <codeph class="+ topic/ph pr-d/codeph ">flash.net.getClassByAlias()</codeph> geben ein Objekt vom Class-Typ zurück. Andere Methoden haben einen Parameter vom Class-Typ, z. B. <codeph class="+ topic/ph pr-d/codeph ">flash.net.registerClassAlias()</codeph>. </p> |
| <p class="- topic/p ">Der Name der Klasse ist der Verweis auf das Class-Objekt, wie das folgende Beispiel veranschaulicht:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| class Foo { |
| } |
| </pre> |
| <p class="- topic/p ">Die Anweisung <codeph class="+ topic/ph pr-d/codeph ">class Foo{}</codeph> ist die Klassendefinition, die dass Class-Objekt Foo erstellt. Außerdem wird die Anwendung <codeph class="+ topic/ph pr-d/codeph ">new Foo()</codeph> eine neue Instanz der Foo-Klasse erstellen, und das Ergebnis wird vom Typ Foo sein.</p> |
| <p class="- topic/p ">Verwenden Sie die Anwendung <codeph class="+ topic/ph pr-d/codeph ">class</codeph>, um Ihre Klasse zu deklarieren. Class-Objekte sind nützlich für fortgeschrittene Techniken wie das Zuweisen von Klassen zu einem vorhandenen Instanzobjekt während der Laufzeit (vgl. den Abschnitt „Beispiele“ weiter unten).</p> |
| <p class="- topic/p ">Statische Eigenschaften und Methoden einer Klasse befinden sich im Class-Objekt einer Klasse. „Class“ selbst deklariert <codeph class="+ topic/ph pr-d/codeph ">prototype</codeph>.</p> |
| |
| <p class="- topic/p ">Im Allgemeinen müssen Sie Variablen vom Typ Class nicht manuell deklarieren. Im nachfolgenden Code jedoch wird eine Klasse als öffentliche Class-Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">circleClass</codeph> zugewiesen, und Sie können auf diese Class-Eigenschaft als eine Eigenschaft der Hauptklasse Library verweisen.</p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| public class Library extends Sprite { |
| |
| public var circleClass:Class = Circle; |
| public function Library() { |
| } |
| } |
| } |
| |
| import flash.display.Shape; |
| class Circle extends Shape { |
| public function Circle(color:uint = 0xFFCC00, radius:Number = 10) { |
| graphics.beginFill(color); |
| graphics.drawCircle(radius, radius, radius); |
| } |
| } |
| </codeblock> |
| |
| <p class="- topic/p ">Eine andere SWF-Datei kann die resultierende Datei „Library.swf“ laden und dann Objekte vom Typ Circle instanziieren. Das folgende Beispiel zeigt eine Möglichkeit, auf die Bestände einer untergeordneten SWF-Datei zuzugreifen. (Andere mögliche Verfahren sind die Verwendung von <codeph class="+ topic/ph pr-d/codeph ">flash.utils.getDefnitionByName()</codeph> oder das Importieren von Teildefinitionen aus der untergeordneten SWF-Datei.)</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| import flash.display.Shape; |
| import flash.display.Loader; |
| import flash.net.URLRequest; |
| import flash.events.Event; |
| public class LibaryLoader extends Sprite { |
| public function LibaryLoader() { |
| var ldr:Loader = new Loader(); |
| var urlReq:URLRequest = new URLRequest("Library.swf"); |
| ldr.load(urlReq); |
| ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, loaded); |
| } |
| private function loaded(event:Event):void { |
| var library:Object = event.target.content; |
| var circle:Shape = new library.circleClass(); |
| addChild(circle); |
| } |
| } |
| } |
| </codeblock> |
| <p class="- topic/p ">In ActionScript 3.0 können Sie für externe Bestände (wie Grafiken, Sounds oder Schriften) eingebettete Klassen erstellen, die in SWF-Dateien kompiliert werden. In früheren ActionScript-Versionen haben Sie diese Bestände verknüpft, indem Sie in der Methode <codeph class="+ topic/ph pr-d/codeph ">MovieClip.attachMovie()</codeph> eine Verknüpfungs-ID verwendet haben. In ActionScript 3.0 wird jeder eingebettete Bestand durch eine einmalige eingebettete Bestandklasse repräsentiert. Daher können Sie die mit dem Bestand verbundene Klasse mithilfe des Operators <codeph class="+ topic/ph pr-d/codeph ">new</codeph> instanziieren und für diesen Bestandsartikel Methoden und Eigenschaft aufrufen.</p> |
| <p product="flex" class="- topic/p ">Wenn Sie beispielsweise SWF-Dateien mit einem MXML-Compiler erstellen, würden Sie eine eingebettete Klasse folgendermaßen erstellen:</p> |
| <codeblock product="flex" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| [Embed(source="bratwurst.jpg")] |
| public var imgClass:Class; |
| </codeblock> |
| <p product="flex" class="- topic/p ">Zum Instanziieren schreiben Sie Folgendes:</p> |
| <codeblock product="flex" xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var myImg:Bitmap = new imgClass(); |
| </codeblock> |
| |
| </apiDesc><example conref="examples\Class.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie Sie mit Class-Objekten die Entscheidung darüber, welche Klasse instanziiert werden soll, bis zur Laufzeit zurückstellen können. Führen Sie dazu die folgenden Schritte aus: |
| <ol class="- topic/ol "><li class="- topic/li ">Deklarieren Sie zwei Klassen: <codeph class="+ topic/ph pr-d/codeph ">ClassA</codeph> und <codeph class="+ topic/ph pr-d/codeph ">ClassB</codeph>. </li><li class="- topic/li ">Deklarieren Sie eine Variablen vom Typ Class mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">classToConstruct</codeph> und eine vom Typ Boolean <codeph class="+ topic/ph pr-d/codeph ">chooseClassA</codeph>, die in diesem Fall auf <codeph class="+ topic/ph pr-d/codeph ">true</codeph> gesetzt ist. Sie können den Wert dieser Variablen jedoch auch mit einen benutzerdefinierten Test-Ausdruck festlegen. </li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class ClassExample extends Sprite { |
| public function ClassExample() { |
| var classToConstruct:Class; |
| var classInstance:Object; |
| |
| classToConstruct = ClassA; |
| classInstance = new classToConstruct(); |
| trace(classInstance); // [object ClassA] |
| |
| classToConstruct = ClassB; |
| classInstance = new classToConstruct(); |
| trace(classInstance); // [object ClassB] |
| } |
| } |
| } |
| |
| class ClassA { |
| } |
| |
| class ClassB { |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#Object/prototype" class="- topic/link "><linktext class="- topic/linktext ">Object.prototype</linktext></link><link href="operators.html#new" class="- topic/link "><linktext class="- topic/linktext ">new-Operator</linktext></link></related-links></apiClassifier><apiClassifier languages="" id="globalClassifier:Namespace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Namespace</apiName><shortdesc class="- topic/shortdesc "> |
| |
| Die Namespace-Klasse enthält Methoden und Eigenschaften für die Definition und Verwendung von Namespaces (Namensräumen).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Namespace |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Die Namespace-Klasse enthält Methoden und Eigenschaften für die Definition und Verwendung von Namespaces von XML-Objekten. |
| |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| |
| Die Namespace-Klasse enthält Methoden und Eigenschaften für die Definition und Verwendung von Namespaces (Namensräumen). Es gibt drei Situationen, in denen Namespaces verwendet werden: |
| |
| <ul class="- topic/ul "><li class="- topic/li "> <b class="+ topic/ph hi-d/b ">Namespaces von XML-Objekten.</b> Namespaces ordnen ein Namespacepräfix einem URI (Uniform Resource Identifier, einheitlicher Ressourcenlokator) zu, der den Namespace identifiziert. Das Präfix ist ein String, der verwendet wird, um innerhalb eines XML-Objekts auf den Namespace zu verweisen. Ist das Präfix nicht definiert, wenn das XML-Objekt in einen String konvertiert wird, wird ein Präfix automatisch erzeugt. |
| </li><li class="- topic/li "> <b class="+ topic/ph hi-d/b ">Namespaces zum Unterscheiden von Methoden.</b> Namespaces können Methoden mit demselben Namen unterscheiden, die aber unterschiedliche Aufgaben wahrnehmen. Besitzen zwei Methoden denselben Namen, aber unterschiedliche Namespaces, so können Sie unterschiedliche Aufgaben durchführen. |
| </li><li class="- topic/li "> <b class="+ topic/ph hi-d/b ">Namespaces für die Zugriffskontrolle.</b> Namespaces können verwendet werden, um auf eine Gruppe von Eigenschaften und Methoden in einer Klasse zuzugreifen. Wenn Sie die Eigenschaften und Methoden in einen „private“-Namespace setzen, sind sie für jeglichen Code, der keine Zugriffsberechtigung zu diesem Namespace hat, unzugänglich. Sie können Zugriff zu dieser Gruppe an Eigenschaften und Methoden gewähren, indem Sie den Namespace auch an andere Klassen, Methoden oder Funktionen übergeben. |
| </li></ul> |
| |
| <p class="- topic/p ">Diese Klasse zeigt zwei Formen der Konstruktormethode, da jede Form andere Parameter akzeptiert.</p> |
| |
| <p class="- topic/p ">Diese Klasse implementiert (zusammen mit den Klassen XML, XMLList und QName) leistungsstarke Standards zur XML-Verarbeitung, die in der Spezifikation ECMA-357, Edition 2: „ECMAScript for XML (E4X)“ definiert sind.</p> |
| |
| </apiDesc><example conref="examples\NamespaceExample.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Sie mit in XML-Objekten definierten Namespaces arbeiten. Dies wird in den folgenden Schritten erreicht: |
| <ol class="- topic/ol "><li class="- topic/li ">In diesem Beispiel werden drei Namespace-Objekte definiert, und zwar jeweils mit einer den Namespace definierenden eindeutigen URI.</li><li class="- topic/li ">In diesem Beispiel wird eine XML-Variable mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myXML</codeph> definiert und dem Rückgabewert <codeph class="+ topic/ph pr-d/codeph ">getRSS()</codeph> zugewiesen. Die <codeph class="+ topic/ph pr-d/codeph ">getRSS()</codeph>-Methode definiert ein XML-Objekt, das mehrere Namespaces enthält, und gibt dieses XML-Objekt zurück.</li><li class="- topic/li ">Eine Array-Variable wird deklariert und bewertet, indem die Methode <codeph class="+ topic/ph pr-d/codeph ">parseRSS()</codeph> aufgerufen und an die<codeph class="+ topic/ph pr-d/codeph ">myXML</codeph> übergeben wird. Der Standard-XML-Namespace wird in <codeph class="+ topic/ph pr-d/codeph ">parseRSS()</codeph> als <codeph class="+ topic/ph pr-d/codeph ">rss</codeph> definiert. Im Beispiel wird durch Zuweisen der Liste der <codeph class="+ topic/ph pr-d/codeph ">item</codeph>-Objekte in <codeph class="+ topic/ph pr-d/codeph ">myXML</codeph> eine XMLList-Variable definiert. Ein Array wird mit verschiedenen Knoten innerhalb von <codeph class="+ topic/ph pr-d/codeph ">myXML.item</codeph> erstellt und gefüllt. Anschließend wird das Array zurückgegeben.</li><li class="- topic/li ">Der Ausdruck der im Array enthaltenen Elemente erfolgt mithilfe einer <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife und von drei Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>.</li></ol> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class NamespaceExample extends Sprite { |
| private var rss:Namespace = new Namespace("http://purl.org/rss/1.0/"); |
| private var rdf:Namespace = new Namespace("http://www.w3.org/1999/02/22-rdf-syntax-ns#"); |
| private var dc:Namespace = new Namespace("http://purl.org/dc/elements/1.1/"); |
| |
| public function NamespaceExample() { |
| var myXML:XML = getRSS(); |
| var rssItems:Array = parseRSS(myXML); |
| |
| var len:uint = rssItems.length; |
| for (var i:uint; i < len; i++) { |
| trace(rssItems[i].title); |
| trace(rssItems[i].creator); |
| trace(rssItems[i].date); |
| // Adobe Flash Developer Center |
| // Adobe |
| // 2005-08-08 |
| // Flex Developer Center |
| // Adobe |
| // 2005-10-16 |
| } |
| } |
| |
| private function parseRSS(rssXML:XML):Array { |
| default xml namespace = rss; |
| |
| var items:XMLList = rssXML.item; |
| |
| var arr:Array = new Array(); |
| var len:uint = items.length(); |
| for (var i:uint; i < len; i++) { |
| arr.push({title:items[i].title, creator:items[i].dc::creator, date:items[i].dc::date}); |
| } |
| |
| return arr; |
| } |
| |
| private function getRSS():XML { |
| var myXML:XML = <rdf:RDF |
| xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
| xmlns="http://purl.org/rss/1.0/" |
| xmlns:dc="http://purl.org/dc/elements/1.1/" |
| > |
| <channel rdf:about="http://www.xml.com/cs/xml/query/q/19"> |
| <title>Test RSS</title> |
| <link>http://www.adobe.com/</link> |
| <description>This is a test RSS document.</description> |
| <language>en-us</language> |
| <items> |
| <rdf:Seq> |
| <rdf:li rdf:resource="http://www.adobe.com/devnet/flash/"/> |
| <rdf:li rdf:resource="http://www.adobe.com/devnet/flex/"/> |
| </rdf:Seq> |
| </items> |
| </channel> |
| <item rdf:about="http://www.adobe.com/devnet/flash/"> |
| <title>Adobe Flash Developer Center</title> |
| <link>http://www.adobe.com/devnet/flash/</link> |
| <description>Welcome to the Flash Developer Center</description> |
| <dc:creator>Adobe</dc:creator> |
| <dc:date>2005-08-08</dc:date> |
| </item> |
| <item rdf:about="http://www.adobe.com/devnet/flex/"> |
| <title>Flex Developer Center</title> |
| <link>http://www.adobe.com/devnet/flex/</link> |
| <description>Welcome to the Flex Developer Center</description> |
| <dc:creator>Adobe</dc:creator> |
| <dc:date>2005-10-16</dc:date> |
| </item> |
| </rdf:RDF>; |
| |
| return myXML; |
| } |
| } |
| } |
| </codeblock></example><example conref="examples\Namespace_2_Example.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Methoden, die den gleichen Namen haben, aber verschiedene Aufgaben ausführen, mithilfe von Namespaces unterschieden werden können. Im Rahmen dieses Beispiels befinden sich drei Methoden namens <codeph class="+ topic/ph pr-d/codeph ">hello()</codeph> in separaten Namespaces; bei jedem Aufruf wird ein anderer String zurückgegeben. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| |
| import flash.display.Sprite; |
| |
| public class Namespace_2_Example extends Sprite { |
| public function Namespace_2_Example() { |
| var vocab:MultilingualVocabulary = new MultilingualVocabulary(); |
| |
| trace(vocab.hello()); // hello |
| |
| var languages:Array = vocab.getLanguages(); |
| |
| for (var i:uint; i < languages.length; i++) { |
| var ns:Namespace = languages[i]; |
| if (ns != null) { |
| trace(ns.toString() + ": " + vocab.ns::hello()); |
| // hello |
| // MultilingualVocabulary:Hawaiian: aloha |
| // MultilingualVocabulary:French: bon jour |
| } |
| } |
| } |
| } |
| } |
| |
| class MultilingualVocabulary { |
| public namespace French; |
| public namespace Hawaiian; |
| private var languages:Array; |
| |
| public function MultilingualVocabulary() { |
| languages = new Array(Hawaiian, French); |
| } |
| |
| public function hello():String { |
| return "hello"; |
| } |
| |
| Hawaiian function hello():String { |
| return "aloha"; |
| } |
| |
| French function hello():String { |
| return "bon jour"; |
| } |
| |
| public function getLanguages():Array { |
| return languages; |
| } |
| } |
| </codeblock></example><example conref="examples\Namespace_3_Example.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe von Namespace-Namen der entsprechende Variablenwert ausgewählt. Es wird veranschaulicht, wie Sie einen Namespace-Wert in einer Variable speichern und mit dieser Variablen auf Objekte in diesem Namespace verweisen. |
| <p class="- topic/p ">In diesem Beispiel werden Namespaces und Farben definiert, die den Mauszuständen für eine rechteckige Schaltfläche entsprechen. Bei jedem Zeichnen der Schaltfläche wird die entsprechende Farbe („out“ (Deaktiviert) ist Rot; „over“ (Darüber) ist Gelb; „down“ (Gedrückt) ist Weiß) angewendet, indem die <codeph class="+ topic/ph pr-d/codeph ">bgcolor</codeph>-Variable auf den entsprechenden Namespace verweist (<codeph class="+ topic/ph pr-d/codeph ">out</codeph>, <codeph class="+ topic/ph pr-d/codeph ">over</codeph>, <codeph class="+ topic/ph pr-d/codeph ">down</codeph>). </p> |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class Namespace_3_Example extends Sprite { |
| public function Namespace_3_Example() { |
| addChild(new StateButton("Press Me.")); |
| } |
| } |
| } |
| |
| import flash.display.Sprite; |
| import flash.text.TextField; |
| import flash.events.Event; |
| import flash.events.MouseEvent; |
| |
| class StateButton extends Sprite{ |
| private namespace out; |
| private namespace over; |
| private namespace down; |
| private var label:TextField; |
| private var labelTxt:String; |
| private var ns:Namespace; |
| out var bgColor:Number = 0xFF0000; |
| over var bgColor:Number = 0xFFFF00; |
| down var bgColor:Number = 0xFFFFFF; |
| |
| public function StateButton(str:String) { |
| buttonMode = true; |
| labelTxt = str; |
| ns = out; |
| draw(); |
| addLabel(); |
| addListeners(); |
| } |
| |
| private function addLabel():void { |
| label = new TextField(); |
| label.text = labelTxt; |
| label.width = 50; |
| label.height = 20; |
| label.mouseEnabled = false; |
| addChild(label); |
| } |
| |
| private function addListeners():void { |
| addEventListener(MouseEvent.MOUSE_UP, mouseOverHandler); |
| addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler); |
| addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler); |
| addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); |
| } |
| |
| private function mouseOutHandler(e:Event):void { |
| ns = out; |
| draw(); |
| } |
| |
| private function mouseOverHandler(e:Event):void { |
| ns = over; |
| draw(); |
| } |
| |
| private function mouseDownHandler(e:Event):void { |
| ns = down; |
| draw(); |
| } |
| |
| private function draw():void { |
| this.graphics.clear(); |
| this.graphics.beginFill(ns::bgColor); |
| this.graphics.drawRect(0, 0, 60, 20); |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#XML" class="- topic/link "><linktext class="- topic/linktext ">XML</linktext></link><link href="#XMLList" class="- topic/link "><linktext class="- topic/linktext ">XMLList</linktext></link><link href="#QName" class="- topic/link "><linktext class="- topic/linktext ">QName</linktext></link><link href="http://www.ecma-international.org/publications/standards/Ecma-357.htm" class="- topic/link "><linktext class="- topic/linktext ">Spezifikation ECMA-357, Edition 2: „ECMAScript for XML (E4X)“</linktext></link></related-links><apiConstructor id="Namespace:Namespace_0" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Namespace</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein Namespace-Objekt gemäß den Werten der Parameter prefixValue und uriValue.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid> |
| </helpid></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">prefixValue</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das für den Namespace zu verwendende Präfix. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uriValue</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). |
| |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Erstellt ein Namespace-Objekt bei gegebenem prefixValue und uriValue. |
| |
| </apiTipText></apiTipTexts></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein Namespace-Objekt gemäß den Werten der Parameter <codeph class="+ topic/ph pr-d/codeph ">prefixValue</codeph> und <codeph class="+ topic/ph pr-d/codeph ">uriValue</codeph>. Dieser Konstruktor benötigt beide Parameter. |
| <p class="- topic/p ">Der Wert des Parameters <codeph class="+ topic/ph pr-d/codeph ">prefixValue</codeph> wird der <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph>-Eigenschaft wie folgt zugewiesen:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Wird <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> übergeben, wird die <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph>-Eigenschaft auf <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> gesetzt.</li><li class="- topic/li ">Handelt es sich bei dem Wert um einen gemäß der Funktion <codeph class="+ topic/ph pr-d/codeph ">isXMLName()</codeph> gültigen XML-Namen, wird er in einen String konvertiert und der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph> zugewiesen.</li><li class="- topic/li ">Ist der Wert kein gültiger XML-Name, wird <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph> auf <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> gesetzt.</li></ul> |
| |
| <p class="- topic/p ">Der Wert des Parameters <codeph class="+ topic/ph pr-d/codeph ">uriValue</codeph> wird der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> wie folgt zugewiesen:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Wird ein QName-Objekt übergeben, wird die Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> auf den Wert der <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft des QName-Objekts gesetzt.</li><li class="- topic/li "> Andernfalls wird der Parameter <codeph class="+ topic/ph pr-d/codeph ">uriValue</codeph> in einen String konvertiert und der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> zugewiesen.</li></ul> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Diese Klasse zeigt zwei Konstruktormethodeneinträge, da jede Form andere Parameter akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Argumente, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.</p> |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiConstructor id="Namespace:Namespace_1" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Namespace</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein Namespace-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><helpid> |
| </helpid></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uriValue</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). |
| |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Erstellt ein Namespace-Objekt bei gegebenem „uriValue“. |
| |
| </apiTipText></apiTipTexts></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein Namespace-Objekt. Welche Werte den Eigenschaften <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> und <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph> des neuen Namespace-Objekts zugewiesen werden, hängt davon ab, welche Art von Wert an den Parameter <codeph class="+ topic/ph pr-d/codeph ">uriValue</codeph> übergeben wurde: |
| <ul class="- topic/ul "><li class="- topic/li ">Wurde kein Wert übergeben, werden die Eigenschaften <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph> und <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> auf einen leeren String gesetzt.</li><li class="- topic/li ">Ist der Wert ein Namespace-Objekt, wird eine Kopie des Objekts erstellt.</li><li class="- topic/li ">Ist der Wert ein QName-Objekt, wird die <codeph class="+ topic/ph pr-d/codeph ">uri</codeph> auf die <codeph class="+ topic/ph pr-d/codeph ">uri</codeph>-Eigenschaft des QName-Objekts gesetzt.</li></ul> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Diese Klasse zeigt zwei Konstruktoreinträge, da jede Form andere Parameter akzeptiert. Der Konstruktor verhält sich unterschiedlich, je nach Typ und Anzahl der übergebenen Parameter, wie sie in den einzelnen Einträgen beschrieben sind. Überladene Methoden oder Konstruktoren werden von ActionSript 3.0 nicht unterstützt.</p> |
| |
| </apiDesc></apiConstructorDetail></apiConstructor><apiOperation id="Namespace:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Äquivalent zur Eigenschaft Namespace.uri.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Namespace, Namespace.toString, toString |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner) als String. |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Äquivalent zur Eigenschaft Namespace.uri. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Äquivalent zur Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">Namespace.uri</codeph>. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Namespace:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den URI-Wert des angegebenen Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Namespace, Namespace.toString, toString |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner) als String. |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Äquivalent zur Eigenschaft Namespace.uri. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den URI-Wert des angegebenen Objekts zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="Namespace:prefix:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">prefix</apiName><shortdesc class="- topic/shortdesc "> |
| Das Präfix des Namespaces.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Namespace, Namespace.prefix, prefix |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Das Präfix des Namespaces. |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Das Präfix des Namespaces. |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Namespace:uri:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">uri</apiName><shortdesc class="- topic/shortdesc "> |
| Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Namespace, Namespace.uri, uri |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">String</apiValueClassifier><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). |
| |
| </apiTipText></apiTipTexts></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der Namespace-URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:XML" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">XML</apiName><shortdesc class="- topic/shortdesc "> |
| Die XML-Klasse enthält Methoden und Eigenschaften für die Arbeit mit XML-Objekten.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die XMl-Klasse enthält Methoden und Eigenschaften für die Arbeit mit XML-Objekten. Die XML-Klasse implementiert (zusammen mit den Klassen XMLList, Namespace und QName) leistungsstarke Standards zur XML-Verarbeitung, die in der Spezifikation ECMA-357, Edition 2: „ECMAScript for XML (E4X)“ definiert sind. |
| |
| <p class="- topic/p ">Verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph>, um das XML-Objekt als String zurückzugeben, und zwar unabhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt besitzt.</p> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis</b>: Die XML-Klasse aus ActionScript 2.0 wurde (ebenso wie andere, verwandte Klassen) in „XMLDocument“ umbenannt und in das Paket flash.xml verlagert. In ActionScript 3.0 ist sie aus Gründen der Rückwärtskompatibilität enthalten.</p> |
| |
| |
| </apiDesc><example conref="examples\XMLExample.as" class="- topic/example "> Im folgenden Beispiel wird zunächst eine XML-Variable erstellt, zu der dann Knoten hinzugefügt werden. Anschließend wird mithilfe von XML-Eigenschaften nach XML-Knoten gesucht, die dann gedruckt werden. Beachten Sie, dass das „at“-Symbol (<codeph class="+ topic/ph pr-d/codeph ">@</codeph>) bei mehreren Aufrufen von <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph> verwendet wird, um Informationen anhand des Attributnamens zu finden. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class XmlExample extends Sprite { |
| public function XmlExample() { |
| var employees:XML = |
| <employees> |
| <employee ssn="123-123-1234"> |
| <name first="John" last="Doe"/> |
| <address> |
| <street>11 Main St.</street> |
| <city>San Francisco</city> |
| <state>CA</state> |
| <zip>98765</zip> |
| </address> |
| </employee> |
| <employee ssn="789-789-7890"> |
| <name first="Mary" last="Roe"/> |
| <address> |
| <street>99 Broad St.</street> |
| <city>Newton</city> |
| <state>MA</state> |
| <zip>01234</zip> |
| </address> |
| </employee> |
| </employees>; |
| |
| trace(employees.employee[0].address.zip); // 98765 |
| |
| trace(employees.employee[1].@ssn); // 789-789-7890 |
| |
| trace(employees.employee.name); // <name first="John" last="Doe"/> |
| // <name first="Mary" last="Roe"/> |
| |
| trace(employees..zip[0]); // 98765 |
| |
| trace(employees..@ssn[1]); // 789-789-7890 |
| |
| trace(employees..name); // <name first="John" last="Doe"/> |
| // <name first="Mary" last="Roe"/> |
| |
| trace(employees.employee[0].address.*); // <street>11 Main St.</street> |
| // <city>San Francisco</city> |
| // <state>CA</state> |
| // <zip>98765</zip> |
| var node:String = "zip"; |
| trace(employees.employee[0].address[node]); // 98765 |
| |
| var attribute:String = "ssn"; |
| trace(employees.employee[1].@[attribute]); // 789-789-7890 |
| |
| for each (var num:XML in employees..@ssn) { |
| trace(num); // 123-123-1234 |
| } // 789-789-7890 |
| |
| var ssnToFind:String = "789-789-7890"; |
| trace(employees.employee.(@ssn == ssnToFind).toXMLString()); |
| // <employee ssn="789-789-7890"> |
| // <name first="Mary" last="Roe"/> |
| // <address> |
| // <street>99 Broad St.</street> |
| // <city>Newton</city> |
| // <state>MA</state> |
| // <zip>01234</zip> |
| // </address> |
| // </employee> |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="#Namespace" class="- topic/link "><linktext class="- topic/linktext ">Namespace</linktext></link><link href="#QName" class="- topic/link "><linktext class="- topic/linktext ">QName</linktext></link><link href="#XMLList" class="- topic/link "><linktext class="- topic/linktext ">XMLList</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">XML.toXMLString()</linktext></link><link href="http://www.ecma-international.org/publications/standards/Ecma-357.htm" class="- topic/link "><linktext class="- topic/linktext ">Spezifikation ECMA-357, Edition 2: „ECMAScript for XML (E4X)“</linktext></link></related-links><apiConstructor id="XML:XML" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">XML</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues XML-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Jedes Objekt, das sich mithilfe von <codeph class="+ topic/ph pr-d/codeph ">XML()</codeph>, einer Funktion oberster Ebene, in ein XMLList-Objekt konvertieren lässt. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues XML-Objekt. Vor dem Aufruf einer Methode der XML-Klasse muss der Konstruktor zum Erstellen eines XML-Objekts verwendet werden. |
| |
| <p class="- topic/p ">Verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph>, um das XML-Objekt als String zurückzugeben, und zwar unabhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt besitzt.</p> |
| |
| </apiDesc><example conref="examples\XML_new.as" class="- topic/example "> Das folgende Beispiel zeigt, wie Sie mithilfe der URLLoader-Klasse in Flash Professional ein Remote-XML-Dokument in ActionScript 3.0 laden können. Beispiel bereitgestellt von <xref href="http://actionscriptexamples.com/2008/12/05/dynamically-loading-xml-files-in-actionscript-30/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| // |
| // Requires: |
| // - TextArea control UI component in the Flash Professional Library. |
| // |
| import fl.controls.TextArea; |
| |
| var xml:XML; |
| |
| var urlRequest:URLRequest = new URLRequest("http://www.helpexamples.com/flash/xml/menu.xml"); |
| |
| var urlLoader:URLLoader = new URLLoader(); |
| urlLoader.addEventListener(Event.COMPLETE, urlLoader_complete); |
| urlLoader.load(urlRequest); |
| |
| var textArea:TextArea = new TextArea(); |
| textArea.move(5, 5); |
| textArea.setSize(stage.stageWidth - 10, stage.stageHeight - 10); |
| addChild(textArea); |
| |
| function urlLoader_complete(evt:Event):void { |
| xml = new XML(evt.currentTarget.data); |
| textArea.text = xml.toXMLString(); |
| } |
| </codeblock></example><example conref="examples\XML_new_2.as" class="- topic/example "> Dies ist eine andere Variante, ausschließlich mit ActionScript. Beispiel bereitgestellt von <xref href="http://actionscriptexamples.com/2008/12/05/dynamically-loading-xml-files-in-actionscript-30/" scope="_mmexternal" class="- topic/xref ">ActionScriptExamples.com</xref>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML; |
| var textArea:TextField = new TextField(); |
| textArea.width = 300; |
| |
| var urlRequest:URLRequest = new URLRequest("http://www.helpexamples.com/flash/xml/menu.xml"); |
| var urlLoader:URLLoader = new URLLoader(); |
| urlLoader.dataFormat = URLLoaderDataFormat.TEXT; |
| urlLoader.addEventListener(Event.COMPLETE, urlLoader_complete); |
| urlLoader.load(urlRequest); |
| |
| function urlLoader_complete(evt:Event):void { |
| xml = new XML(evt.target.data); |
| textArea.text = xml.toXMLString(); |
| addChild(textArea); |
| } |
| </codeblock></example></apiConstructorDetail><related-links class="- topic/related-links "><link href="package.html#XML()" class="- topic/link "><linktext class="- topic/linktext ">XML(), globale Funktion</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">XML.toXMLString()</linktext></link></related-links></apiConstructor><apiOperation id="XML:AS3:addNamespace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">addNamespace</apiName><shortdesc class="- topic/shortdesc "> |
| Erweitert den Satz an gültigen Namespaces für das XML-Objekt um einen Namespace.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.addNamespace, addNamespace |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das neue XML-Objekt mit dem zusätzlichen Namespace. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ns</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Namespace, der zum XML-Objekt hinzufügt werden soll. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erweitert den Satz an gültigen Namespaces für das XML-Objekt um einen Namespace. Existiert der Namespace bereits im Namespace-Gültigkeitsbereich für das XML-Objekt (mit dem Präfix aus dem angegebenen Parameter), so wird das Präfix des bereits vorhandenen Namespaces auf <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> gesetzt. Handelt es sich beim Eingabeparameter um ein Namespace-Objekt, wird es direkt verwendet. Handelt es sich um ein QName-Objekt, wird der URI des Eingabeparameters verwendet, um einen neuen Namespace zu erstellen; andernfalls wird es in einen String konvertiert und der Namespace wird aus diesem String erstellt. |
| |
| </apiDesc><example conref="examples\XML.addNamespace.1.as" class="- topic/example "> In diesem Beispiel wird ein Namespace, der in einem XML-Objekt definiert wurde auf ein anderes XML-Objekt angewendet: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml1:XML = <ns:foo xmlns:ns="www.example.com/ns" />; |
| var nsNamespace:Namespace = xml1.namespace(); |
| |
| var xml2:XML = <bar />; |
| xml2.addNamespace(nsNamespace); |
| trace(xml2.toXMLString()); // <bar xmlns:ns="www.example.com/ns"/> |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:appendChild" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">appendChild</apiName><shortdesc class="- topic/shortdesc "> |
| Hängt das angegebene untergeordnete Objekt ans Ende der Eigenschaften des XML-Objekts an.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.appendChild, appendChild |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">child</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das anzuhängende XML-Objekt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Hängt das angegebene untergeordnete Objekt ans Ende der Eigenschaften des XML-Objekts an. Die Methode <codeph class="+ topic/ph pr-d/codeph ">appendChild()</codeph> akzeptiert ein XML-Objekt, ein XMLList-Objekt oder einen anderen Datentyp, der dann in einen String konvertiert wird. |
| |
| <p class="- topic/p ">Verwenden Sie den Operator <codeph class="+ topic/ph pr-d/codeph ">delete</codeph>, um den XML-Knoten zu entfernen.</p> |
| |
| </apiDesc><example conref="examples\XML.appendChild.1.as" class="- topic/example "> In diesem Beispiel wird am Ende der untergeordneten Liste eines XML-Objekts ein neues Element angehängt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>hello</p> |
| </body>; |
| |
| xml.appendChild(<p>world</p>); |
| trace(xml.p[0].toXMLString()); // <p>hello</p> |
| trace(xml.p[1].toXMLString()); // <p>world</p> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="operators.html#delete_(XML)" class="- topic/link "><linktext class="- topic/linktext ">delete-(XML)-Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:attribute" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attribute</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den XML-Wert des Attributs zurück, das den mit dem Parameter attributeName übereinstimmenden Namen besitzt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.attribute, attribute |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt oder ein leeres XMLList-Objekt. Gibt ein leeres XMLList-Objekt zurück, wenn ein Attributwert nicht definiert worden ist. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">attributeName</apiItemName><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name des Attributs. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den XML-Wert des Attributs zurück, das den mit dem Parameter <codeph class="+ topic/ph pr-d/codeph ">attributeName</codeph> übereinstimmenden Namen besitzt. Attribute befinden sich innerhalb von XML-Elementen. Im folgenden Beispiel hat das Element ein Attribut mit dem Namen "<codeph class="+ topic/ph pr-d/codeph ">gender</codeph>" und dem Wert "<codeph class="+ topic/ph pr-d/codeph ">boy</codeph>": <codeph class="+ topic/ph pr-d/codeph "><first gender="boy">John</first></codeph> . |
| |
| <p class="- topic/p ">Der Parameter <codeph class="+ topic/ph pr-d/codeph ">attributeName</codeph> kann einen beliebigen Datentyp besitzen; allerdings ist String der am häufigsten verwendete Datentyp. Wenn Sie ein beliebiges Objekt übergeben, das kein QName-Objekt ist, verwendet der Parameter <codeph class="+ topic/ph pr-d/codeph ">attributeName</codeph> die Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>, um den Parameter in einen String zu konvertieren. </p> |
| |
| <p class="- topic/p ">Wenn Sie eine qualifizierte Namensreferenz benötigen, können Sie ein QName-Objekt übergeben. Ein QName-Objekt definiert einen Namespace und den lokalen Namen, den Sie verwenden können, um den qualifizierten Namen eines Attributs zu definieren. Daher ist es nicht dasselbe, ob Sie <codeph class="+ topic/ph pr-d/codeph ">attribute(qname)</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">attribute(qname.toString())</codeph> aufrufen.</p> |
| |
| </apiDesc><example conref="examples\XMLAttributeExample1.as" class="- topic/example "> Im folgenden Beispiel wird ein QName-Objekt in eine <codeph class="+ topic/ph pr-d/codeph ">attribute()</codeph>-Methode übergeben. Die <codeph class="+ topic/ph pr-d/codeph ">localName</codeph>-Eigenschaft hat den Wert <codeph class="+ topic/ph pr-d/codeph ">attr</codeph>, und die <codeph class="+ topic/ph pr-d/codeph ">namespace</codeph>-Eigenschaft hat den Wert <codeph class="+ topic/ph pr-d/codeph ">ns</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = <ns:node xmlns:ns = "http://uri" ns:attr = '7' /> |
| var qn:QName = new QName("http://uri", "attr"); |
| trace (xml.attribute(qn)); // 7 |
| </codeblock></example><example conref="examples\XMLAttributeExample2.as" class="- topic/example "> Um ein Attribut mit einem Namen zurückzugeben, der einem in ActionScript reservierten Wort entspricht, verwenden Sie die <codeph class="+ topic/ph pr-d/codeph ">attribute()</codeph>-Methode anstelle des (@)-Operators, der als Attributbezeichner dient (siehe folgendes Beispiel): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = <example class="first" /> |
| trace(xml.attribute("class")); |
| |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/attributes()" class="- topic/link "><linktext class="- topic/linktext ">XML.attributes()</linktext></link><link href="#QName" class="- topic/link "><linktext class="- topic/linktext ">QName</linktext></link><link href="#Namespace" class="- topic/link "><linktext class="- topic/linktext ">Namespace</linktext></link><link href="#XML/elements()" class="- topic/link "><linktext class="- topic/linktext ">XML.elements()</linktext></link><link href="operators.html#attribute_identifier" class="- topic/link "><linktext class="- topic/linktext ">Attributbezeichner (&#064;) Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:attributes" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">attributes</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Liste von Attributwerten für ein bestimmtes XML-Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.attributes, attributes |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Liste der Attributwerte. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Liste von Attributwerten für ein bestimmtes XML-Objekt zurück. Verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">name()</codeph> mit der Methode <codeph class="+ topic/ph pr-d/codeph ">attributes()</codeph>, um den Namen eines Attributs zurückzugeben. Die Verwendung von <codeph class="+ topic/ph pr-d/codeph ">xml.attributes()</codeph> entspricht <codeph class="+ topic/ph pr-d/codeph ">xml.@*</codeph>. |
| |
| </apiDesc><example conref="examples\XMLAttributesExample1.as" class="- topic/example "> Im folgenden Beispiel wird der Name des Attributs zurückgegeben: |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML=<example id='123' color='blue'/> |
| trace(xml.attributes()[1].name()); //color |
| </codeblock></example><example conref="examples\XMLAttributesExample2.as" class="- topic/example "> In diesem Beispiel werden die Namen aller Attribute zurückzugeben: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var xml:XML = <example id='123' color='blue'/> |
| var attNamesList:XMLList = xml.@*; |
| |
| trace (attNamesList is XMLList); // true |
| trace (attNamesList.length()); // 2 |
| |
| for (var i:int = 0; i < attNamesList.length(); i++) |
| { |
| trace (typeof (attNamesList[i])); // xml |
| trace (attNamesList[i].nodeKind()); // attribute |
| trace (attNamesList[i].name()); // id and color |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/attribute()" class="- topic/link "><linktext class="- topic/linktext ">XML.attribute()</linktext></link><link href="#XML/name()" class="- topic/link "><linktext class="- topic/linktext ">XML.name()</linktext></link><link href="operators.html#attribute_identifier" class="- topic/link "><linktext class="- topic/linktext ">&#064; Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:childIndex" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">childIndex</apiName><shortdesc class="- topic/shortdesc "> |
| Identifiziert die nullindizierte Position dieses XML-Objekts innerhalb des Kontexts des übergeordneten Objekts.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.childindex, childindex |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position des Objekts. Gibt -1 zurück sowie alle positiven Ganzzahlen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Identifiziert die nullindizierte Position dieses XML-Objekts innerhalb des Kontexts des übergeordneten Objekts. |
| |
| </apiDesc><example conref="examples\XML.childIndex.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie Sie die <codeph class="+ topic/ph pr-d/codeph ">childIndex()</codeph>-Methode verwenden: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo> |
| <bar /> |
| text |
| <bob /> |
| </foo>; |
| trace(xml.bar.childIndex()); // 0 |
| trace(xml.bob.childIndex()); // 2 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:child" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">child</apiName><shortdesc class="- topic/shortdesc "> |
| Listet die untergeordneten Knoten eines XML-Objekts auf.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.child, child |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit untergeordneten Knoten, die dem input-Parameter entsprechen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">propertyName</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Elementname oder die Ganzzahl des untergeordneten XML-Elements. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Listet die untergeordneten Knoten eines XML-Objekts auf. Bei einem untergeordneter XML-Knoten kann es sich um ein XML-Element, einen Textknoten, einen Kommentar oder eine Verarbeitungsanweisung handeln. |
| |
| <p class="- topic/p ">Verwenden Sie den Parameter <codeph class="+ topic/ph pr-d/codeph ">propertyName</codeph>, um den Inhalt eines bestimmten untergeordneten XML-Knotens aufzulisten. Um beispielsweise den Inhalt des untergeordneten Knotens mit dem Namen <codeph class="+ topic/ph pr-d/codeph "><first></codeph> auszugeben, verwenden Sie <codeph class="+ topic/ph pr-d/codeph ">child.name("first")</codeph>. Sie erzeugen dasselbe Ergebnis, wenn Sie die Indexnummer des untergeordneten Knotens verwenden. Die Indexnummer identifiziert die Position des untergeordneten Knotens in der Liste weiterer untergeordneter XML-Knoten. <codeph class="+ topic/ph pr-d/codeph ">name.child(0)</codeph> beispielsweise gibt den ersten untergeordneten Knoten in einer Liste zurück. </p> |
| |
| <p class="- topic/p ">Verwenden Sie ein Sternchen (~~), um alle untergeordneten Knoten eines XML-Dokuments auszugeben. Zum Beispiel <codeph class="+ topic/ph pr-d/codeph ">doc.child("~~")</codeph>.</p> |
| |
| <p class="- topic/p ">Verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">length()</codeph> mit dem Sternparameter (~~) der Methode <codeph class="+ topic/ph pr-d/codeph ">child()</codeph>, um die Gesamtanzahl der untergeordneten Knoten auszugeben. Zum Beispiel <codeph class="+ topic/ph pr-d/codeph ">numChildren = doc.child("~~").length()</codeph>.</p> |
| |
| </apiDesc><example conref="examples\XML.child.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der <codeph class="+ topic/ph pr-d/codeph ">child()</codeph>-Methode untergeordnete Elemente mit einem angegebenen Namen identifizieren: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo> |
| <bar>text1</bar> |
| <bar>text2</bar> |
| </foo>; |
| trace(xml.child("bar").length()); // 2 |
| trace(xml.child("bar")[0].toXMLString()); // <bar>text1</bar> |
| trace(xml.child("bar")[1].toXMLString()); // <bar>text2</bar> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/elements()" class="- topic/link "><linktext class="- topic/linktext ">XML.elements()</linktext></link><link href="#XMLList" class="- topic/link "><linktext class="- topic/linktext ">XMLList-Klasse</linktext></link><link href="#XML/length()" class="- topic/link "><linktext class="- topic/linktext ">XML.length()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:children" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">children</apiName><shortdesc class="- topic/shortdesc "> |
| Listet die untergeordneten Knoten des XML-Objekts auf, und zwar in der Reihenfolge, in der sie erscheinen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.children, children |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit den Knoten, die dem XML-Objekt untergeordnet sind. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Listet die untergeordneten Knoten des XML-Objekts auf, und zwar in der Reihenfolge, in der sie erscheinen. Bei einem untergeordneter XML-Knoten kann es sich um ein XML-Element, einen Textknoten, einen Kommentar oder eine Verarbeitungsanweisung handeln. |
| |
| </apiDesc><example conref="examples\XML.children.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie Sie die <codeph class="+ topic/ph pr-d/codeph ">children()</codeph>-Methode verwenden: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| XML.ignoreProcessingInstructions = false; |
| var xml:XML = |
| <foo id="22"> |
| <bar>44</bar> |
| text |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml.children().length()); // 4 |
| trace(xml.children()[0].toXMLString()); // <bar>44</bar> |
| trace(xml.children()[1].toXMLString()); // text |
| trace(xml.children()[2].toXMLString()); // <!-- comment --> |
| trace(xml.children()[3].toXMLString()); // <?instruction ?> |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:comments" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">comments</apiName><shortdesc class="- topic/shortdesc "> |
| Listet die Eigenschaften des XML-Objekts auf, die XML-Kommentare enthalten.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.comments, comments |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt der Eigenschaften, die Kommentare enthalten. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Listet die Eigenschaften des XML-Objekts auf, die XML-Kommentare enthalten. |
| |
| </apiDesc><example conref="examples\XML.comments.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie Sie die <codeph class="+ topic/ph pr-d/codeph ">comments()</codeph>-Methode verwenden: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| var xml:XML = |
| <foo> |
| <!-- example --> |
| <!-- example2 --> |
| </foo>; |
| trace(xml.comments().length()); // 2 |
| trace(xml.comments()[1].toXMLString()); // <!-- example2 --> |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:contains" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">contains</apiName><shortdesc class="- topic/shortdesc "> |
| Vergleicht das XML-Objekt mit dem angegebenen value-Parameter.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.contains, contains |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn das XML-Objekt mit dem Parameter <codeph class="+ topic/ph pr-d/codeph ">value</codeph> übereinstimmt, lautet der Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein mit dem aktuellen XML-Objekt zu vergleichender Wert. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Vergleicht das XML-Objekt mit dem angegebenen <codeph class="+ topic/ph pr-d/codeph ">value</codeph>-Parameter. |
| |
| </apiDesc><example conref="examples\XML.contains.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie Sie die <codeph class="+ topic/ph pr-d/codeph ">contains()</codeph>-Methode verwenden: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <order> |
| <item>Rice</item> |
| <item>Kung Pao Shrimp</item> |
| </order>; |
| trace(xml.item[0].contains(<item>Rice</item>)); // true |
| trace(xml.item[1].contains(<item>Kung Pao Shrimp</item>)); // true |
| trace(xml.item[1].contains(<item>MSG</item>)); // false |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:copy" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">copy</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Kopie des gegebenen XML-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.copy, copy |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Kopie des Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Kopie des gegebenen XML-Objekts zurück. Die Kopie ist ein Duplikat der gesamten Knotenbaumstruktur. Das kopierte XML-Objekt hat kein übergeordnetes Objekt und gibt den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> zurück, wenn Sie versuchen, die <codeph class="+ topic/ph pr-d/codeph ">parent()</codeph>-Methode aufzurufen. |
| |
| </apiDesc><example conref="examples\XML.copy.1.as" class="- topic/example "> Aus dem folgenden Beispiel geht hervor, dass die <codeph class="+ topic/ph pr-d/codeph ">copy()</codeph>-Methode eine neue Instanz eines XML-Objekts erstellt. Das Original bleibt unverändert, wenn Sie die Kopie bearbeiten: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml1:XML = <foo />; |
| var xml2:XML = xml1.copy(); |
| xml2.appendChild(<bar />); |
| trace(xml1.bar.length()); // 0 |
| trace(xml2.bar.length()); // 1 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:defaultSettings" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">defaultSettings</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt ein Objekt zurück, bei dem die folgenden Eigenschaften auf die Standardwerte gesetzt sind: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent und prettyPrinting.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.defaultSettings, defaultSettings |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, dessen Eigenschaften auf die Standardwerte gesetzt sind. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt ein Objekt zurück, bei dem die folgenden Eigenschaften auf die Standardwerte gesetzt sind: <codeph class="+ topic/ph pr-d/codeph ">ignoreComments</codeph>, <codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions</codeph>, <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph>, <codeph class="+ topic/ph pr-d/codeph ">prettyIndent</codeph> und <codeph class="+ topic/ph pr-d/codeph ">prettyPrinting</codeph>. Die Standardwerte lauten wie folgt: |
| |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreComments = true</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions = true</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace = true</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">prettyIndent = 2</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">prettyPrinting = true</codeph></li></ul> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Sie wenden diese Methode nicht auf eine Instanz der XML-Klasse an, sondern, wie im folgenden Code gezeigt, auf <codeph class="+ topic/ph pr-d/codeph ">XML</codeph>: <codeph class="+ topic/ph pr-d/codeph ">var df:Object = XML.defaultSettings()</codeph> . </p> |
| |
| </apiDesc><example conref="examples\XML.defaultSettings.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht: wie Sie benutzerdefinierte Einstellungen (um Kommentare und Verarbeitungsanweisungen einzuschließen) anwenden, bevor Sie ein XML-Objekt einrichten; wie Sie dann die Standardeinstellungen wiederherstellen, bevor Sie ein weiteres XML-Objekt einrichten; und wie Sie dann wieder die benutzerdefinierte Einstellungen einrichten (um weitere XML-Objekte einzurichten): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| XML.ignoreProcessingInstructions = false; |
| var customSettings:Object = XML.settings(); |
| |
| var xml1:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml1.toXMLString()); |
| // <foo> |
| // <!-- comment --> |
| // <?instruction ?> |
| // </foo> |
| |
| XML.setSettings(XML.defaultSettings()); |
| var xml2:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml2.toXMLString()); |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/ignoreComments" class="- topic/link "><linktext class="- topic/linktext ">XML.ignoreComments</linktext></link><link href="#XML/ignoreProcessingInstructions" class="- topic/link "><linktext class="- topic/linktext ">XML.ignoreProcessingInstructions</linktext></link><link href="#XML/ignoreWhitespace" class="- topic/link "><linktext class="- topic/linktext ">XML.ignoreWhitespace</linktext></link><link href="#XML/prettyIndent" class="- topic/link "><linktext class="- topic/linktext ">XML.prettyIndent</linktext></link><link href="#XML/prettyPrinting" class="- topic/link "><linktext class="- topic/linktext ">XML.prettyPrinting</linktext></link><link href="#XML/setSettings()" class="- topic/link "><linktext class="- topic/linktext ">XML.setSettings()</linktext></link><link href="#XML/settings()" class="- topic/link "><linktext class="- topic/linktext ">XML.settings()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:descendants" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">descendants</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt alle untergeordneten Elemente (direkt untergeordnete und über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts zurück, die dem gegebenen name-Parameter entsprechen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.descendants, descendants |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit den übereinstimmenden untergeordneten Elementen. Wenn es keine untergeordneten Elemente gibt, wird ein leeres XMLList-Objekt zurückgegeben. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">*</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name des zu vergleichenden Elements. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt alle untergeordneten Elemente (direkt untergeordnete und über mehrere Zweige hinweg untergeordnete Knoten) des XML-Objekts zurück, die dem gegebenen <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter entsprechen. Der Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph> ist optional. Der <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter kann ein QName-Objekt sein, ein Objekt des Datentyps String oder jeglichen sonstigen Datentyps, der sich in einen String konvertieren lässt. |
| |
| <p class="- topic/p ">Um alle untergeordneten Elemente zurückzugeben, verwenden Sie den Sternparameter (~~). Wird kein Parameter übergeben, wird der String „~~“ übergeben, sodass alle untergeordneten Elemente des XML-Objekts zurückgegeben werden.</p> |
| |
| </apiDesc><example conref="examples\XMLDescendantsExample1.as" class="- topic/example "> Um untergeordneten Elemente mit Namen zurückzugeben, die in ActionScript reservierten Worten entsprechen, verwenden Sie im XML-Code die <codeph class="+ topic/ph pr-d/codeph ">descendants()</codeph>-Methode anstelle des untergeordneten Elements (..). Dies wird in dem folgenden Beispiel veranschaulicht: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <enrollees> |
| <student id="239"> |
| <class name="Algebra" /> |
| <class name="Spanish 2"/> |
| </student> |
| <student id="206"> |
| <class name="Trigonometry" /> |
| <class name="Spanish 2" /> |
| </student> |
| </enrollees> |
| trace(xml.descendants("class")); |
| </codeblock></example><example conref="examples\XML.descendants.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, dass die <codeph class="+ topic/ph pr-d/codeph ">descendants()</codeph>-Methode ein XMLList-Objekt zurückgibt, das <i class="+ topic/ph hi-d/i ">alle</i> untergeordneten Elemente enthält (auch über mehrere Unterordnungsstufen hinweg) usw.: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| var xml:XML = |
| <body> |
| <!-- comment --> |
| text1 |
| <a> |
| <b>text2</b> |
| </a> |
| </body>; |
| trace(xml.descendants("*").length()); // 5 |
| trace(xml.descendants("*")[0]); // // <!-- comment --> |
| trace(xml.descendants("*")[1].toXMLString()); // text1 |
| trace(xml.descendants("a").toXMLString()); // <a><b>text2</b></a> |
| trace(xml.descendants("b").toXMLString()); // <b>text2</b> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="operators.html#descendant_accessor" class="- topic/link "><linktext class="- topic/linktext ">Accessor für untergeordnete Elemente (..) Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:elements" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">elements</apiName><shortdesc class="- topic/shortdesc "> |
| Listet die Elemente eines XML-Objekts auf.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.elements, elements |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XMLList-Objekt mit dem Inhalt des Elements. Der Inhalt des Elements liegt zwischen dem Start- und dem End-Tag. Wenn Sie das Sternchen (~~) verwenden, um alle Elemente aufzurufen, werden sowohl die Tags als auch der Inhalt des Elements zurückgegeben. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">*</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name des Elements. Der Name eines Elements ist in spitze Klammern eingeschlossen. So ist im folgenden Beispiel "<codeph class="+ topic/ph pr-d/codeph ">first</codeph>" der Name (<codeph class="+ topic/ph pr-d/codeph ">name</codeph>): <codeph class="+ topic/ph pr-d/codeph "><first></first></codeph>. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Listet die Elemente eines XML-Objekts auf. Ein Element besteht aus einem Start- und End-Tag, z. B. <codeph class="+ topic/ph pr-d/codeph "><first></first></codeph>. Der Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph> ist optional. Der <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter kann ein QName-Objekt sein, ein Objekt des Datentyps String oder jeglichen sonstigen Datentyps, der sich in einen String konvertieren lässt. Verwenden Sie den Parameter <codeph class="+ topic/ph pr-d/codeph ">name</codeph>, um ein bestimmtes Element aufzulisten. Im folgenden Beispiel gibt das Element "<codeph class="+ topic/ph pr-d/codeph ">first</codeph>" beispielsweise "<codeph class="+ topic/ph pr-d/codeph ">John</codeph>" zurück: <codeph class="+ topic/ph pr-d/codeph "><first>John</first></codeph>. |
| |
| <p class="- topic/p ">Um alle Element zurückzugeben, verwenden Sie das Sternchen (~~) als Parameter. Das Sternchen ist auch der Standardparameter. </p> |
| |
| <p class="- topic/p ">Verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">length()</codeph> mit dem Sternparameter (~~), um die Gesamtanzahl der Elemente auszugeben. Beispielsweise <codeph class="+ topic/ph pr-d/codeph ">numElement = addressbook.elements("~~").length()</codeph>.</p> |
| |
| </apiDesc><example conref="examples\XML.elements.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, dass die <codeph class="+ topic/ph pr-d/codeph ">elements()</codeph>-Methode nur eine Liste mit Elementen zurückgibt; sie enthält keinen Kommentare, Texteigenschaften oder Verarbeitungsanweisungen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| text |
| <a>1</a> |
| <b>2</b> |
| </foo>; |
| trace(xml.elements("*").length()); // 2 |
| trace(xml.elements("*")[0].toXMLString()); // <a>1</a> |
| trace(xml.elements("b").length()); // 1 |
| trace(xml.elements("b")[0].toXMLString()); // <b>2</b> |
| </codeblock></example><example conref="examples\XMLElementsExample1.as" class="- topic/example "> Um Elemente mit Namen zurückzugeben, die in ActionScript reservierten Worten entsprechen, verwenden Sie im XML-Code die Methode <codeph class="+ topic/ph pr-d/codeph ">elements()</codeph> anstelle des XML-Punkt-Operators (.). Dies wird in dem folgenden Beispiel veranschaulicht: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <student id="206"> |
| <class name="Trigonometry" /> |
| <class name="Spanish 2" /> |
| </student> |
| trace(xml.elements("class")); |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/child()" class="- topic/link "><linktext class="- topic/linktext ">XML.child()</linktext></link><link href="#XMLList" class="- topic/link "><linktext class="- topic/linktext ">XMLList-Klasse</linktext></link><link href="#XML/length()" class="- topic/link "><linktext class="- topic/linktext ">XML.length()</linktext></link><link href="#XML/attribute()" class="- topic/link "><linktext class="- topic/linktext ">XML.attribute()</linktext></link><link href="operators.html#dot_(XML)" class="- topic/link "><linktext class="- topic/linktext ">XML-Punkt (.) Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:hasComplexContent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasComplexContent</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob das XML-Objekt komplexen Inhalt enthält.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.hasComplexContent, hasComplexContent |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn das XML-Objekt einen komplexen Inhalt hat; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob das XML-Objekt komplexen Inhalt enthält. Ein XML-Objekt enthält komplexen Inhalt, wenn es untergeordnete Elemente besitzt. XML-Objekte, die Attribute, Kommentare, Verarbeitungsanweisungen oder Textknoten repräsentieren, haben keinen komplexen Inhalt. Doch auch ein Objekt, das diese Knoten <i class="+ topic/ph hi-d/i ">enthält</i>, kann komplexen Inhalt haben (nämlich wenn es zudem untergeordnete Elemente besitzt). |
| |
| </apiDesc><example conref="examples\XML.hasComplexContent.1.as" class="- topic/example "> Im folgenden Beispiel sehen Sie ein XML-Objekt mit einer Eigenschaft namens <codeph class="+ topic/ph pr-d/codeph ">a</codeph> und einfachem Inhalt sowie eine Eigenschaft namens <codeph class="+ topic/ph pr-d/codeph ">a</codeph> und komplexem Inhalt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo> |
| <a> |
| text |
| </a> |
| <a> |
| <b/> |
| </a> |
| </foo>; |
| trace(xml.a[0].hasComplexContent()); // false |
| trace(xml.a[1].hasComplexContent()); // true |
| |
| trace(xml.a[0].hasSimpleContent()); // true |
| trace(xml.a[1].hasSimpleContent()); // false |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/hasSimpleContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasSimpleContent()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:hasOwnProperty" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasOwnProperty</apiName><shortdesc class="- topic/shortdesc "> |
| Überprüft, ob die Eigenschaft des Objekts vom Parameter „p“ angegeben wird.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.hasOwnProperty, hasOwnProperty |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn die Eigenschaft vorhanden ist; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">p</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die zu vergleichende Eigenschaft. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Überprüft, ob die Eigenschaft des Objekts vom Parameter <codeph class="+ topic/ph pr-d/codeph ">p</codeph> angegeben wird. |
| |
| </apiDesc><example conref="examples\XML.hasOwnProperty.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">hasOwnProperty()</codeph>-Methode sichergestellt, dass eine Eigenschaft (<codeph class="+ topic/ph pr-d/codeph ">b</codeph>) vorhanden ist, bevor ein Ausdruck (<codeph class="+ topic/ph pr-d/codeph ">b == "11"</codeph>) der diese Eigenschaft verwendet, bewertet wird: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo> |
| <a /> |
| <a> |
| <b>10</b> |
| </a> |
| <a> |
| <b>11</b> |
| </a> |
| </foo>; |
| trace(xml.a.(hasOwnProperty("b") && b == "11")); |
| </codeblock> Von Flash Player würde eine Ausnahme ausgelöst werden, wenn die letzte Zeile in diesem Beispiel wie folgt lauten würde, da das erste Element mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">a</codeph> keine Eigenschaft mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">b</codeph> aufweist: |
| <p class="- topic/p "> |
| <pre xml:space="preserve" class="- topic/pre ">trace(xml.a.(b == "11"));</pre> |
| </p> |
| </example><example conref="examples\XML.hasOwnProperty.2.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">hasOwnProperty()</codeph>-Methode sichergestellt, dass eine Eigenschaft (<codeph class="+ topic/ph pr-d/codeph ">item</codeph>) vorhanden ist, bevor ein Ausdruck (<codeph class="+ topic/ph pr-d/codeph ">item.contains("toothbrush")</codeph>) der diese Eigenschaft verwendet, bewertet wird: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <orders> |
| <order id='1'> |
| <item>toothbrush</item> |
| <item>toothpaste</item> |
| </order> |
| <order> |
| <returnItem>shoe polish</returnItem> |
| </order> |
| </orders>; |
| trace(xml.order.(hasOwnProperty("item") && item.contains("toothbrush"))); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:hasSimpleContent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">hasSimpleContent</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob das XML-Objekt komplexen Inhalt enthält.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.hasSimpleContent, hasSimpleContent |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc "><codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn das XML-Objekt einen einfachen Inhalt hat; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob das XML-Objekt komplexen Inhalt enthält. Ein XML-Objekt enthält einfachen Inhalt, wenn es einen Textknoten, einen Attributknoten oder ein XML-Element ohne untergeordnete Elemente enthält. XML-Objekte, die Kommentare und Verarbeitungsanweisungen repräsentieren, enthalten <i class="+ topic/ph hi-d/i ">keinen</i> einfachen Inhalt. |
| |
| </apiDesc><example conref="examples\XML.hasComplexContent.1.as" class="- topic/example "> Im folgenden Beispiel sehen Sie ein XML-Objekt mit einer Eigenschaft namens <codeph class="+ topic/ph pr-d/codeph ">a</codeph> und einfachem Inhalt sowie eine Eigenschaft namens <codeph class="+ topic/ph pr-d/codeph ">a</codeph> und komplexem Inhalt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo> |
| <a> |
| text |
| </a> |
| <a> |
| <b/> |
| </a> |
| </foo>; |
| trace(xml.a[0].hasComplexContent()); // false |
| trace(xml.a[1].hasComplexContent()); // true |
| |
| trace(xml.a[0].hasSimpleContent()); // true |
| trace(xml.a[1].hasSimpleContent()); // false |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/hasComplexContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasComplexContent()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:inScopeNamespaces" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">inScopeNamespaces</apiName><shortdesc class="- topic/shortdesc "> |
| Listet, basierend auf dem übergeordneten Objekt, die Namespaces für das XML-Objekt auf.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.inScopeNamespaces, inScopeNamespaces |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array an Namespace-Objekten. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Listet, basierend auf dem übergeordneten Objekt, die Namespaces für das XML-Objekt auf. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:insertChildAfter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">insertChildAfter</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt den gegebenen „child2“-Parameter nach dem „child1“-Parameter in dieses XML-Objekt ein, und gibt das resultierende Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.insertChildAfter, insertChildAfter |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende XML-Objekt oder <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>. |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">child1</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt in dem Quellobjekt, das Sie vor <codeph class="+ topic/ph pr-d/codeph ">child2</codeph> einfügen. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">child2</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das einzufügende Objekt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt den gegebenen <codeph class="+ topic/ph pr-d/codeph ">child2</codeph>-Parameter nach dem <codeph class="+ topic/ph pr-d/codeph ">child1</codeph>-Parameter in dieses XML-Objekt ein, und gibt das resultierende Objekt zurück. Hat der Parameter <codeph class="+ topic/ph pr-d/codeph ">child1</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, fügt die Methode den Inhalt des Parameters <codeph class="+ topic/ph pr-d/codeph ">child2</codeph> <i class="+ topic/ph hi-d/i ">vor</i> allen untergeordneten Knoten des XML-Objekts ein (oder anders ausgedrückt: nach <i class="+ topic/ph hi-d/i ">none</i>). Hat <codeph class="+ topic/ph pr-d/codeph ">child1</codeph> jedoch einen Wert, existiert aber nicht im XML-Objekt, wird das XML-Objekt nicht geändert und es wird <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurückgegeben. |
| |
| <p class="- topic/p ">Wenn Sie diese Methode für einen untergeordneten XML-Knoten aufrufen, der kein Element ist (sondern Text, Attribut, Kommentar oder Verarbeitungsanweisung), so wird <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurückgegeben.</p> |
| |
| <p class="- topic/p ">Verwenden Sie den Operator <codeph class="+ topic/ph pr-d/codeph ">delete</codeph>, um den XML-Knoten zu entfernen.</p> |
| |
| </apiDesc><example conref="examples\XML.insertChildAfter.1.as" class="- topic/example "> In diesem Beispiel wird am Ende der child-Elemente eines XML-Objekts ein Element angehängt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <menu> |
| <item>burger</item> |
| <item>soda</item> |
| </menu>; |
| xml.insertChildAfter(xml.item[0], <saleItem>fries</saleItem>); |
| trace(xml); |
| </codeblock> Die <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe lautet wie folgt: |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph "> <menu> |
| <item>burger</item> |
| <saleItem>fries</saleItem> |
| <item>soda</item> |
| </menu></codeph></pre> |
| </example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/insertChildBefore()" class="- topic/link "><linktext class="- topic/linktext ">XML.insertChildBefore()</linktext></link><link href="operators.html#delete_(XML)" class="- topic/link "><linktext class="- topic/linktext ">delete-(XML)-Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:insertChildBefore" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">insertChildBefore</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt den gegebenen „child2“-Parameter vor dem „child1“-Parameter in dieses XML-Objekt ein und gibt das resultierende Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.insertChildBefore, insertChildBefore |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende XML-Objekt oder <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>. |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">child1</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt in dem Quellobjekt, das Sie nach <codeph class="+ topic/ph pr-d/codeph ">child2</codeph> einfügen. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">child2</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das einzufügende Objekt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt den gegebenen <codeph class="+ topic/ph pr-d/codeph ">child2</codeph>-Parameter vor dem <codeph class="+ topic/ph pr-d/codeph ">child1</codeph>-Parameter in dieses XML-Objekt ein und gibt das resultierende Objekt zurück. Hat der Parameter <codeph class="+ topic/ph pr-d/codeph ">child1</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, fügt die Methode den Inhalt des Parameters <codeph class="+ topic/ph pr-d/codeph ">child2</codeph> <i class="+ topic/ph hi-d/i ">nach</i> allen untergeordneten Knoten des XML-Objekts ein (oder anders ausgedrückt: vor <i class="+ topic/ph hi-d/i ">none</i>). Hat <codeph class="+ topic/ph pr-d/codeph ">child1</codeph> jedoch einen Wert, existiert aber nicht im XML-Objekt, wird das XML-Objekt nicht geändert und es wird <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurückgegeben. |
| |
| <p class="- topic/p ">Wenn Sie diese Methode für einen untergeordneten XML-Knoten aufrufen, der kein Element ist (sondern Text, Attribut, Kommentar oder Verarbeitungsanweisung), so wird <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurückgegeben.</p> |
| |
| <p class="- topic/p ">Verwenden Sie den Operator <codeph class="+ topic/ph pr-d/codeph ">delete</codeph>, um den XML-Knoten zu entfernen.</p> |
| |
| </apiDesc><example conref="examples\XML.insertChildBefore.1.as" class="- topic/example "> In diesem Beispiel wird am Ende der child-Elemente eines XML-Objekts ein Element angehängt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <menu> |
| <item>burger</item> |
| <item>soda</item> |
| </menu>; |
| xml.insertChildBefore(xml.item[0], <saleItem>fries</saleItem>); |
| trace(xml); |
| </codeblock> Die <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe lautet wie folgt: |
| <pre xml:space="preserve" class="- topic/pre "> |
| <menu> |
| <saleItem>fries</saleItem> |
| <item>burger</item> |
| <item>soda</item> |
| </menu></pre> |
| </example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/insertChildAfter()" class="- topic/link "><linktext class="- topic/linktext ">XML.insertChildAfter()</linktext></link><link href="operators.html#delete_(XML)" class="- topic/link "><linktext class="- topic/linktext ">delete-(XML)-Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:length" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">length</apiName><shortdesc class="- topic/shortdesc "> |
| Für XML-Objekte gibt diese Methode immer die Ganzzahl 1 zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.length, length |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt für XML-Objekte immer den Wert <codeph class="+ topic/ph pr-d/codeph ">1</codeph> zurück. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Für XML-Objekte gibt diese Methode immer die Ganzzahl <codeph class="+ topic/ph pr-d/codeph ">1</codeph> zurück. Die <codeph class="+ topic/ph pr-d/codeph ">length()</codeph>-Methode der XMLList-Klasse gibt für ein XMLList-Objekt, das nur einen Wert enthält, den Wert <codeph class="+ topic/ph pr-d/codeph ">1</codeph> zurück. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:localName" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">localName</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Lokalteil des qualifizierten Namens des XML-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.localName, localName |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Lokalteil des Namens ist entweder ein String oder <codeph class="+ topic/ph pr-d/codeph ">null</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Lokalteil des qualifizierten Namens des XML-Objekts zurück. |
| |
| </apiDesc><example conref="examples\XML.localName.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Sie die <codeph class="+ topic/ph pr-d/codeph ">localName()</codeph>-Methode verwenden: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" |
| soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> |
| |
| <soap:Body xmlns:wx = "http://example.com/weather"> |
| <wx:forecast> |
| <wx:city>Quito</wx:city> |
| </wx:forecast> |
| </soap:Body> |
| </soap:Envelope>; |
| |
| trace(xml.localName()); // Envelope |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:name" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">name</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den qualifizierten Namen des XML-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.name, name |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der qualifizierte Namen ist entweder ein Qname oder <codeph class="+ topic/ph pr-d/codeph ">null</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den qualifizierten Namen des XML-Objekts zurück. |
| |
| </apiDesc><example conref="examples\XML.name.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Sie mit der <codeph class="+ topic/ph pr-d/codeph ">name()</codeph>-Methode den qualifizierten Namen eines XML-Objekts abrufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" |
| soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> |
| |
| <soap:Body xmlns:wx = "http://example.com/weather"> |
| <wx:forecast> |
| <wx:city>Quito</wx:city> |
| </wx:forecast> |
| </soap:Body> |
| </soap:Envelope>; |
| |
| trace(xml.name().localName); // Envelope |
| trace(xml.name().uri); // "http://www.w3.org/2001/12/soap-envelope" |
| </codeblock></example><example conref="examples\XML.name.2.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Sie die <codeph class="+ topic/ph pr-d/codeph ">name()</codeph>-Methode für eine XML-Eigenschaft, ein Textelement und ein Attribut aufrufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <foo x="15" y="22"> |
| text |
| </foo>; |
| |
| trace(xml.name().localName); // foo |
| trace(xml.name().uri == ""); // true |
| trace(xml.children()[0]); // text |
| trace(xml.children()[0].name()); // null |
| trace(xml.attributes()[0]); // 15 |
| trace(xml.attributes()[0].name()); // x |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/attributes()" class="- topic/link "><linktext class="- topic/linktext ">XML.attributes()</linktext></link><link href="operators.html#attribute_identifier" class="- topic/link "><linktext class="- topic/linktext ">Attributbezeichner</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:namespaceDeclarations" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">namespaceDeclarations</apiName><shortdesc class="- topic/shortdesc "> |
| Listet Namespace-Deklarationen auf, die mit dem XML-Objekt im Kontext des übergeordneten Knotens verbunden wurden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.namespaceDeclarations, namespaceDeclarations |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array an Namespace-Objekten. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Listet Namespace-Deklarationen auf, die mit dem XML-Objekt im Kontext des übergeordneten Knotens verbunden wurden. |
| |
| </apiDesc><example conref="examples\XML.namespaceDeclarations.1.as" class="- topic/example "> Im folgenden Beispiel werden die Namespace-Deklarationen eines XML-Objekts ausgegeben: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
| xmlns:dc="http://purl.org/dc/elements/1.1/" |
| xmlns="http://purl.org/rss/1.0/"> |
| |
| <!-- ... --> |
| |
| </rdf:RDF>; |
| |
| for (var i:uint = 0; i < xml.namespaceDeclarations().length; i++) { |
| var ns:Namespace = xml.namespaceDeclarations()[i]; |
| var prefix:String = ns.prefix; |
| if (prefix == "") { |
| prefix = "(default)"; |
| } |
| trace(prefix + ":" , ns.uri); |
| } |
| </codeblock> Die <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe lautet wie folgt: |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph ">rdf: http://www.w3.org/1999/02/22-rdf-syntax-ns# |
| dc: http://purl.org/dc/elements/1.1/ |
| (default): http://purl.org/rss/1.0/</codeph></pre> |
| </example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/namespace()" class="- topic/link "><linktext class="- topic/linktext ">XML.namespace()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:namespace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">namespace</apiName><shortdesc class="- topic/shortdesc "> |
| Wenn kein Parameter angegeben wird, gibt diese Methode den mit dem qualifizierten Namen dieses XML-Objekts verbundenen Namespace zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.namespace, namespace |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt <codeph class="+ topic/ph pr-d/codeph ">null</codeph>, <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> oder einen Namespace zurück. |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">prefix</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Präfix, das übereinstimmen soll. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wenn kein Parameter angegeben wird, gibt diese Methode den mit dem qualifizierten Namen dieses XML-Objekts verbundenen Namespace zurück. Wird ein <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph>-Parameter angegeben, gibt die Methode den Namespace zurück, der dem <codeph class="+ topic/ph pr-d/codeph ">prefix</codeph>-Parameter entspricht und sich im Gültigkeitsbereich des XML-Objekts befindet. Gibt es keinen solchen Namespace, gibt die Methode den Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurück. |
| |
| </apiDesc><example conref="examples\XML.namespace.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">namespace()</codeph>-Methode der Namespace eines XML-Objekts abgerufen und einem Namespace-Objekt namens <codeph class="+ topic/ph pr-d/codeph ">soap</codeph> zugewiesen, mit dem dann eine Eigenschaft des <codeph class="+ topic/ph pr-d/codeph ">xml</codeph>-Objekts identifiziert wird (<codeph class="+ topic/ph pr-d/codeph ">xml.soap::Body[0]</codeph>): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" |
| soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> |
| |
| <soap:Body xmlns:wx = "http://example.com/weather"> |
| <wx:forecast> |
| <wx:city>Quito</wx:city> |
| </wx:forecast> |
| </soap:Body> |
| </soap:Envelope>; |
| |
| var soap:Namespace = xml.namespace(); |
| trace(soap.prefix); // soap |
| trace(soap.uri); // http://www.w3.org/2001/12/soap-envelope |
| |
| var body:XML = xml.soap::Body[0]; |
| trace(body.namespace().prefix); // soap |
| trace(xml.namespace().uri); // http://www.w3.org/2001/12/soap-envelope |
| trace(body.namespace("wx").uri); // "http://example.com/weather" |
| </codeblock></example><example conref="examples\XML.namespace.2.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">namespace()</codeph>-Methode zum einen der Standard-Namespace für einen Knoten abgerufen sowie der Namespace für ein bestimmtes Präfix (<codeph class="+ topic/ph pr-d/codeph ">"dc"</codeph>): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
| xmlns:dc="http://purl.org/dc/elements/1.1/" |
| xmlns="http://purl.org/rss/1.0/"> |
| <!-- ... --> |
| </rdf:RDF>; |
| |
| trace(xml.namespace()); // http://www.w3.org/1999/02/22-rdf-syntax-ns# |
| trace(xml.namespace("dc")); // http://purl.org/dc/elements/1.1/ |
| trace(xml.namespace("foo")); // undefined |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:nodeKind" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">nodeKind</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Typ des Knotens an: Text-, Kommentar-, Verarbeitungsanweisungs-, Attribut- oder Elementknoten.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.nodeKind, nodeKind |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der verwendete Knotentyp. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Typ des Knotens an: Text-, Kommentar-, Verarbeitungsanweisungs-, Attribut- oder Elementknoten. |
| |
| </apiDesc><example conref="examples\XMLNodeKindExample1.as" class="- topic/example "> Im folgenden Beispiel werden alle 5 Knotentypen verfolgt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| XML.ignoreProcessingInstructions = false; |
| |
| var xml:XML = |
| <example id="10"> |
| <!-- this is a comment --> |
| <?test this is a pi ?> |
| and some text |
| </example>; |
| |
| trace(xml.nodeKind()); // element |
| trace(xml.children()[0].nodeKind()); // comment |
| trace(xml.children()[1].nodeKind()); // processing-instruction |
| trace(xml.children()[2].nodeKind()); // text |
| trace(xml.@id[0].nodeKind()); // attribute |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="operators.html#attribute_identifier" class="- topic/link "><linktext class="- topic/linktext ">Attributbezeichner</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:normalize" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">normalize</apiName><shortdesc class="- topic/shortdesc "> |
| Für das XML-Objekt und alle seine untergeordneten Elemente werden benachbarte Textknoten zusammengeführt und leere Textknoten entfernt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.normalize, normalize |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende normalisierte XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Für das XML-Objekt und alle seine untergeordneten Elemente werden benachbarte Textknoten zusammengeführt und leere Textknoten entfernt. |
| |
| </apiDesc><example conref="examples\XML.normalize.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, wie sich das Aufrufen der <codeph class="+ topic/ph pr-d/codeph ">normalize()</codeph>-Methode auswirkt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = <body></body>; |
| xml.appendChild("hello"); |
| xml.appendChild(" world"); |
| trace(xml.children().length()); // 2 |
| xml.normalize(); |
| trace(xml.children().length()); // 1 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:parent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">parent</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den übergeordneten Knoten des XML-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.parent, parent |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XML-Verweis auf den übergeordneten Knoten oder <codeph class="+ topic/ph pr-d/codeph ">undefinded</codeph>, wenn das XML-Objekt kein übergeordnetes Objekt hat. |
| |
| </apiDesc><apiType value="any" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den übergeordneten Knoten des XML-Objekts zurück. Besitzt das XML-Objekt keinen übergeordneten Knoten, gibt die Methode den Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> zurück. |
| |
| </apiDesc><example conref="examples\XML.parent.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">parent()</codeph>-Methode das übergeordnete Element eines bestimmten Elements in einer XML-Struktur identifiziert: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p id="p1">Hello</p> |
| <p id="p2">Test: |
| <ul> |
| <li>1</li> |
| <li>2</li> |
| </ul> |
| </p> |
| </body>; |
| var node:XML = xml.p.ul.(li.contains("1"))[0]; // == <ul> ... </ul> |
| trace(node.parent().@id); // p2 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:prependChild" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">prependChild</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt eine Kopie des bereitgestellten child-Objekts vor irgendwelchen vorhandenen XML-Eigenschaften für dieses Element in das XML-Element ein.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.prependChild, prependChild |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das einzufügende Objekt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt eine Kopie des bereitgestellten <codeph class="+ topic/ph pr-d/codeph ">child</codeph>-Objekts vor irgendwelchen vorhandenen XML-Eigenschaften für dieses Element in das XML-Element ein. |
| |
| <p class="- topic/p ">Verwenden Sie den Operator <codeph class="+ topic/ph pr-d/codeph ">delete</codeph>, um den XML-Knoten zu entfernen.</p> |
| |
| </apiDesc><example conref="examples\XML.prependChild.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">prependChild()</codeph>-Methode am Anfang der child-Liste eines XML-Objekts ein neues Element hinzugefügt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>hello</p> |
| </body>; |
| |
| xml.prependChild(<p>world</p>); |
| trace(xml.p[0].toXMLString()); // <p>world</p> |
| trace(xml.p[1].toXMLString()); // <p>hello</p> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="operators.html#delete_(XML)" class="- topic/link "><linktext class="- topic/linktext ">delete-(XML)-Operator</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:processingInstructions" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">processingInstructions</apiName><shortdesc class="- topic/shortdesc "> |
| Wird ein name-Parameter bereitgestellt, werden alle untergeordneten Knoten des XML-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen enthalten.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.processingInstructions, processingInstructions |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Liste an passenden untergeordneten Objekten. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">*</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Name der gesuchten Verarbeitungsanweisung. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wird ein <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter bereitgestellt, werden alle untergeordneten Knoten des XML-Objekts aufgelistet, die Verarbeitungsanweisungen mit diesem Namen (<codeph class="+ topic/ph pr-d/codeph ">name</codeph>) enthalten. Ohne Parameter listet diese Methode alle untergeordneten Knoten des XML-Objekts auf, die irgendwelche Verarbeitungsanweisungen enthalten. |
| |
| </apiDesc><example conref="examples\XML.processingInstructions.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">processingInstructions()</codeph>-Methode ein Array mit Verarbeitungsanweisungen für ein XML-Objekt abgerufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreProcessingInstructions = false; |
| var xml:XML = |
| <body> |
| foo |
| <?xml-stylesheet href="headlines.css" type="text/css" ?> |
| <?instructionX ?> |
| |
| </body>; |
| |
| trace(xml.processingInstructions().length()); // 2 |
| trace(xml.processingInstructions()[0].name()); // xml-stylesheet |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:propertyIsEnumerable" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">propertyIsEnumerable</apiName><shortdesc class="- topic/shortdesc "> |
| Prüft, ob sich die Eigenschaft „p“ in dem Satz an Eigenschaften befindet, die in einer auf das XMLList-Objekt angewendeten „for..in-Anweisung durchlaufen werden können.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.propertyIsEnumerable, propertyIsEnumerable |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn die Eigenschaft in einer <codeph class="+ topic/ph pr-d/codeph ">for..in</codeph>-Anweisung durchlaufen werden kann, lautet der Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">p</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Eigenschaft, die überprüft werden soll. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Prüft, ob sich die Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">p</codeph> in dem Satz an Eigenschaften befindet, die in einer auf das XML-Objekt angewendeten <codeph class="+ topic/ph pr-d/codeph ">for..in</codeph>-Anweisung durchlaufen werden können. Gibt nur <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn <codeph class="+ topic/ph pr-d/codeph ">toString(p) == "0"</codeph>. |
| |
| </apiDesc><example conref="examples\XML.propertyIsEnumerable.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, dass die <codeph class="+ topic/ph pr-d/codeph ">propertyNameIsEnumerable()</codeph>-Methode für ein XML-Objekt den Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> nur für den Wert <codeph class="+ topic/ph pr-d/codeph ">0</codeph> zurückgibt; dagegen lautet bei einem XMLList-Objekt der Rückgabewert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> für jeden gültigen Indexwert des XMLList-Objekts: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>Hello</p> |
| <p>World</p> |
| </body>; |
| |
| trace(xml.propertyIsEnumerable(0)); // true |
| trace(xml.propertyIsEnumerable(1)); // false |
| |
| for (var propertyName:String in xml) { |
| trace(xml[propertyName]); |
| } |
| |
| var list:XMLList = xml.p; |
| trace(list.propertyIsEnumerable(0)); // true |
| trace(list.propertyIsEnumerable(1)); // true |
| trace(list.propertyIsEnumerable(2)); // false |
| |
| for (var propertyName:String in list) { |
| trace(list[propertyName]); |
| } |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:removeNamespace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">removeNamespace</apiName><shortdesc class="- topic/shortdesc "> |
| Entfernt den gegebenen Namespace für dieses Objekt und alle untergeordneten Elemente.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.removeNamespace, removeNamespace |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Kopie des resultierenden XML-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ns</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Namespace</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der zu entfernende Namespace. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Entfernt den gegebenen Namespace für dieses Objekt und alle untergeordneten Elemente. Die <codeph class="+ topic/ph pr-d/codeph ">removeNamespaces()</codeph>-Methode entfernt keinen Namespace, wenn vom qualifizierten Namen des Objekts darauf verwiesen wird oder vom qualifizierten Namen des Objektattributs. |
| |
| </apiDesc><example conref="examples\XML.removeNamespace.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Sie eine Namespace-Deklaration aus einem XML-Objekt entfernen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" |
| xmlns:dc="http://purl.org/dc/elements/1.1/" |
| xmlns="http://purl.org/rss/1.0/"> |
| |
| <!-- ... --> |
| |
| </rdf:RDF>; |
| |
| trace(xml.namespaceDeclarations().length); // 3 |
| trace(xml.namespaceDeclarations()[0] is String); // |
| var dc:Namespace = xml.namespace("dc"); |
| xml.removeNamespace(dc); |
| trace(xml.namespaceDeclarations().length); // 2 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:replace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">replace</apiName><shortdesc class="- topic/shortdesc "> |
| Ersetzt die im Parameter propertyName angegebenen Eigenschaften durch den gegebenen value-Parameter.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.replace, replace |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende XML-Objekt, in dem die übereinstimmenden Eigenschaften ersetzt worden sind. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">propertyName</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Kann ein numerischer Wert sein, ein nicht qualifizierter Name für ein Set an XML-Elementen, ein qualifizierter Name für ein Set an XML-Elementen oder der Sternchenplatzhalter („*“). Einen nicht qualifizierten Namen verwenden Sie, um XML-Elemente im Standard-Namespace zu identifizieren. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Ersetzungswert. Das kann ein XML-Objekt sein, ein XMLList-Objekt oder jeder beliebige Wert, der mit <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> umgewandelt werden kann. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ersetzt die im Parameter <codeph class="+ topic/ph pr-d/codeph ">propertyName</codeph> angegebenen Eigenschaften durch den gegebenen <codeph class="+ topic/ph pr-d/codeph ">value</codeph>-Parameter. Werden keine Eigenschaften gefunden, die mit <codeph class="+ topic/ph pr-d/codeph ">propertyName</codeph> übereinstimmen, bleibt das XML-Objekt unverändert. |
| |
| </apiDesc><example conref="examples\XML.replace.1.as" class="- topic/example "> Im folgenden Beispiel wird die <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>-Methode mit einer Ganzzahl als erstem Parameter aufgerufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>Hello</p> |
| <p>World</p> |
| <hr/> |
| </body>; |
| |
| xml.replace(1, <p>Bob</p>); |
| trace(xml); |
| </codeblock> Der Code ergibt die folgende <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe: |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph "> |
| <body> |
| <p>Hello</p> |
| <p>Bob</p> |
| <hr/> |
| </body> |
| </codeph></pre> |
| </example><example conref="examples\XML.replace.2.as" class="- topic/example "> Im folgenden Beispiel wird die <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>-Methode mit einem String als erstem Parameter aufgerufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>Hello</p> |
| <p>World</p> |
| <hr/> |
| </body>; |
| |
| xml.replace("p", <p>Hi</p>); |
| trace(xml); |
| </codeblock> Der Code ergibt die folgende <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe: |
| |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph "> |
| <body> |
| <p>Hi</p> |
| <hr/> |
| </body>; |
| </codeph></pre> |
| </example><example conref="examples\XML.replace.3.as" class="- topic/example "> Im folgenden Beispiel wird die <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>-Methode mit einem „QName“ als erstem Parameter aufgerufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <ns:body xmlns:ns = "myNS"> |
| <ns:p>Hello</ns:p> |
| <ns:p>World</ns:p> |
| <hr/> |
| </ns:body>; |
| |
| var qname:QName = new QName("myNS", "p"); |
| xml.replace(qname, <p>Bob</p>); |
| trace(xml); |
| |
| </codeblock> Der Code ergibt die folgende <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe: |
| |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph "> |
| <ns:body xmlns:ns = "myNS"> |
| <p>Bob</p> |
| <hr/> |
| </ns:body> |
| </codeph></pre> |
| </example><example conref="examples\XML.replace.4.as" class="- topic/example "> Im folgenden Beispiel wird die <codeph class="+ topic/ph pr-d/codeph ">replace()</codeph>-Methode zusammen mit dem String <codeph class="+ topic/ph pr-d/codeph ">"*"</codeph> als erstem Parameter aufgerufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>Hello</p> |
| <p>World</p> |
| <hr/> |
| </body>; |
| |
| xml.replace("*", <img src = "hello.jpg"/>); |
| trace(xml); |
| </codeblock> Der Code ergibt die folgende <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Ausgabe: |
| |
| <pre xml:space="preserve" class="- topic/pre "><codeph class="+ topic/ph pr-d/codeph "> |
| <body> |
| <img src="hello.jpg"/> |
| </body> |
| </codeph></pre> |
| </example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:setChildren" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setChildren</apiName><shortdesc class="- topic/shortdesc "> |
| Ersetzt die untergeordneten Eigenschaften des XML-Objekts durch das angegebene Set an XML-Eigenschaften, das im Parameter value bereitgestellt wird.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.setChildren, setChildren |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das resultierende XML-Objekt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die zu ersetzenden XML-Eigenschaften. Dabei kann es sich um ein einzelnes XML-Objekt handeln oder um ein XMLList-Objekt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ersetzt die untergeordneten Eigenschaften des XML-Objekts durch das angegebene Set an XML-Eigenschaften, das im Parameter <codeph class="+ topic/ph pr-d/codeph ">value</codeph> bereitgestellt wird. |
| |
| </apiDesc><example conref="examples\XML.setChildren.1.as" class="- topic/example "> Im folgenden Beispiel wird das Aufrufen der <codeph class="+ topic/ph pr-d/codeph ">setChildren()</codeph>-Methode veranschaulicht, und zwar zuerst mit einem XML-Objekt als Parameter und dann mit einem XMLList-Objekt als Parameter: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| <p>Hello</p> |
| <p>World</p> |
| </body>; |
| |
| var list:XMLList = xml.p; |
| |
| xml.setChildren(<p>hello</p>); |
| trace(xml); |
| |
| // <body> |
| // <p>hello</p> |
| // </body> |
| |
| xml.setChildren(list); |
| trace(xml); |
| |
| // <body> |
| // <p>Hello</p> |
| // <p>World</p> |
| // </body> |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:setLocalName" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setLocalName</apiName><shortdesc class="- topic/shortdesc "> |
| Ändert den Lokalteil des XML-Objektnamens in den gegebenen name-Parameter.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.setLocalName, setLocalName |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der im Lokalteil zu ersetzende Name. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ändert den Lokalteil des XML-Objektnamens in den gegebenen <codeph class="+ topic/ph pr-d/codeph ">name</codeph>-Parameter. |
| |
| </apiDesc><example conref="examples\XML.setLocalName.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">setLocalName()</codeph>-Methode der lokale Name eines XML-Elements geändert: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <ns:item xmlns:ns="http://example.com"> |
| toothbrush |
| </ns:item>; |
| |
| xml.setLocalName("orderItem"); |
| trace(xml.toXMLString()); // <ns:orderItem xmlns:ns="http://example.com">toothbrush</ns:orderItem> |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:setName" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setName</apiName><shortdesc class="- topic/shortdesc "> |
| Setzt den Namen des XML-Objekts auf den gegebenen qualifizierten Namen oder Attributnamen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.setName, setName |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">name</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der neue Name für das Objekt. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Setzt den Namen des XML-Objekts auf den gegebenen qualifizierten Namen oder Attributnamen. |
| |
| </apiDesc><example conref="examples\XML.setName.1.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">setName()</codeph>-Methode der Name eines XML-Elements geändert: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <item> |
| toothbrush |
| </item>; |
| |
| xml.setName("orderItem"); |
| trace(xml.toXMLString()); // <orderItem>toothbrush</orderItem> |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:setNamespace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setNamespace</apiName><shortdesc class="- topic/shortdesc "> |
| Setzt den mit dem XML-Objekt verbundenen Namespace.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.setNamespace, setNamespace |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">ns</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Namespace</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der neue Namespace. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Setzt den mit dem XML-Objekt verbundenen Namespace. |
| |
| </apiDesc><example conref="examples\XML.setNamespace.1.as" class="- topic/example "> Im folgenden Beispiel wird der <codeph class="+ topic/ph pr-d/codeph ">soap</codeph>-Namespace, der in einem XML-Objekt definiert wurde, auf den Namespace eines anderen XML-Objekts angewendet (<codeph class="+ topic/ph pr-d/codeph ">xml2</codeph>): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml1:XML = |
| <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope" |
| soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding"> |
| <!-- ... --> |
| </soap:Envelope>; |
| var ns:Namespace = xml1.namespace("soap"); |
| |
| var xml2:XML = |
| <Envelope> |
| <Body/> |
| </Envelope>; |
| |
| xml2.setNamespace(ns); |
| |
| trace(xml2); |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:setSettings" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">setSettings</apiName><shortdesc class="- topic/shortdesc "> |
| Setzt die Werte für die folgenden XML-Eigenschaften: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent und prettyPrinting.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.setSettings, setSettings |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">rest</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt mit jeder der folgenden Eigenschaften: |
| |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreComments</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">prettyIndent</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">prettyPrinting</codeph></li></ul> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Setzt die Werte für die folgenden XML-Eigenschaften: <codeph class="+ topic/ph pr-d/codeph ">ignoreComments</codeph>, <codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions</codeph>, <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph>, <codeph class="+ topic/ph pr-d/codeph ">prettyIndent</codeph> und <codeph class="+ topic/ph pr-d/codeph ">prettyPrinting</codeph>. Im folgenden sind die Standardeinstellungen aufgelistet, die anwendet werden, wenn kein <codeph class="+ topic/ph pr-d/codeph ">setObj</codeph>-Parameter bereitgestellt wird. |
| |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">XML.ignoreComments = true</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">XML.ignoreProcessingInstructions = true</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">XML.ignoreWhitespace = true</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">XML.prettyIndent = 2</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">XML.prettyPrinting = true</codeph></li></ul> |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis</b>: Sie wenden diese Methode nicht auf eine Instanz der XML-Klasse an, sondern auf <codeph class="+ topic/ph pr-d/codeph ">XML</codeph>, wie im folgenden Code gezeigt: <codeph class="+ topic/ph pr-d/codeph ">XML.setSettings()</codeph>.</p> |
| |
| </apiDesc><example conref="examples\XML.defaultSettings.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht: wie Sie benutzerdefinierte Einstellungen (um Kommentare und Verarbeitungsanweisungen einzuschließen) anwenden, bevor Sie ein XML-Objekt einrichten; wie Sie dann die Standardeinstellungen wiederherstellen, bevor Sie ein weiteres XML-Objekt einrichten; und wie Sie dann wieder die benutzerdefinierte Einstellungen einrichten (um weitere XML-Objekte einzurichten): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| XML.ignoreProcessingInstructions = false; |
| var customSettings:Object = XML.settings(); |
| |
| var xml1:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml1.toXMLString()); |
| // <foo> |
| // <!-- comment --> |
| // <?instruction ?> |
| // </foo> |
| |
| XML.setSettings(XML.defaultSettings()); |
| var xml2:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml2.toXMLString()); |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/ignoreComments" class="- topic/link "><linktext class="- topic/linktext ">ignoreComments</linktext></link><link href="#XML/ignoreProcessingInstructions" class="- topic/link "><linktext class="- topic/linktext ">ignoreProcessingInstructions</linktext></link><link href="#XML/ignoreWhitespace" class="- topic/link "><linktext class="- topic/linktext ">ignoreWhitespace</linktext></link><link href="#XML/prettyIndent" class="- topic/link "><linktext class="- topic/linktext ">prettyIndent</linktext></link><link href="#XML/prettyPrinting" class="- topic/link "><linktext class="- topic/linktext ">prettyPrinting</linktext></link><link href="#XML/defaultSettings()" class="- topic/link "><linktext class="- topic/linktext ">defaultSettings()</linktext></link><link href="#XML/settings()" class="- topic/link "><linktext class="- topic/linktext ">settings()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:settings" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">settings</apiName><shortdesc class="- topic/shortdesc "> |
| Ruft die folgenden Eigenschaften ab: ignoreComments, ignoreProcessingInstructions, ignoreWhitespace, prettyIndent und prettyPrinting.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.settings, settings |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt mit den folgenden XML-Eigenschaften: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreComments</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">prettyIndent</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">prettyPrinting</codeph></li></ul> |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ruft die folgenden Eigenschaften ab: <codeph class="+ topic/ph pr-d/codeph ">ignoreComments</codeph>, <codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions</codeph>, <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph>, <codeph class="+ topic/ph pr-d/codeph ">prettyIndent</codeph> und <codeph class="+ topic/ph pr-d/codeph ">prettyPrinting</codeph>. |
| |
| </apiDesc><example conref="examples\XML.defaultSettings.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht: wie Sie benutzerdefinierte Einstellungen (um Kommentare und Verarbeitungsanweisungen einzuschließen) anwenden, bevor Sie ein XML-Objekt einrichten; wie Sie dann die Standardeinstellungen wiederherstellen, bevor Sie ein weiteres XML-Objekt einrichten; und wie Sie dann wieder die benutzerdefinierte Einstellungen einrichten (um weitere XML-Objekte einzurichten): |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| XML.ignoreProcessingInstructions = false; |
| var customSettings:Object = XML.settings(); |
| |
| var xml1:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml1.toXMLString()); |
| // <foo> |
| // <!-- comment --> |
| // <?instruction ?> |
| // </foo> |
| |
| XML.setSettings(XML.defaultSettings()); |
| var xml2:XML = |
| <foo> |
| <!-- comment --> |
| <?instruction ?> |
| </foo>; |
| trace(xml2.toXMLString()); |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/ignoreComments" class="- topic/link "><linktext class="- topic/linktext ">XML.ignoreComments</linktext></link><link href="#XML/ignoreProcessingInstructions" class="- topic/link "><linktext class="- topic/linktext ">XML.ignoreProcessingInstructions</linktext></link><link href="#XML/ignoreWhitespace" class="- topic/link "><linktext class="- topic/linktext ">XML.ignoreWhitespace</linktext></link><link href="#XML/prettyIndent" class="- topic/link "><linktext class="- topic/linktext ">XML.prettyIndent</linktext></link><link href="#XML/prettyPrinting" class="- topic/link "><linktext class="- topic/linktext ">XML.prettyPrinting</linktext></link><link href="#XML/defaultSettings()" class="- topic/link "><linktext class="- topic/linktext ">XML.defaultSettings()</linktext></link><link href="#XML/setSettings()" class="- topic/link "><linktext class="- topic/linktext ">XML.setSettings()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:text" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">text</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt ein XMLList-Objekt zurück mit allen XML-Eigenschaften des XML-Objekts, die XML-Textknoten darstellen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.text, text |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Liste der Eigenschaften. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt ein XMLList-Objekt zurück mit allen XML-Eigenschaften des XML-Objekts, die XML-Textknoten darstellen. |
| |
| </apiDesc><example conref="examples\XML.text.1.as" class="- topic/example "> Das folgende Beispiel veranschaulicht, wie Sie mit der <codeph class="+ topic/ph pr-d/codeph ">text()</codeph>-Methode die Textknoten eines XML-Objekts abgerufen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <body> |
| text1 |
| <hr/> |
| text2 |
| </body>; |
| trace(xml.text()[0]); // text1 |
| trace(xml.text()[1]); // text2 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="XML:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das XML-Objekt als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.toString, toString |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des XML-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das XML-Objekt als String zurück. Nach welchen Regeln diese Konvertierung vollzogen wird, ist abhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt hat: |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Hat das XML-Objekt einen einfachen Inhalt, gibt <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> den String-Inhalt des XML-Objekts zurück, wobei das Start-Tag, vorhandene Attribute, Namespace-Deklarationen und das Endtag entfernt werden.</li></ul> |
| |
| <ul class="- topic/ul "><li class="- topic/li "> Hat das XML-Objekt einen komplexen Inhalt, gibt <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> das gesamte XML-Objekt als XML-kodierten String zurück, einschließlich Start-Tag, Attributen, Namespace-Deklarationen und End-Tag.</li></ul> |
| |
| <p class="- topic/p ">Damit jedes Mal das gesamte XML-Objekt zurückgegeben wird, verwenden Sie die Methode <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph>.</p> |
| |
| |
| </apiDesc><example conref="examples\XMLToStringExample1.as" class="- topic/example "> Im folgende Beispiel wird veranschaulicht, was die <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Methode zurückgibt, wenn das XML-Objekt einen einfachen Inhalt hat: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var test:XML = <type name="Joe">example</type>; |
| trace(test.toString()); //example |
| </codeblock></example><example conref="examples\XMLToStringExample2.as" class="- topic/example "> Im folgende Beispiel wird veranschaulicht, was die <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Methode zurückgibt, wenn das XML-Objekt einen komplexen Inhalt hat: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var test:XML = |
| <type name="Joe"> |
| <base name="Bob"></base> |
| example |
| </type>; |
| trace(test.toString()); |
| // <type name="Joe"> |
| // <base name="Bob"/> |
| // example |
| // </type> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/hasSimpleContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasSimpleContent()</linktext></link><link href="#XML/hasComplexContent()" class="- topic/link "><linktext class="- topic/linktext ">XML.hasComplexContent()</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">XML.toXMLString()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:toXMLString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toXMLString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das XML-Objekt als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.toXMLString, toXMLString |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des XML-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das XML-Objekt als String zurück. Im Gegensatz zur Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> gibt die Methode <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph> immer das Start-Tag, vorhandene Attribute und das End-Tag des XML-Objekts zurück, unabhängig davon, ob das XML-Objekt einen einfachen oder komplexen Inhalt hat. (Die Methode <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> entfernt alle diese Elemente für XML-Objekte mit einfachem Inhalt.) |
| |
| </apiDesc><example conref="examples\XML.toXMLString.1.as" class="- topic/example "> Im folgenden Beispiel wird die unterschiedliche Wirkung der <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Methode (die standardmäßig auf alle Parameter einer <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Methode angewendet wird) und der <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph>-Methode veranschaulicht: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = |
| <p>hello</p>; |
| trace(xml); // hello |
| trace(xml.toXMLString()); // <p>hello</p> |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#XML/toString()" class="- topic/link "><linktext class="- topic/linktext ">XML.toString()</linktext></link></related-links></apiOperation><apiOperation id="XML:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt das XML-Objekt zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.valueOf, valueOf |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Grundwert einer XML-Instanz. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt das XML-Objekt zurück. |
| |
| </apiDesc><example conref="examples\XML.valueOf.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, dass der Rückgabewert der <codeph class="+ topic/ph pr-d/codeph ">valueOf()</codeph>-Methode identisch ist mit dem XML-Quellobjekt: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = <p>hello</p>; |
| trace(xml.valueOf() === xml); // true |
| </codeblock></example></apiOperationDetail></apiOperation><apiValue id="XML:ignoreComments:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">ignoreComments</apiName><shortdesc class="- topic/shortdesc "> |
| Legt fest, ob XML-Kommentare ignoriert werden, wenn XML-Objekte die XML-Quelldaten analysieren.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.ignoreComments, ignoreComments |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt fest, ob XML-Kommentare ignoriert werden, wenn XML-Objekte die XML-Quelldaten analysieren. Standardmäßig werden Kommentare ignoriert (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>). Um XML-Kommentare einzubeziehen, rufen Sie <codeph class="+ topic/ph pr-d/codeph ">false</codeph> auf. Die <codeph class="+ topic/ph pr-d/codeph ">ignoreComments</codeph>-Eigenschaft wird nur während der XML-Analyse verwendet, nicht etwa beim Aufruf von Methoden, wie <codeph class="+ topic/ph pr-d/codeph ">myXMLObject.child(~~).toXMLString()</codeph>. Enthält das XML-Quelldokument Kommentarknoten, werden sie während der XML-Analyse durch den Parser beibehalten oder verworfen. |
| |
| </apiDesc><example conref="examples\XML.ignoreComments.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, welche Wirkung es hat, wenn Sie <codeph class="+ topic/ph pr-d/codeph ">XML.ignoreComments</codeph> auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph> und <codeph class="+ topic/ph pr-d/codeph ">true</codeph> setzen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreComments = false; |
| var xml1:XML = |
| <foo> |
| <!-- comment --> |
| </foo>; |
| trace(xml1.toXMLString()); // <foo><!-- comment --></foo> |
| |
| XML.ignoreComments = true; |
| var xml2:XML = |
| <foo> |
| <!-- example --> |
| </foo>; |
| trace(xml2.toXMLString()); // <foo/> |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="#XML/child()" class="- topic/link "><linktext class="- topic/linktext ">XML.child()</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">XML.toXMLString()</linktext></link></related-links></apiValue><apiValue id="XML:ignoreProcessingInstructions:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">ignoreProcessingInstructions</apiName><shortdesc class="- topic/shortdesc "> |
| Legt fest, ob XML-Verarbeitungsanweisungen ignoriert werden, wenn XML-Objekte die XML-Quelldaten analysieren.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.ignoreProcessingInstructions, ignoreProcessingInstructions |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt fest, ob XML-Verarbeitungsanweisungen ignoriert werden, wenn XML-Objekte die XML-Quelldaten analysieren. Standardmäßig werden Verarbeitungsanweisungen ignoriert (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>). Um XML-Verarbeitungsanweisungen einzubeziehen, rufen Sie <codeph class="+ topic/ph pr-d/codeph ">false</codeph> auf. Die <codeph class="+ topic/ph pr-d/codeph ">ignoreProcessingInstructions</codeph>-Eigenschaft wird nur während der XML-Analyse verwendet, nicht etwa beim Aufruf von Methoden wie <codeph class="+ topic/ph pr-d/codeph ">myXMLObject.child(~~).toXMLString()</codeph>. Enthält das XML-Quelldokument Verarbeitungsanweisungen, werden sie während der XML-Analyse durch den Parser beibehalten oder verworfen. |
| |
| </apiDesc><example conref="examples\XML.ignoreProcessingInstructions.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, welche Wirkung es hat, wenn Sie <codeph class="+ topic/ph pr-d/codeph ">XML.ignoreProcessingInstructions</codeph> auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph> und <codeph class="+ topic/ph pr-d/codeph ">true</codeph> setzen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreProcessingInstructions = false; |
| var xml1:XML = |
| <foo> |
| <?exampleInstruction ?> |
| </foo>; |
| trace(xml1.toXMLString()); // <foo><?exampleInstruction ?></foo> |
| |
| XML.ignoreProcessingInstructions = true; |
| var xml2:XML = |
| <foo> |
| <?exampleInstruction ?> |
| </foo>; |
| trace(xml2.toXMLString()); // <foo/> |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="#XML/child()" class="- topic/link "><linktext class="- topic/linktext ">XML.child()</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">XML.toXMLString()</linktext></link></related-links></apiValue><apiValue id="XML:ignoreWhitespace:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">ignoreWhitespace</apiName><shortdesc class="- topic/shortdesc "> |
| Legt fest, ob während der Analyse durch den Parser Leerraumzeichen am Anfang und Ende von Textknoten ignoriert werden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.ignoreWhitespace, ignoreWhitespace |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt fest, ob während der Analyse durch den Parser Leerraumzeichen am Anfang und Ende von Textknoten ignoriert werden. Standardmäßig wird Leerraum ignoriert (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>). Besteht ein Textknoten zu 100 % aus Leerraum und die <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph>-Eigenschaft ist auf <codeph class="+ topic/ph pr-d/codeph ">true</codeph> gesetzt, wird der Knoten nicht erstellt. Um Leerraum in einem Textknoten anzuzeigen, setzen Sie die <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph>-Eigenschaft auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| <p class="- topic/p ">Wenn Sie ein XML-Objekt erstellen, wird der aktuelle Wert der <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph>-Eigenschaft zwischengespeichert. Durch das Ändern von <codeph class="+ topic/ph pr-d/codeph ">ignoreWhitespace</codeph> wird das Verhalten von vorhandenen XML-Objekten nicht geändert.</p> |
| |
| </apiDesc><example conref="examples\XML.ignoreWhitespace.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, welche Wirkung es hat, wenn Sie <codeph class="+ topic/ph pr-d/codeph ">XML.ignoreWhitespace</codeph> auf <codeph class="+ topic/ph pr-d/codeph ">false</codeph> und <codeph class="+ topic/ph pr-d/codeph ">true</codeph> setzen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| XML.ignoreWhitespace = false; |
| var xml1:XML = <foo> </foo>; |
| trace(xml1.children().length()); // 1 |
| |
| XML.ignoreWhitespace = true; |
| var xml2:XML = <foo> </foo>; |
| trace(xml2.children().length()); // 0 |
| </codeblock></example></apiValueDetail></apiValue><apiValue id="XML:prettyIndent:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">prettyIndent</apiName><shortdesc class="- topic/shortdesc "> |
| Legt die Breite der Einrückung fest, die von den Methoden toString() und toXMLString() angewendet wird, wenn die Eigenschaft XML.prettyPrinting auf „true“ gesetzt ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.prettyIndent, prettyIndent |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">int</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt die Breite der Einrückung fest, die von den Methoden <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph> angewendet wird, wenn die <codeph class="+ topic/ph pr-d/codeph ">XML.prettyPrinting</codeph>-Eigenschaft auf <codeph class="+ topic/ph pr-d/codeph ">true</codeph> gesetzt ist. Die Einrückung wird mit dem Leerzeichen angewendet und nicht etwa mit dem Tabulatorzeichen. Der Standardwert ist <codeph class="+ topic/ph pr-d/codeph ">2</codeph>. |
| |
| </apiDesc><example conref="examples\XML.prettyIndent.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, welche Wirkung es hat, wenn Sie die statische Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">XML.prettyIndent</codeph> festlegen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = <foo><bar/></foo>; |
| XML.prettyIndent = 0; |
| trace(xml.toXMLString()); |
| |
| XML.prettyIndent = 1; |
| trace(xml.toXMLString()); |
| |
| XML.prettyIndent = 2; |
| trace(xml.toXMLString()); |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="#XML/prettyPrinting" class="- topic/link "><linktext class="- topic/linktext ">prettyPrinting</linktext></link><link href="#XML/toString()" class="- topic/link "><linktext class="- topic/linktext ">toString()</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">toXMLString()</linktext></link></related-links></apiValue><apiValue id="XML:prettyPrinting:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">prettyPrinting</apiName><shortdesc class="- topic/shortdesc "> |
| Legt fest, ob die Methoden toString() und toXMLString() Leerraumzeichen zwischen einigen Tags normalisieren.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">XML, XML.prettyPrinting, prettyPrinting |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Legt fest, ob die Methoden <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph> und <codeph class="+ topic/ph pr-d/codeph ">toXMLString()</codeph> Leerraumzeichen zwischen einigen Tags normalisieren. Der Standardwert ist <codeph class="+ topic/ph pr-d/codeph ">true</codeph>. |
| |
| </apiDesc><example conref="examples\XML.prettyPrinting.1.as" class="- topic/example "> Im folgenden Beispiel wird veranschaulicht, welche Wirkung es hat, wenn Sie die statische Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">XML.prettyPrinting</codeph> festlegen: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var xml:XML = <foo><bar/></foo>; |
| XML.prettyPrinting = false; |
| trace(xml.toXMLString()); |
| |
| XML.prettyPrinting = true; |
| trace(xml.toXMLString()); |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="#XML/prettyIndent" class="- topic/link "><linktext class="- topic/linktext ">prettyIndent</linktext></link><link href="#XML/toString()" class="- topic/link "><linktext class="- topic/linktext ">toString()</linktext></link><link href="#XML/toXMLString()" class="- topic/link "><linktext class="- topic/linktext ">toXMLString()</linktext></link></related-links></apiValue></apiClassifier><apiOperation id="globalOperation:Array" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">Array</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues Array.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array mit einer Länge von mindestens 0. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Array</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Sie können: keine Argumente für ein leeres Array, ein einzelnes Integer-Argument für ein Array bestimmter Länge, oder ein einzelnes Objekt zum Erstellen eines Arrays mit diesem einen Objekt übergeben. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues Array. Das Array kann eine Länge von null oder mehr aufweisen, oder es kann sich um ein Array handeln, das mit einem einzelnen, angegebenen Objekt gefüllt ist. |
| <ul class="- topic/ul "><li class="- topic/li ">Wenn Sie <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph> ohne Argumente aufrufen, wird ein leeres Array zurückgegeben.</li><li class="- topic/li ">Wenn Sie <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph> mit einem einzigen, ganzzahligen Argument aufrufen, wird ein Array der angegebenen Länge zurückgegeben, für dessen Elemente aber keine Werte definiert sind.</li><li class="- topic/li ">Beim Aufruf von <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph> mit einem angegebenen Objekt wird ein Array mit einem Element des angegebenen Objekts zurückgegeben.</li></ul> |
| Die Verwendung der <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion <i class="+ topic/ph hi-d/i ">ähnelt</i> dem Erstellen eines Arrays mit dem Array-Klassenkonstruktor, allerdings lässt die <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion nur einen oder keine Parameterwerte zu. Mit der <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion können Sie das neue Array nicht mit verschiedenen Werten füllen. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Wenn Sie versuchen, mit der <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion ein neues Array zu erstellen und verschiedene Werte als Parameter übergeben, um das Array zu füllen, wird ein Compilerfehler ausgegeben. Die <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion lässt nur einen Parameter zu. Verwenden Sie stattdessen den Array-Klassenkonstruktor, um ein Array zu erstellen und mit mehreren Werten zu füllen.</p> |
| <p class="- topic/p ">Die <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion übernimmt den Typ eines Objekts nicht für ein Array. Mithilfe des Operators <codeph class="+ topic/ph pr-d/codeph ">as</codeph> können Sie eine ausdrückliche Datentypumwandlung oder -konvertierung festlegen, wenn das Argument kein Grundwert ist. Weitere Informationen finden Sie unten im Abschnitt „Beispiel“. Wenn Sie ein Objekt als Parameter an die <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>-Funktion übergeben, wird ein neues Array erstellt, das das Objekt als Element enthält.</p> |
| </apiDesc><example conref="examples\Array.func.4.as" class="- topic/example "> Das folgende Beispiel veranschaulicht das Verhalten der Funktion <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph>, wenn es sich bei einem Argument nicht um einen Grundwert handelt. Die Umwandlung in ein Array wird häufig verwendet, wenn eine Objektinstanz umgewandelt wird, deren Werte im Array-Format gespeichert werden. Wenn <codeph class="+ topic/ph pr-d/codeph ">Array()</codeph> mit einem Argument vom Typ <codeph class="+ topic/ph pr-d/codeph ">Object</codeph> oder einem anderen Datentyp, bei dem es sich nicht um Grundwerte handelt, aufgerufen wird, wird ein Verweis auf das Objekt in einem Element des neuen Arrays gespeichert. Anders ausgedrückt: Wenn als einziges Argument ein Objekt übergeben wird, wird ein Verweis auf dieses Objekt das erste Element des neuen Arrays. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var obj:Object = [ "a", "b", "c" ]; |
| |
| var newArray:Array = Array( obj ); |
| |
| trace(newArray == obj); // false |
| trace(newArray[0] == obj); // true |
| trace(newArray[0][0]) // a |
| trace(newArray[0][1]) // b |
| trace(newArray[0][2]) // c |
| </codeblock></example><example conref="examples\Array.func.5.as" class="- topic/example "> Um <codeph class="+ topic/ph pr-d/codeph ">obj</codeph> in ein Array umzuwandeln, verwenden Sie den Operator <codeph class="+ topic/ph pr-d/codeph ">as</codeph>. Es wird ein Array-Verweis zurückgegeben, wenn es sich bei<codeph class="+ topic/ph pr-d/codeph ">obj</codeph> um einen gültigen Array handelt; anderfalls <codeph class="+ topic/ph pr-d/codeph ">null</codeph>: |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var obj:Object = [ "a", "b", "c" ]; |
| |
| var newArray:Array = obj as Array; |
| |
| trace(newArray == obj); // true |
| trace(newArray[0]); // a |
| trace(newArray[1]); // b |
| trace(newArray[2]); // c |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#Array" class="- topic/link "><linktext class="- topic/linktext ">Array-Klasse</linktext></link><link href="operators.html#as" class="- topic/link "><linktext class="- topic/linktext ">as-Operator</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:Boolean" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">Boolean</apiName><shortdesc class="- topic/shortdesc "> |
| Wandelt den Parameter „expression“ in einen booleschen Wert um und gibt diesen Wert zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Ergebnis der Umwandlung in den Datentyp Boolean. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">expression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein in den Datentyp Boolean zu konvertierender Ausdruck oder eine Objekt. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wandelt den Parameter <codeph class="+ topic/ph pr-d/codeph ">expression</codeph> in einen booleschen Wert um und gibt diesen Wert zurück. |
| <p class="- topic/p ">Der Rückgabewert hängt, wie in der folgenden Tabelle beschrieben, vom Datentyp und Wert des Arguments ab:</p> |
| |
| <adobetable class="innertable"><tgroup cols="3" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Eingabewert</entry><entry class="- topic/entry ">Beispiel</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean(0)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean(NaN)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Number (nicht <codeph class="+ topic/ph pr-d/codeph ">0</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph>)</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean(4)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Leerer String</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean("")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Nicht leerer String</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean("6")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">„null“</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean(null)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">undefined</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean(undefined)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Instanz der Object-Klasse</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean(new Object())</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Kein Argument</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Boolean()</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row></tbody></tgroup></adobetable> |
| <p class="- topic/p ">Im Gegensatz zu früheren ActionScript-Versionen gibt die Funktion <codeph class="+ topic/ph pr-d/codeph ">Boolean()</codeph> dasselbe Ergebnis zurück wie der Klassenkonstruktor Boolean.</p> |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:Number" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">Number</apiName><shortdesc class="- topic/shortdesc "> |
| Konvertiert einen bestimmten Wert in einen Number-Wert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der konvertierte Number-Wert |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">expression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Wert, der in einen Number-Wert umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konvertiert einen bestimmten Wert in einen Number-Wert. Die folgende Tabelle zeigt das Ergebnis verschiedener Eingabetypen: |
| |
| <adobetable class="innertable"><tgroup cols="3" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Eingabetyp/-wert</entry><entry class="- topic/entry ">Beispiel</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">undefined</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number(undefined)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">„null“</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number(null)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number(true)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">1</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number(false)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number(NaN)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Leerer String</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number("")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">String, der in einen Number-Wert konvertiert wird</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number("5")</codeph></entry><entry class="- topic/entry ">Die Zahl (z. B. <codeph class="+ topic/ph pr-d/codeph ">5</codeph>)</entry></row><row class="- topic/row "><entry class="- topic/entry ">String, der nicht in einen Number-Wert konvertiert wird</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">Number("5a")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry></row></tbody></tgroup></adobetable> |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:Object" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">Object</apiName><shortdesc class="- topic/shortdesc "> |
| Jeder Wert in ActionScript 3.0 ist ein Objekt, d. h., wenn Sie für einen Wert Object() aufrufen, wird dieser Wert zurückgegeben.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der von dem Parameter <codeph class="+ topic/ph pr-d/codeph ">value</codeph> angegebene Wert. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt oder eine umzuwandelnde Zahl, ein String oder ein boolescher Wert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Jeder Wert in ActionScript 3.0 ist ein Objekt, d. h., wenn Sie für einen Wert <codeph class="+ topic/ph pr-d/codeph ">Object()</codeph> aufrufen, wird dieser Wert zurückgegeben. |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:String" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">String</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den angegebenen Parameter als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine für den Parameter <codeph class="+ topic/ph pr-d/codeph ">expression</codeph> übergebene Stringdarstellung des Werts. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">expression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc "> Ein Ausdruck, der in einen String umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den angegebenen Parameter als String zurück. |
| <p class="- topic/p ">Die folgende Tabelle zeigt das Ergebnis verschiedener Eingabetypen:</p> |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Eingabetyp/-wert</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">undefined</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">undefined</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">„null“</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">"null"</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">"true"</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">"false"</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">"NaN"</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">String</entry><entry class="- topic/entry ">String</entry></row><row class="- topic/row "><entry class="- topic/entry ">Object</entry><entry class="- topic/entry ">Object.toString()</entry></row><row class="- topic/row "><entry class="- topic/entry ">Number</entry><entry class="- topic/entry ">Die Stringdarstellung der Zahl</entry></row></tbody></tgroup></adobetable> |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:Vector" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">Vector</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt eine neue Vector-Instanz, deren Elemente Instanzen des festgelegten Datentyps sind.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><commentPrivate>The reason this compiles with the .<T> designation is because |
| a dummy class "T" is declared in the top level Vector.as file. If this file is |
| built without that one, the build will fail. |
| |
| </commentPrivate></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn das <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Argument ein Element enthält, das nicht in den festgelegten Datentyp konvertiert werden kann. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine mit den Elementen des <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Arrays gefüllte Vector-Instanz. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">sourceArray</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Array oder eine Vector-Instanz, dessen oder deren Elemente zu Elementen des Ergebnisvektors werden. Wenn das Argument eine Vector-Instanz ist, deren verknüpfter Datentyp gleich dem festgelegten Datentyp ist, wird das Argument als das Funktionsergebnis zurückgegeben. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt eine neue Vector-Instanz, deren Elemente Instanzen des festgelegten Datentyps sind. Wenn diese Funktion aufgerufen wird, legen Sie den Datentyp der Elemente des Ergebnisvektors (der <i class="+ topic/ph hi-d/i ">Basistyp</i> des Vectors) mithilfe eines type-Parameters fest. Diese Funktion verwendet die gleiche Syntax, die auch beim Deklarieren einer Vector-Instanz oder beim Aufrufen des <codeph class="+ topic/ph pr-d/codeph ">new Vector.<T>()</codeph>-Konstruktors benutzt wird: |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">var v:Vector.<String> = Vector.<String>(["Hello", "World"]);</codeblock> |
| |
| <p class="- topic/p ">Der Ergebnisvektor wird mit den Werten in den Elementen des <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Arguments gefüllt. Wenn das <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Argument bereits eine Vector.<T>-Instanz ist, in der <codeph class="+ topic/ph pr-d/codeph ">T</codeph> dem Basistyp entspricht, gibt die Funktion diesen Vector zurück. Andernfalls wird der Ergebnisvektor mit den Elementen aus dem <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Array oder dem Vector gefüllt.</p> |
| |
| <p class="- topic/p ">In beiden Fällen müssen die Datentypen von allen Elementen des <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Arguments mit dem im Funktionsaufruf festgelegten Basistyp <codeph class="+ topic/ph pr-d/codeph ">T</codeph> übereinstimmen.</p> |
| |
| <p class="- topic/p ">Wenn das <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Argument einen <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert von 0 hat, gibt die Funktion einen leeren Vector zurück.</p> |
| |
| <p class="- topic/p ">Wenn ein Vector als das <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Argument übergeben wird und sein Basistyp nicht <codeph class="+ topic/ph pr-d/codeph ">T</codeph> ist, oder wenn ein Array übergeben wird und nicht alle Elemente Instanzen vom Datentyp <codeph class="+ topic/ph pr-d/codeph ">T</codeph> sind, wird ein Versuch unternommen, die Werte in den Basistyp zu konvertieren. Wenn die Werte automatisch konvertiert werden können, enthält der Ergebnisvektor die konvertierten Werte. Wenn keine Konvertierung vorgenommen werden kann, tritt ein Fehler auf.</p> |
| |
| <p class="- topic/p ">Ist ein Element im <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Argument eine Instanz einer Unterklasse des Basistyps <codeph class="+ topic/ph pr-d/codeph ">T</codeph>, dann ist der Aufruf erfolgreich und das Element wird dem Ergebnisvektor hinzugefügt. Dies funktioniert auch, wenn das <codeph class="+ topic/ph pr-d/codeph ">sourceArray</codeph>-Argument ein Vector ist, dessen Basistyp eine Unterklasse von <codeph class="+ topic/ph pr-d/codeph ">T</codeph> ist. Dies stellt die einzige Möglichkeit dar, einen Vector mit dem Basistyp <codeph class="+ topic/ph pr-d/codeph ">T</codeph> in einen Vector mit einem Basistyp, der eine Superklasse von <codeph class="+ topic/ph pr-d/codeph ">T</codeph> ist, zu konvertieren.</p> |
| |
| <p class="- topic/p ">Der folgende Code führt z. B. zu einem Kompilierungsfehler im Strict-Modus oder einem TypeError zur Laufzeit, da versucht wird, ein Vector.<Sprite> einer Vector.<DisplayObject>-Variablen zuzuweisen (Sprite ist eine Unterklasse von DisplayObject):</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var v1:Vector.<Sprite> = new Vector.<Sprite>(); |
| v1[0] = new Sprite(); |
| var v2:Vector.<DisplayObject> = v1; |
| </codeblock> |
| |
| <p class="- topic/p ">Die folgende alternative Version des Codes kopiert die Elemente einer Vector.<Sprite>-Instanz erfolgreich in eine Vector.<DisplayObject>-Instanz:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var v1:Vector.<Sprite> = new Vector.<Sprite>(); |
| v1[0] = new Sprite(); |
| var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1); |
| </codeblock> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector" class="- topic/link "><linktext class="- topic/linktext ">Vector-Klasse</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:XMLList" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">XMLList</apiName><shortdesc class="- topic/shortdesc "> |
| Konvertiert ein Objekt in ein XMLList-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XML-Objekt, das Werte aus dem konvertierten Objekt enthält. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XMLList</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">expression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Wert wird in ein XMLList-Objekt konvertiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konvertiert ein Objekt in ein XMLList-Objekt. |
| <p class="- topic/p ">Die folgende Tabelle beschreibt Rückgabewerte für verschiedene Eingabetypen:</p> |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Parametertyp</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">Boolescher Ausdruck</entry><entry class="- topic/entry ">Der Wert wird erst in einen String konvertiert und anschließend in ein XMLList-Objekt.</entry></row><row class="- topic/row "><entry class="- topic/entry ">Null</entry><entry class="- topic/entry ">Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).</entry></row><row class="- topic/row "><entry class="- topic/entry ">Number</entry><entry class="- topic/entry ">Der Wert wird erst in einen String konvertiert und anschließend in ein XMLList-Objekt.</entry></row><row class="- topic/row "><entry class="- topic/entry ">Object</entry><entry class="- topic/entry ">Wird nur dann in einen XMLList-Objekt konvertiert, wenn es sich um einen String, eine Zahl oder einen booleschen Wert handelt. Andernfalls tritt während der Laufzeit ein Fehler auf (TypeError-Ausnahme).</entry></row><row class="- topic/row "><entry class="- topic/entry ">String</entry><entry class="- topic/entry ">Der Wert wird in ein XMLList-Objekt konvertiert.</entry></row><row class="- topic/row "><entry class="- topic/entry ">Nicht festgelegt</entry><entry class="- topic/entry ">Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).</entry></row><row class="- topic/row "><entry class="- topic/entry ">XML</entry><entry class="- topic/entry ">Der Wert wird in ein XMLList-Objekt konvertiert.</entry></row><row class="- topic/row "><entry class="- topic/entry ">XMLList</entry><entry class="- topic/entry ">Der Eingabewert wird unverändert zurückgegeben.</entry></row></tbody></tgroup></adobetable> |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/XML()" class="- topic/link "><linktext class="- topic/linktext ">XML()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:XML" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">XML</apiName><shortdesc class="- topic/shortdesc "> |
| Konvertiert ein Objekt in ein XML-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein XML-Objekt, das Werte aus dem konvertierten Objekt enthält. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">XML</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">expression</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Objekt, das in einen XML-Wert umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konvertiert ein Objekt in ein XML-Objekt. |
| <p class="- topic/p ">Die folgende Tabelle beschreibt Rückgabewerte für verschiedene Eingabetypen:</p> |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Parametertyp</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">Boolescher Ausdruck</entry><entry class="- topic/entry ">Der Wert wird erst in einen String konvertiert und anschließend in ein XML-Objekt.</entry></row><row class="- topic/row "><entry class="- topic/entry ">Null</entry><entry class="- topic/entry ">Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).</entry></row><row class="- topic/row "><entry class="- topic/entry ">Number</entry><entry class="- topic/entry ">Der Wert wird erst in einen String konvertiert und anschließend in ein XML-Objekt.</entry></row><row class="- topic/row "><entry class="- topic/entry ">Object</entry><entry class="- topic/entry ">Wird nur dann in einen XML-Wert konvertiert, wenn es sich um einen String, eine Zahl oder einen booleschen Wert handelt. Andernfalls tritt während der Laufzeit ein Fehler auf (TypeError-Ausnahme).</entry></row><row class="- topic/row "><entry class="- topic/entry ">String</entry><entry class="- topic/entry ">Wird in einen XML-Wert umgewandelt.</entry></row><row class="- topic/row "><entry class="- topic/entry ">Nicht festgelegt</entry><entry class="- topic/entry ">Während der Laufzeit tritt ein Fehler auf (TypeError-Ausnahme).</entry></row><row class="- topic/row "><entry class="- topic/entry ">XML</entry><entry class="- topic/entry ">Der Eingabewert wird unverändert zurückgegeben.</entry></row><row class="- topic/row "><entry class="- topic/entry ">XMLList</entry><entry class="- topic/entry ">Gibt nur dann ein XML-Objekt aus, wenn das XMLList-Objekt nur eine Eigenschaft vom Typ XML enthält. Andernfalls tritt während der Laufzeit ein Fehler auf (TypeError-Ausnahme).</entry></row></tbody></tgroup></adobetable> |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/XMLList()" class="- topic/link "><linktext class="- topic/linktext ">XMLList()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:decodeURIComponent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">decodeURIComponent</apiName><shortdesc class="- topic/shortdesc "> |
| Dekodiert eine kodierte URI-Komponente in einen String.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, in dem alle zuvor von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURIComponent</codeph> mit Escape-Sequenzen versehenen Zeichen wieder in die Darstellung ohne Escape-Sequenzen zurückversetzt werden. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uri</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein mit der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURIComponent</codeph> kodierter String. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Dekodiert eine kodierte URI-Komponente in einen String. Gibt einen String zurück, in dem alle zuvor von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURIComponent</codeph> mit Escape-Sequenzen versehenen Zeichen wieder in ihre unkodierte Darstellung zurück versetzt werden. |
| <p class="- topic/p ">Diese Funktion unterscheidet sich in so fern von der Funktion <codeph class="+ topic/ph pr-d/codeph ">decodeURI()</codeph> als sie für die Verwendung mit nur einem Teil des URI-Strings, einer sogenannten URI-Komponente, konzipiert ist. Eine URI-Komponente ist ein beliebiger Text, der zwischen speziellen Zeichen, den sogenannten <i class="+ topic/ph hi-d/i ">component separators</i>, erscheint <codeph class="+ topic/ph pr-d/codeph ">: ( / ; und ? </codeph>). Gewöhnliche Beispiele für URI-Komponenten sind „http“ oder „www.adobe.com“.</p> |
| <p class="- topic/p ">Ein weiterer wichtiger Unterschied zwischen dieser Funktion und <codeph class="+ topic/ph pr-d/codeph ">decodeURI()</codeph> ist, dass diese Funktion davon ausgeht, dass sie eine URI-Komponente verarbeitet, und somit die Escape-Sequenzen, die spezielle Trennzeichen repräsentieren (<codeph class="+ topic/ph pr-d/codeph ">; / ? : @ & = + $ , #</codeph>) als regulären Text behandelt, der dekodiert werden soll. </p> |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/decodeURI()" class="- topic/link "><linktext class="- topic/linktext ">decodeURI()</linktext></link><link href="#global/encodeURI()" class="- topic/link "><linktext class="- topic/linktext ">encodeURI()</linktext></link><link href="#global/encodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">encodeURIComponent()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:decodeURI" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">decodeURI</apiName><shortdesc class="- topic/shortdesc "> |
| Dekodiert einen kodierten URI in einen String.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, in dem alle zuvor von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURI</codeph> mit Escape-Sequenzen versehenen Zeichen wieder in die Darstellung ohne Escape-Sequenzen zurückversetzt werden. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uri</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein mit der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURI</codeph> kodierter String. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Dekodiert einen kodierten URI in einen String. Gibt einen String zurück, in dem alle zuvor von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURI</codeph> kodierten Zeichen wieder in ihre unkodierte Darstellung zurückversetzt werden. |
| <p class="- topic/p ">Die folgende Tabelle zeigt den Satz an Escape-Sequenzen, die <i class="+ topic/ph hi-d/i ">nicht</i> von der Funktion <codeph class="+ topic/ph pr-d/codeph ">decodeURI</codeph> in Zeichen dekodiert werden. Um die Escape-Sequenzen in dieser Tabelle zu dekodieren, verwenden Sie <codeph class="+ topic/ph pr-d/codeph ">decodeURIComponent()</codeph>.</p> |
| <adobetable class="innertable"><tgroup cols="2" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Nicht dekodierte Escape-Sequenzen</entry><entry class="- topic/entry ">Zeichenentsprechungen</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%23</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">#</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%24</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">$</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%26</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">&</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%2B</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">+</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%2C</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">,</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%2F</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">/</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%3A</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">:</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%3B</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">;</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%3D</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">=</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%3F</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">?</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">%40</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">@</codeph></entry></row></tbody></tgroup></adobetable> |
| |
| </apiDesc><example conref="examples\DecodeURIExample.as" class="- topic/example "><codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">package { |
| import flash.display.Sprite; |
| |
| public class DecodeURIExample extends Sprite { |
| public function DecodeURIExample() { |
| var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>"; |
| var encoded:String = encodeURI(uri); |
| var decoded:String = decodeURI(encoded); |
| trace(uri); // http://www.example.com/application.jsp?user=<user name='some user'></user> |
| trace(encoded); // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E |
| trace(decoded); // http://www.example.com/application.jsp?user=<user name='some user'></user> |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/decodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">decodeURIComponent()</linktext></link><link href="#global/encodeURI()" class="- topic/link "><linktext class="- topic/linktext ">encodeURI()</linktext></link><link href="#global/encodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">encodeURIComponent()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:encodeURIComponent" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">encodeURIComponent</apiName><shortdesc class="- topic/shortdesc "> |
| Kodiert einen String in eine gültige URI-Komponente.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uri</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Kodiert einen String in eine gültige URI-Komponente. Konvertiert einen Teilstring eines URI in einen String, in dem alle Zeichen, bis auf eine kleine Gruppe von Standardzeichen, als UTF-8-Escape-Sequenzen kodiert werden. |
| <p class="- topic/p ">Die Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURIComponent()</codeph> unterscheidet sich in so fern von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURI()</codeph>, als sie für die Verwendung mit nur einem Teil eines URI-Strings, einer sogenannten URI-Komponente, konzipiert ist. Eine URI-Komponente ist ein beliebiger Text, der zwischen speziellen Zeichen, den sogenannten <i class="+ topic/ph hi-d/i ">component separators</i>, erscheint <codeph class="+ topic/ph pr-d/codeph ">: ( / ; und ? </codeph>). Gewöhnliche Beispiele für URI-Komponenten sind „http“ oder „www.adobe.com“.</p> |
| <p class="- topic/p ">Ein weiterer wichtiger Unterschied zwischen dieser Funktion und <codeph class="+ topic/ph pr-d/codeph ">encodeURI()</codeph> ist, dass diese Funktion davon ausgeht, dass sie eine URI-Komponente verarbeitet, und somit die speziellen Trennzeichen (<codeph class="+ topic/ph pr-d/codeph ">; / ? : @ & = + $ , #</codeph>) als regulären Text behandelt, der kodiert werden soll. </p> |
| <p class="- topic/p ">Die folgende Tabelle zeigt alle Zeichen, die <i class="+ topic/ph hi-d/i ">nicht</i> von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURIComponent</codeph> in UTF-8-Escape-Sequenzen konvertiert werden.</p> |
| <adobetable class="innertable"><tgroup cols="1" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Nicht kodierte Zeichen</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0 1 2 3 4 5 6 7 8 9</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">a b c d e f g h i j k l m n o p q r s t u v w x y z</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">- _ . ! ~ ~~ ' ( )</codeph></entry></row></tbody></tgroup></adobetable> |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/decodeURI()" class="- topic/link "><linktext class="- topic/linktext ">decodeURI()</linktext></link><link href="#global/decodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">decodeURIComponent()</linktext></link><link href="#global/encodeURI()" class="- topic/link "><linktext class="- topic/linktext ">encodeURI()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:encodeURI" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">encodeURI</apiName><shortdesc class="- topic/shortdesc "> |
| Kodiert einen String in einen gültigen URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, in dem bestimmte Zeichen als UTF-8-Escape-Sequenzen kodiert sind. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">uri</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der einen vollständigen URI repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Kodiert einen String in einen gültigen URI (Uniform Resource Identifier, einheitlicher Ressourcenbezeichner). Konvertiert einen vollständigen URI in einen String, in dem alle Zeichen, bis auf eine kleine Gruppe von Standardzeichen, als UTF-8-Escape-Sequenzen kodiert werden. |
| <p class="- topic/p ">Die folgende Tabelle zeigt den gesamten Satz an Standardzeichen, die <i class="+ topic/ph hi-d/i ">nicht</i> von der Funktion <codeph class="+ topic/ph pr-d/codeph ">encodeURI</codeph> in UTF-8-Escape-Sequenzen konvertiert werden.</p> |
| <adobetable class="innertable"><tgroup cols="1" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Nicht kodierte Zeichen</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0 1 2 3 4 5 6 7 8 9</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">a b c d e f g h i j k l m n o p q r s t u v w x y z</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">; / ? : @ & = + $ , #</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">- _ . ! ~ ~~ ' ( )</codeph></entry></row></tbody></tgroup></adobetable> |
| </apiDesc><example conref="examples\EncodeURIExample.as" class="- topic/example "><codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">package { |
| import flash.display.Sprite; |
| |
| public class EncodeURIExample extends Sprite { |
| public function EncodeURIExample() { |
| var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>"; |
| var encoded:String = encodeURI(uri); |
| var decoded:String = decodeURI(encoded); |
| trace(uri); // http://www.example.com/application.jsp?user=<user name='some user'></user> |
| trace(encoded); // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E |
| trace(decoded); // http://www.example.com/application.jsp?user=<user name='some user'></user> |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/decodeURI()" class="- topic/link "><linktext class="- topic/linktext ">decodeURI()</linktext></link><link href="#global/decodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">decodeURIComponent()</linktext></link><link href="#global/encodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">encodeURIComponent()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:escape" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">escape</apiName><shortdesc class="- topic/shortdesc "> |
| Wandelt den Parameter in einen String um und kodiert ihn in einem URL-Format, bei dem die meisten nicht alphanumerischen Zeichen als %, gefolgt von einer Hexadezimalsequenz, dargestellt werden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein als URL kodierter String |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Ausdruck, der in einen String umgewandelt und in das URL-Format kodiert werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wandelt den Parameter in einen String um und kodiert ihn in ein URL-Format, bei dem die meisten nicht alphanumerischen Zeichen durch ein <codeph class="+ topic/ph pr-d/codeph ">%</codeph>, gefolgt von einer Hexadezimalsequenz, ersetzt werden. Bei URL-kodierten Strings dient das Prozentzeichen (<codeph class="+ topic/ph pr-d/codeph ">%</codeph>) zum Maskieren von Escape-Zeichen und entspricht nicht dem Modulo-Operator (<codeph class="+ topic/ph pr-d/codeph ">%</codeph>). |
| <p class="- topic/p ">Die folgende Tabelle zeigt alle Zeichen, die <i class="+ topic/ph hi-d/i ">nicht</i> von der Funktion <codeph class="+ topic/ph pr-d/codeph ">escape()</codeph> in Escape-Sequenzen konvertiert werden.</p> |
| <adobetable class="innertable"><tgroup cols="1" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Nicht kodierte Zeichen</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0 1 2 3 4 5 6 7 8 9</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">a b c d e f g h i j k l m n o p q r s t u v w x y z</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">@ - _ . ~~ + /</codeph></entry></row></tbody></tgroup></adobetable> |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Verwenden Sie die <codeph class="+ topic/ph pr-d/codeph ">encodeURIComponent()</codeph>-Funktion statt der <codeph class="+ topic/ph pr-d/codeph ">escape()</codeph>-Funktion, damit Sondertrennzeichen (<codeph class="+ topic/ph pr-d/codeph ">@ + /</codeph>) als regulärer, zu kodierender Text behandelt werden.</p> |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/unescape()" class="- topic/link "><linktext class="- topic/linktext ">unescape()</linktext></link><link href="#global/encodeURIComponent()" class="- topic/link "><linktext class="- topic/linktext ">encodeURIComponent()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:int" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">int</apiName><shortdesc class="- topic/shortdesc "> |
| Konvertiert einen bestimmten numerischen Wert in eine Ganzzahl.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die konvertierte Ganzzahl. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Wert, der in eine Ganzzahl umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konvertiert einen bestimmten numerischen Wert in eine Ganzzahl. Dezimalwerte werden an der Dezimalstelle abgeschnitten. |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/uint()" class="- topic/link "><linktext class="- topic/linktext ">uint()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:isFinite" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">isFinite</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt true zurück, wenn der Wert eine endliche Zahl ist und false, wenn der Wert Infinity oder -Infinity ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0." class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn es sich um eine endliche Zahl handelt, bzw. <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, wenn es sich um positive oder negative Unendlichkeit handelt |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">num</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die als endlich oder unendlich ausgewertet wird. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn der Wert eine endliche Zahl ist und <codeph class="+ topic/ph pr-d/codeph ">false</codeph>, wenn der Wert <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph> ist. Das Auftreten von <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph> deutet auf einen mathematischen Fehlerzustand hin, beispielsweise eine Division durch 0. |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:isNaN" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">isNaN</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt „true“ zurück, wenn der Wert „NaN“ (Not a Number – keine Zahl) lautet.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn der Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not a Number – keine Zahl) lautet; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">num</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein zu berechnender numerischer oder mathematischer Ausdruck. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn der Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not a Number – keine Zahl) lautet. Die Funktion <codeph class="+ topic/ph pr-d/codeph ">isNaN()</codeph> dient zur Überprüfung, ob ein mathematischer Ausdruck erfolgreich als Zahl ausgewertet werden kann. Die häufigste Verwendung von <codeph class="+ topic/ph pr-d/codeph ">isNaN()</codeph> ist die Überprüfung des Werts, der von der <codeph class="+ topic/ph pr-d/codeph ">parseInt()</codeph>- und der <codeph class="+ topic/ph pr-d/codeph ">parseFloat()</codeph>-Funktion zurückgegeben wird. Der Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> ist ein spezielles Mitglied des Datentyps Number, das einen Wert repräsentiert der „not a number“, also keine Zahl, ist. |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis</b>: Der Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> ist kein Mitglied der Datentypen „int“ oder „uint“.</p> |
| <p class="- topic/p ">Die folgende Tabelle beschreibt den Rückgabewert von <codeph class="+ topic/ph pr-d/codeph ">isNaN()</codeph> bei verschiedenen Eingabetypen und -werten. (Wenn für Compilerwarnungen der Strict-Modus festgelegt ist, führen einige der folgenden Vorgänge zu Compilerwarnungen.)</p> |
| <adobetable class="innertable"><tgroup cols="3" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Eingabetyp/-wert</entry><entry class="- topic/entry ">Beispiel</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry ">0 durch 0 dividiert</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">isNaN(0/0)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Eine Zahl ungleich Null durch <codeph class="+ topic/ph pr-d/codeph ">0</codeph> dividiert</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">isNaN(5/0)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Quadratwurzel aus einer negativen Zahl</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">isNaN(Math.sqrt(-1))</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Arkussinus einer Zahl, die größer als 1 oder kleiner als 0 ist</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">isNaN(Math.asin(2))</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">String, der in einen Number-Wert konvertiert werden kann</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">isNaN("5")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">String, der nicht in einen Number-Wert konvertiert werden kann</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">isNaN("5a")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry></row></tbody></tgroup></adobetable> |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:isXMLName" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">isXMLName</apiName><shortdesc class="- topic/shortdesc "> |
| Bestimmt, ob der angegebene String ein gültiger Name für ein XML-Element oder -Attribut ist.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurück, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">str</codeph> ein gültiger XML-Name ist; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein auszuwertender String. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Bestimmt, ob der angegebene String ein gültiger Name für ein XML-Element oder -Attribut ist. |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:parseFloat" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">parseFloat</apiName><shortdesc class="- topic/shortdesc "> |
| Wandelt einen String in eine Gleitkommazahl um.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not a Number – keine Zahl). |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der String, der gelesen und in eine Gleitkommazahl umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wandelt einen String in eine Gleitkommazahl um. Die Funktion liest bzw. <i class="+ topic/ph hi-d/i ">analysiert</i> die Zahlen im String und gibt diese zurück, bis der Parser auf ein Zeichen trifft, das nicht zur Ausgangszahl gehört. Wenn der String nicht mit einer Zahl beginnt, die analysiert werden kann, gibt <codeph class="+ topic/ph pr-d/codeph ">parseFloat()</codeph> den Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> zurück. Leerzeichen vor gültigen Ganzzahlen werden ebenso ignoriert wie nachgestellte nicht numerische Zeichen. |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:parseInt" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">parseInt</apiName><shortdesc class="- topic/shortdesc "> |
| Wandelt einen String in eine Ganzzahl um.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl oder <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> (Not a Number – keine Zahl). |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der in eine Ganzzahl umgewandelt werden soll. |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">radix</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Grundzahl (Basis) der zu analysierenden Zahl darstellt. Zulässige Werte liegen zwischen 2 und 36. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wandelt einen String in eine Ganzzahl um. Wenn der in den Parametern angegebene String nicht in eine Zahl umgewandelt werden kann, gibt die Funktion <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> zurück. Strings, die mit 0x beginnen, werden als Hexadezimalzahlen interpretiert. Im Gegensatz zu früheren ActionScript-Versionen werden Ganzzahlen, die mit 0 beginnen, <i class="+ topic/ph hi-d/i ">nicht</i> als Oktalzahlen interpretiert. Für Oktalzahlen müssen Sie die Grundzahl 8 angeben. Leerzeichen und Nullwerte vor gültigen Ganzzahlen werden ebenso ignoriert wie nachgestellte nicht numerische Zeichen. |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="globalOperation:trace" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">trace</apiName><shortdesc class="- topic/shortdesc "> |
| Zeigt während der Fehlersuche Ausdrücke an oder schreibt sie in Protokolldateien.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">arguments</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Einer oder mehrere (durch Kommas getrennte) auszuwertende Ausdrücke. Bei mehreren Ausdrücken wird in der Ausgabe zwischen die einzelnen Ausdrücke ein Leerzeichen gesetzt. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Zeigt während der Fehlersuche Ausdrücke an oder schreibt sie in Protokolldateien. Eine einzelne trace-Anweisung kann mehrere Argumente unterstützen. Enthält ein Argument in einer trace-Anweisung einen Datentyp, der kein String ist, ruft die trace-Funktion die zu diesem Datentyp gehörige <codeph class="+ topic/ph pr-d/codeph ">toString()</codeph>-Methode auf. Ist das Argument beispielsweise ein boolescher Wert, so ruft die trace-Funktion <codeph class="+ topic/ph pr-d/codeph ">Boolean.toString()</codeph> auf und zeigt den Rückgabewert an. |
| </apiDesc><example conref="examples\TraceExample.as" class="- topic/example "> Im folgenden Beispiel wird mithilfe der <codeph class="+ topic/ph pr-d/codeph ">TraceExample</codeph>-Klasse veranschaulicht, wie Sie mit der <codeph class="+ topic/ph pr-d/codeph ">trace()</codeph>-Methode einen einfachen String ausdrucken können. Im Allgemeinen wird die Meldung auf einer „Debug“-Konsole ausgedruckt. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| package { |
| import flash.display.Sprite; |
| |
| public class TraceExample extends Sprite { |
| |
| public function TraceExample() { |
| trace("Hello World"); |
| } |
| } |
| } |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="globalOperation:uint" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">uint</apiName><shortdesc class="- topic/shortdesc "> |
| Konvertiert einen bestimmten numerischen Wert in eine vorzeichenlose Ganzzahl.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die konvertierte Ganzzahl. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">value</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Number</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Wert, der in eine Ganzzahl umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Konvertiert einen bestimmten numerischen Wert in eine vorzeichenlose Ganzzahl. Dezimalwerte werden an der Dezimalstelle abgeschnitten. |
| <p class="- topic/p ">Die folgende Tabelle beschreibt den Rückgabewert von <codeph class="+ topic/ph pr-d/codeph ">uint()</codeph> bei verschiedenen Eingabetypen und -werten.</p> |
| <adobetable class="innertable"><tgroup cols="3" class="- topic/tgroup "><thead class="- topic/thead "><row class="- topic/row "><entry class="- topic/entry ">Eingabetyp/-wert</entry><entry class="- topic/entry ">Beispiel</entry><entry class="- topic/entry ">Rückgabewert</entry></row></thead><tbody class="- topic/tbody "><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">undefined</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(undefined)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">„null“</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(null)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(0)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">NaN</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(NaN)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Positive Gleitkommazahl</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(5.31)</codeph></entry><entry class="- topic/entry ">Abgeschnittene vorzeichenlose Ganzzahl (z. B. <codeph class="+ topic/ph pr-d/codeph ">5</codeph>)</entry></row><row class="- topic/row "><entry class="- topic/entry ">Negative Gleitkommazahl</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(-5.78)</codeph></entry><entry class="- topic/entry ">Schneidet die Ganzzahl ab, und wendet dann die Regel für negative Ganzzahlen an</entry></row><row class="- topic/row "><entry class="- topic/entry ">Negative Ganzzahl</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(-5)</codeph></entry><entry class="- topic/entry ">Die Summe von <codeph class="+ topic/ph pr-d/codeph ">uint.MAX_VALUE</codeph> und der negativen Ganzzahl (z. B. <codeph class="+ topic/ph pr-d/codeph ">uint.MAX_VALUE + (-5)</codeph>)</entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">true</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(true)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">1</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">false</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint(false)</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">Leerer String</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint("")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row><row class="- topic/row "><entry class="- topic/entry ">String, der in einen Number-Wert konvertiert wird</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint("5")</codeph></entry><entry class="- topic/entry ">Der number-Wert</entry></row><row class="- topic/row "><entry class="- topic/entry ">String, der nicht in einen Number-Wert konvertiert wird</entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">uint("5a")</codeph></entry><entry class="- topic/entry "><codeph class="+ topic/ph pr-d/codeph ">0</codeph></entry></row></tbody></tgroup></adobetable> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#global/int()" class="- topic/link "><linktext class="- topic/linktext ">int()</linktext></link></related-links></apiOperation><apiOperation id="globalOperation:unescape" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">unescape</apiName><shortdesc class="- topic/shortdesc "> |
| Wertet den Parameter str als String aus, dekodiert den String aus dem URL-Format (indem er alle Hexadezimalsequenzen in ASCII-Zeichen konvertiert) und gibt den String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der mit einem URL-kodierten Parameter dekodiert wurde. |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">str</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String mit einer Hexadezimalsequenz, die in eine ASCII-Sequenz umgewandelt werden soll. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wertet den Parameter <codeph class="+ topic/ph pr-d/codeph ">str</codeph> als String aus, dekodiert den String aus dem URL-Format (indem er alle Hexadezimalsequenzen in ASCII-Zeichen umwandelt) und gibt den String zurück. |
| </apiDesc></apiOperationDetail></apiOperation><apiValue id="globalValue:-Infinity" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">-Infinity</apiName><shortdesc class="- topic/shortdesc "> |
| Ein spezieller Wert, der eine negative Infinity repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein spezieller Wert, der eine negative <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> repräsentiert. Der Wert dieser Konstante entspricht <codeph class="+ topic/ph pr-d/codeph ">Number.NEGATIVE_INFINITY</codeph>. |
| </apiDesc><example conref="examples\Constants.NegInfinity.1.as" class="- topic/example "> Eine Division durch 0 resultiert nur dann in dem Wert <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph>, wenn der Divisor ein negative Zahl ist. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| trace(0 / 0); // NaN |
| trace(7 / 0); // Infinity |
| trace(-7 / 0); // -Infinity |
| |
| |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="#Number/NEGATIVE_INFINITY" class="- topic/link "><linktext class="- topic/linktext ">Number.NEGATIVE_INFINITY</linktext></link></related-links></apiValue><apiValue id="globalValue:Infinity" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">Infinity</apiName><shortdesc class="- topic/shortdesc "> |
| Ein spezieller Wert, der eine positive Infinity repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein spezieller Wert, der eine positive <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> repräsentiert. Der Wert dieser Konstante entspricht <codeph class="+ topic/ph pr-d/codeph ">Number.POSITIVE_INFINITY</codeph>. |
| </apiDesc><example conref="examples\Constants.Infinity.1.as" class="- topic/example "> Eine Division durch 0 resultiert nur dann in dem Wert <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph>, wenn der Divisor ein positive Zahl ist. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| trace(0 / 0); // NaN |
| trace(7 / 0); // Infinity |
| trace(-7 / 0); // -Infinity |
| |
| |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="#Number/POSITIVE_INFINITY" class="- topic/link "><linktext class="- topic/linktext ">Number.POSITIVE_INFINITY</linktext></link></related-links></apiValue><apiValue id="globalValue:NaN" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">NaN</apiName><shortdesc class="- topic/shortdesc "> |
| Ein spezielles Mitglied des Datentyps Number, das einen Wert repräsentiert der „not a number“, also keine Zahl, ist (NaN).</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Number</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein spezielles Mitglied des Datentyps Number, das einen Wert repräsentiert der „not a number“, also „keine Zahl“, ist (<codeph class="+ topic/ph pr-d/codeph ">NaN</codeph>). Wenn ein mathematischer Ausdruck einen Wert ergibt, der nicht als Zahl ausgedrückt werden kann, ist das Ergebnis <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph>. Die folgende Liste beschreibt häufig vorkommende Ausdrücke, die das Ergebnis <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> liefern. |
| <ul class="- topic/ul "><li class="- topic/li ">Eine Division durch 0 resultiert nur dann in dem Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph>, wenn der Divisor ebenfalls 0 ist. Ist der Divisor größer als 0, resultiert die Division durch 0 in dem Wert <codeph class="+ topic/ph pr-d/codeph "><codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph></codeph>. Ist der Divisor kleiner 0, resultiert die Division durch 0 in dem Wert <codeph class="+ topic/ph pr-d/codeph "><codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph></codeph>.</li><li class="- topic/li ">Die Quadratwurzel aus einer negativen Zahl.</li><li class="- topic/li ">Der Arkussinus einer Zahl, die außerhalb des zulässigen Bereichs von 0 bis 1 liegt.</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> subtrahiert von <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph>;</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph> geteilt durch <codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph>;</li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">Infinity</codeph> oder <codeph class="+ topic/ph pr-d/codeph ">-Infinity</codeph> mit 0 multipliziert;</li></ul> |
| <p class="- topic/p ">Der Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> ist kein Mitglied der Datentypen int oder uint.</p> |
| <p class="- topic/p ">Der Wert <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> wird nicht als identisch mit einem anderen Wert betrachtet, einschließlich <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph>, d. h., es ist unmöglich, den Gleichheitsoperator darauf anzuwenden, um festzustellen, ob ein Ausdruck <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> ist. Um festzustellen, ob eine Zahl die Funktion <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph> ist, verwenden Sie <codeph class="+ topic/ph pr-d/codeph ">isNaN()</codeph>.</p> |
| |
| </apiDesc></apiValueDetail><related-links class="- topic/related-links "><link href="#global/isNaN()" class="- topic/link "><linktext class="- topic/linktext ">isNaN()</linktext></link><link href="#Number/NaN" class="- topic/link "><linktext class="- topic/linktext ">Number.NaN</linktext></link></related-links></apiValue><apiValue id="globalValue:undefined" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">undefined</apiName><shortdesc class="- topic/shortdesc "> |
| Ein spezieller Wert, der auf nicht typisierte Variablen angewendet wird, die nicht initialisiert worden sind, oder auf dynamische Objekteigenschaften, die nicht initialisiert werden.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiType value="" name="type" class="- topic/state reference/state apiRef/apiType "/></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Ein spezieller Wert, der auf nicht typisierte Variablen angewendet wird, die nicht initialisiert worden sind, oder auf dynamische Objekteigenschaften, die nicht initialisiert werden. In ActionScript 3.0 können nur nicht typisierte Variablen den Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> besitzen, was in ActionScript 1.0 und ActionScript 2.0 noch anders war. So sind beispielsweise beide der folgenden Variablen <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>, da sie nicht typisiert und nicht initialisiert sind: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">var foo;</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">var bar:~~;</codeph></li></ul> |
| <p class="- topic/p ">Der Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> trifft auch auf nicht initialisierte und oder nicht definierte Eigenschaften von dynamischen Objekten zu. Ist ein Objekt beispielsweise eine Instanz der Object-Klasse, ist der Wert jeglicher dynamisch hinzugefügter Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>, bis er dieser Eigenschaft zugewiesen wird. |
| </p> |
| <p class="- topic/p ">Bei verschiedenen Funktionen ist das Ergebnis bei der Verwendung von <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> unterschiedlich:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Der von <codeph class="+ topic/ph pr-d/codeph ">String(undefined)</codeph> zurückgegebene Wert ist <codeph class="+ topic/ph pr-d/codeph ">"undefined"</codeph> (<codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> wird in einen String konvertiert).</li><li class="- topic/li ">Der von <codeph class="+ topic/ph pr-d/codeph ">Number(undefined)</codeph> zurückgegebene Wert ist <codeph class="+ topic/ph pr-d/codeph ">NaN</codeph>.</li><li class="- topic/li ">Der von <codeph class="+ topic/ph pr-d/codeph ">int(undefined)</codeph> und <codeph class="+ topic/ph pr-d/codeph ">uint(undefined)</codeph> zurückgegebene Wert ist 0.</li><li class="- topic/li ">Der von <codeph class="+ topic/ph pr-d/codeph ">Object(undefined)</codeph> zurückgegebene Wert ist eine neue Object-Instanz.</li><li class="- topic/li ">Wird der Wert <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> einer typisierten Variable zugewiesen, wird er in den Standardwert des betreffenden Datentyps umgewandelt.</li></ul> |
| <p class="- topic/p ">Verwechseln Sie <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> nicht mit <codeph class="+ topic/ph pr-d/codeph ">null</codeph>. Wenn <codeph class="+ topic/ph pr-d/codeph ">null</codeph> und <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> anhand des Gleichheitsoperators (<codeph class="+ topic/ph pr-d/codeph ">==</codeph>) verglichen werden, gelten sie als identisch. Wenn <codeph class="+ topic/ph pr-d/codeph ">null</codeph> und <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph> dagegen mit dem Operator für strikte Gleichheit (<codeph class="+ topic/ph pr-d/codeph ">===</codeph>) verglichen werden, sind sie nicht identisch.</p> |
| </apiDesc><example conref="examples\Constants.undefined.1.as" class="- topic/example "> Im folgenden Beispiel wurde eine nicht typisiert Variable (<codeph class="+ topic/ph pr-d/codeph ">myVar</codeph>) deklariert aber nicht initialisiert. Der Wert von <codeph class="+ topic/ph pr-d/codeph ">myVar</codeph> ist <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>, da es sich um eine nicht typisiert Variable handelt. Dies trifft immer dann zu, wenn die Variable keine Typanmerkung aufweist oder das Asterisk-Symbol (~~) entspricht keiner Typanmerkung verwendet (<codeph class="+ topic/ph pr-d/codeph ">var myVar:~~;</codeph>). |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| // trace value of untyped and uninitialized variable |
| var myVar; |
| trace(myVar); // undefined |
| </codeblock></example><example conref="examples\Constants.undefined.2.as" class="- topic/example "> Die gleiche Regel trifft auch auf nicht initialisierte Eigenschaften von dynamischen Objekten zu. So lautet beispielsweise bei einer Instanz <codeph class="+ topic/ph pr-d/codeph ">obj</codeph> der dynamischen Klasse <codeph class="+ topic/ph pr-d/codeph ">A</codeph> der Wert von <codeph class="+ topic/ph pr-d/codeph ">obj.propName</codeph>, wobei es sich um eine nicht initialisierte Eigenschaft der <codeph class="+ topic/ph pr-d/codeph ">obj</codeph>-Instanz handelt, <codeph class="+ topic/ph pr-d/codeph ">undefined</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| dynamic class A {} |
| var obj:A = new A() |
| |
| // trace undefined property of obj |
| trace(obj.propName); // undefined |
| |
| </codeblock></example></apiValueDetail><related-links class="- topic/related-links "><link href="statements.html#null" class="- topic/link "><linktext class="- topic/linktext ">null</linktext></link></related-links></apiValue><apiClassifier languages="" id="globalClassifier:uint" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">uint</apiName><shortdesc class="- topic/shortdesc "> |
| Die uint-Klasse stellt Methoden für die Arbeit mit einem Datentyp bereit, der eine vorzeichenlose 32-Bit-Ganzzahl (engl. „unsigned integer“) repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">uint object, uint, built-in class |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiFinal class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiFinal "/><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die uint-Klasse stellt Methoden für die Arbeit mit einem Datentyp bereit, der eine vorzeichenlose 32-Bit-Ganzzahl (engl. „unsigned integer“) repräsentiert. Da eine vorzeichenlose Ganzzahl nur positiv sein kann, entspricht ihr maximaler Wert dem Doppelten des Werts der int-Klasse. |
| <p class="- topic/p ">Der von der uint-Klasse repräsentierte Wertebereich liegt zwischen 0 und 4.294.967.295 (2^32-1).</p> |
| <p class="- topic/p ">Sie können ein uint-Objekt erstellen, indem Sie eine Variable vom Typ uint erstellen und der Variable einen Literalwert zuweisen. Der Standardwert einer Variable vom Typ „uint“ lautet <codeph class="+ topic/ph pr-d/codeph ">0</codeph>.</p> |
| <p class="- topic/p ">Die uint-Klasse ist insbesondere bei der Verwendung von Pixelfarbwerten (ARGB und RGBA) nützlich sowie in anderen Situationen, bei denen der Datentyp „int“ nicht gut funktioniert. Die Zahl 0xFFFFFFFF beispielsweise, die den Farbwert Weiß mit einem Alphawert von 255 repräsentiert, lässt sich mit dem Datentyp „int“ nicht darstellen, da sie sich außerhalb des für „int“-Werte zulässigen Wertebereichs befindet.</p> |
| |
| <p class="- topic/p ">Mit dem folgenden Beispiel wird ein uint-Objekt erstellt und die Methode <codeph class="+ topic/ph pr-d/codeph "> toString()</codeph> aufgerufen:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| var myuint:uint = 1234; |
| trace(myuint.toString()); // 1234 |
| </pre> |
| <p class="- topic/p ">Im folgenden Beispiel wird der Wert der Eigenschaft <codeph class="+ topic/ph pr-d/codeph ">MIN_VALUE</codeph> einer Variablen zugewiesen ohne den Konstruktor zu verwenden:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| var smallest:uint = uint.MIN_VALUE; |
| trace(smallest.toString()); // 0 |
| </pre> |
| |
| </apiDesc><example conref="examples\UintExample.as" class="- topic/example "> Im folgenden Beispiel wird <codeph class="+ topic/ph pr-d/codeph ">i</codeph> als Wert für ein „uint“ in einer <codeph class="+ topic/ph pr-d/codeph ">for</codeph>-Schleife deklariert, wodurch die Zahlen 0 bis geduckt werden (da der Standardwert von „uint“ 0 lautet). |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| package { |
| import flash.display.Sprite; |
| |
| public class UintExample extends Sprite { |
| public function UintExample() { |
| for(var i:uint; i < 10; i++) { |
| trace(i); |
| } |
| } |
| } |
| } |
| </codeblock></example></apiClassifierDetail><related-links class="- topic/related-links "><link href="int.html" class="- topic/link "><linktext class="- topic/linktext ">int</linktext></link><link href="Number.html" class="- topic/link "><linktext class="- topic/linktext ">Number</linktext></link></related-links><apiConstructor id="uint:uint" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">uint</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt ein neues uint-Objekt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">new number, constructor |
| |
| </keyword></asCustoms></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">num</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der numerische Wert des zu erstellenden uint-Objekts oder ein Wert, der in eine Zahl umgewandelt werden soll. Wird <codeph class="+ topic/ph pr-d/codeph ">num</codeph> nicht bereitgestellt, lautet der Standardwert <codeph class="+ topic/ph pr-d/codeph ">0</codeph>. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt ein neues uint-Objekt. Sie können eine Variable vom Typ uint erstellen und ihr einen Literalwert zuweisen. Der Konstruktor <codeph class="+ topic/ph pr-d/codeph ">new uint()</codeph> wird hauptsächlich als Platzhalter verwendet. Ein uint-Objekt entspricht nicht der Funktion <codeph class="+ topic/ph pr-d/codeph "> uint()</codeph>, die einen Parameter in einen Grundwert umwandelt. |
| |
| </apiDesc><example class="- topic/example ">Der folgende Code erstellt zwei neue uint-Objekte; das erste, indem ein Literalwert zugewiesen wird und das zweite, indem die Konstruktorfunktion verwendet wird: |
| <pre xml:space="preserve" class="- topic/pre "> |
| var n1:uint = 3; |
| var n2:uint = new uint(10); |
| </pre> |
| |
| </example></apiConstructorDetail></apiConstructor><apiOperation id="uint:AS3:toExponential" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toExponential</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Exponentialschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> nicht zwischen 0 und 20 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fractionDigits</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Exponentialschreibweise als String zurück. Der String enthält eine Ziffer vor der Dezimalstelle und bis zu 20 Nachkommastellen, gemäß der Angabe im Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph>. |
| </apiDesc><example conref="examples\Number.toExponential.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings in Exponentialschreibweise durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(2)</codeph>. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 315003; |
| trace(num.toExponential(2)); // 3.15e+5 |
| |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="uint:AS3:toFixed" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toFixed</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Festkommaschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> nicht zwischen 0 und 20 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fractionDigits</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Festkommaschreibweise als String zurück. Festkommaschreibweise bedeutet, dass der String eine bestimmte Anzahl an Nachkommastellen enthält, und zwar gemäß der Angabe im Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph>. Die zulässigen Werte für den Parameter <codeph class="+ topic/ph pr-d/codeph ">fractionDigits</codeph> liegen zwischen 0 und 20. Wird ein Wert außerhalb dieses Bereichs angegeben, wird eine Ausnahme ausgelöst. |
| |
| </apiDesc><example conref="examples\Number.toFixed.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>, mit dem auf drei Dezimalstellen aufgerundet wird. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 7.31343; |
| trace(num.toFixed(3)); // 7.313 |
| </codeblock></example><example conref="examples\Number.toFixed.2.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(2)</codeph>, mit dem nachgestellte Nullen hinzugefügt werden. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 4; |
| trace(num.toFixed(2)); // 4.00 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="uint:AS3:toPrecision" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toPrecision</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.0" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Löst eine Ausnahme aus, wenn das Argument <codeph class="+ topic/ph pr-d/codeph ">precision</codeph> nicht zwischen 1 und 21 liegt. |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">precision</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl zwischen 1 und 21 (einschließlich), die die gewünschte Anzahl an Nachkommastellen für die Darstellung des Strings repräsentiert. |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück. Der String enthält die im Parameter <codeph class="+ topic/ph pr-d/codeph ">precision</codeph> angegebene Anzahl an Ziffern. |
| </apiDesc><example conref="examples\Number.toPrecision.1.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>. Der String wird in Festkommaschreibweise zurückgegeben, da Exponentialschreibweise nicht erforderlich ist. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 31.570; |
| trace(num.toPrecision(3)); // 31.6 |
| </codeblock></example><example conref="examples\Number.toPrecision.2.as" class="- topic/example "> Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch <codeph class="+ topic/ph pr-d/codeph ">toFixed(3)</codeph>. Der String wird in Exponentialschreibweise zurückgegeben, da die Anzahl an Stellen der sich ergebenden Zahl nicht ausreichen für die Festkommaschreibweise. |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| |
| var num:Number = 4000; |
| trace(num.toPrecision(3)); // 4.00e+3 |
| </codeblock></example></apiOperationDetail></apiOperation><apiOperation id="uint:AS3:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den Wert des uint-Objekts als String zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">uint, uint.tostring, tostring |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Stringdarstellung des uint-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">radix</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt die numerische Basis (von 2 bis 36) an, die bei der Umwandlung von Zahlen in Strings verwendet werden soll. Wenn Sie den Parameter <codeph class="+ topic/ph pr-d/codeph ">radix</codeph> nicht angeben, wird als Standardwert <codeph class="+ topic/ph pr-d/codeph ">10</codeph> verwendet. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den Wert des uint-Objekts als String zurück. |
| |
| </apiDesc><example class="- topic/example ">Im folgenden Beispiel werden für die <codeph class="+ topic/ph pr-d/codeph ">radix</codeph>-Parameter die Werte 2 und 8 verwendet, und es wird ein String mit der entsprechenden Repräsentation der Zahl 9 ausgegeben. |
| <pre xml:space="preserve" class="- topic/pre "> |
| var myuint:uint = 9; |
| trace(myuint.toString(2)); // 1001 |
| trace(myuint.toString(8)); // 11 |
| </pre> |
| Das folgende Beispiel erstellt Hexadezimalwerte: |
| <pre xml:space="preserve" class="- topic/pre "> |
| var r:uint = 250; |
| var g:uint = 128; |
| var b:uint = 114; |
| var rgb:String = "0x" + r.toString(16) + g.toString(16) + b.toString(16); |
| trace(rgb); // 0xfa8072 |
| </pre> |
| |
| </example></apiOperationDetail></apiOperation><apiOperation id="uint:AS3:valueOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">valueOf</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt den uint-Grundwert des angegebenen uint-Objekts zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">number, number.valueof, valueof, value of |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der uint-Grundwert dieses uint-Objekts. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt den uint-Grundwert des angegebenen uint-Objekts zurück. |
| |
| </apiDesc><example class="- topic/example ">Das folgende Beispiel gibt den Grundwert des Objekts <codeph class="+ topic/ph pr-d/codeph "> numSocks</codeph> aus. |
| <pre xml:space="preserve" class="- topic/pre "> |
| var numSocks:uint = 2; |
| trace(numSocks.valueOf()); // 2 |
| </pre> |
| |
| </example></apiOperationDetail></apiOperation><apiValue id="uint:MAX_VALUE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">MAX_VALUE</apiName><shortdesc class="- topic/shortdesc "> |
| Die größte darstellbare vorzeichenlose 32-Bit-Ganzzahl, nämlich 4.294.967.295.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">uint, uint.max_value, max_value, max value |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">4294967295</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die größte darstellbare vorzeichenlose 32-Bit-Ganzzahl, nämlich 4.294.967.295. |
| |
| </apiDesc><example class="- topic/example ">Der folgende ActionScript-Code zeigt die den größten und kleinsten darstellbaren <codeph class="+ topic/ph pr-d/codeph ">uint</codeph>-Wert an: |
| <pre xml:space="preserve" class="- topic/pre "> |
| trace("uint.MIN_VALUE = " + uint.MIN_VALUE); |
| trace("uint.MAX_VALUE = " + uint.MAX_VALUE); |
| </pre> |
| <p class="- topic/p ">Die Werte sind wie folgt:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| uint.MIN_VALUE = 0 |
| uint.MAX_VALUE = 4294967295 |
| </pre> |
| |
| </example></apiValueDetail></apiValue><apiValue id="uint:MIN_VALUE" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">MIN_VALUE</apiName><shortdesc class="- topic/shortdesc "> |
| Die kleinste darstellbare vorzeichenlose Ganzzahl, nämlich 0.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="9" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">uint, uint.min_value, min_value, min value |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiStatic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiStatic "/><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Die kleinste darstellbare vorzeichenlose Ganzzahl, nämlich <codeph class="+ topic/ph pr-d/codeph ">0</codeph>. |
| |
| </apiDesc><example class="- topic/example ">Der folgende ActionScript-Code zeigt die den größten und kleinsten darstellbaren <codeph class="+ topic/ph pr-d/codeph ">uint</codeph>-Wert an: |
| <pre xml:space="preserve" class="- topic/pre "> |
| trace("uint.MIN_VALUE = " + uint.MIN_VALUE); |
| trace("uint.MAX_VALUE = " + uint.MAX_VALUE); |
| </pre> |
| <p class="- topic/p ">Die Werte sind wie folgt:</p> |
| <pre xml:space="preserve" class="- topic/pre "> |
| uint.MIN_VALUE = 0 |
| uint.MAX_VALUE = 4294967295 |
| </pre> |
| |
| </example></apiValueDetail></apiValue></apiClassifier><apiClassifier languages="" id="globalClassifier:Vector" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiClassifier/apiClassifier "><apiName class="- topic/title reference/title apiRef/apiName ">Vector</apiName><shortdesc class="- topic/shortdesc "> |
| Mithilfe der Vector-Klasse können Sie einen Vector – ein Array, dessen Elemente alle den gleichen Datentyp aufweisen – bearbeiten und darauf zugreifen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector, Vector object, built-in class |
| |
| </keyword></asCustoms></prolog><apiClassifierDetail class="- topic/body reference/refbody apiRef/apiDetail apiClassifier/apiClassifierDetail "><apiClassifierDef class="- topic/section reference/section apiRef/apiDef apiClassifier/apiClassifierDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Sie können Vectors definieren (Typ-Arrays). |
| </apiTipText></apiTipTexts><apiBaseClassifier class="- topic/xref reference/xref apiRef/apiRelation apiClassifier/apiBaseClassifier ">Object</apiBaseClassifier></apiClassifierDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Mithilfe der Vector-Klasse können Sie einen Vektor – ein Array, dessen Elemente alle den gleichen Datentyp aufweisen – bearbeiten und darauf zugreifen. Der Datentyp der Elemente eines Vektors wird als der <i class="+ topic/ph hi-d/i ">Basistyp</i> des Vectors bezeichnet. Der Basistyp kann jede Klasse sein, einschließlich integrierter und benutzerdefinierter Klassen. Der Basistyp wird bei der Deklaration einer Vector-Variablen und auch bei der Erstellung einer Instanz durch Aufrufen des Klassenkonstruktors festgelegt. |
| |
| <p class="- topic/p ">Wie bei einem Array können Sie den Array-Zugriffsoperator (<codeph class="+ topic/ph pr-d/codeph ">[]</codeph>) verwenden, um den Wert eines Vector-Elements festzulegen oder abzurufen. Außerdem stellen mehrere Vector-Methoden Mechanismen zum Festlegen und Abrufen von Elementwerten bereit. Dazu gehören <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">pop()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">shift()</codeph>, <codeph class="+ topic/ph pr-d/codeph ">unshift()</codeph> und andere. Die Eigenschaften und Methoden eines Vector-Objekts ähneln den Eigenschaften und Methoden eines Arrays, in den meisten Fällen sind sie sogar identisch. In den meisten Fällen, in denen Sie ein Array verwenden würden, dessen Elemente alle denselben Datentyp aufweisen, ist es empfehlenswert, stattdessen eine Vector-Instanz zu verwenden. Vector-Instanzen sind jedoch dichte Arrays, was bedeutet, dass an jeder Indexposition ein Wert (oder <codeph class="+ topic/ph pr-d/codeph ">null</codeph>) vorhanden sein muss. Bei Array-Instanzen gilt diese Einschränkung nicht.</p> |
| |
| <p class="- topic/p ">Der Basistyp des Vektors wird mithilfe der Suffix-Syntax des type-Parameters festgelegt. Die Syntax des type-Parameters ist eine Sequenz, die einen Punkt (<codeph class="+ topic/ph pr-d/codeph ">.</codeph>), eine linke spitze Klammer (<codeph class="+ topic/ph pr-d/codeph "><</codeph>), einen Klassennamen, dann eine rechte spitze Klammer (<codeph class="+ topic/ph pr-d/codeph ">></codeph>) enthält, wie in diesem Beispiel angezeigt:</p> |
| |
| <p class="- topic/p ">In der ersten Zeile des Beispiels wird die Variable <codeph class="+ topic/ph pr-d/codeph ">v</codeph> als Vector.<String>-Instanz deklariert. Dies bedeutet, dass sie einen Vektor (ein Array) darstellt, der nur String-Instanzen enthält und von dem nur String-Instanzen abgerufen werden können. Die zweite Zeile erstellt eine Instanz des gleichen Vektor-Typs (ein Vektor, dessen Elemente alle String-Objekte sind) und weist ihn <codeph class="+ topic/ph pr-d/codeph ">v</codeph> zu.</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var v:Vector.<String>; |
| v = new Vector.<String>(); |
| </codeblock> |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| <p class="- topic/p ">Eine Variable, die mit dem Vector.<T>-Datentyp deklariert wurde, kann nur eine Vector-Instanz speichern, die mit dem gleichen Basistyp <codeph class="+ topic/ph pr-d/codeph ">T</codeph> erstellt wurde. Beispiel: Ein durch den Aufruf von <codeph class="+ topic/ph pr-d/codeph ">new Vector.<String>()</codeph> erstellter Vector kann keiner Variablen zugewiesen werden, die mit dem Vector.<int>-Datentyp deklariert wurde. Die Basistypen müssen genau übereinstimmen. Beispiel: Der folgende Code kann nicht kompiliert werden, da der Basistyp des Objekts nicht identisch mit dem deklarierten Basistyp der Variablen ist (obwohl Sprite eine Unterklasse von DisplayObject ist):</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| // This code doesn't compile even though Sprite is a DisplayObject subclass |
| var v:Vector.<DisplayObject> = new Vector.<Sprite>(); |
| </codeblock> |
| |
| <p class="- topic/p ">Um einen Vektor mit dem Basistyp <codeph class="+ topic/ph pr-d/codeph ">T</codeph> in einen Vektor mit einer Superklasse von <codeph class="+ topic/ph pr-d/codeph ">T</codeph> zu konvertieren, verwenden Sie die globale <codeph class="+ topic/ph pr-d/codeph ">Vector()</codeph>-Funktion.</p> |
| |
| <p class="- topic/p ">Neben der Datentypbeschränkung unterscheidet sich die Vector-Klasse von der Array-Klasse noch durch weitere Beschränkungen:</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Ein Vector ist ein dichtes Array. Im Gegensatz zu einem Array, das Werte in den Indexpositionen 0 und 7 aufweisen kann, auch wenn keine Werte in den Indexpositionen 1 bis 7 vorhanden sind, muss ein Vektor einen Wert (oder <codeph class="+ topic/ph pr-d/codeph ">null</codeph>) in jeder Indexposition aufweisen.</li><li class="- topic/li ">Für einen Vektor kann wahlweise eine feste Länge angegeben werden, wobei dies bedeutet, dass die Anzahl der enthaltenen Elemente nicht geändert werden kann.</li><li class="- topic/li ">Der Zugriff auf die Vector-Elemente ist begrenzt. Es kann kein Wert von einer Indexposition größer als das letzte Element (<codeph class="+ topic/ph pr-d/codeph ">length - 1</codeph>) gelesen werden. Es kann kein Wert festgelegt werden, der eine Indexposition von mehr als eins hinter der aktuellen letzten Indexposition aufweist (anders ausgedrückt, ein Wert kann nur an einer vorhandenen Indexposition oder an der Indexposition <codeph class="+ topic/ph pr-d/codeph ">[length]</codeph> festgelegt werden).</li></ul> |
| |
| <p class="- topic/p ">Aufgrund seiner Beschränkungen bietet ein Vektor drei wichtige Vorteile gegenüber einer Array-Instanz, bei deren Elementen es sich ausschließlich um Instanzen einer Klasse handelt:</p> |
| <ul class="- topic/ul "><li class="- topic/li ">Leistung: Bei einer Vector-Instanz erfolgen der Zugriff auf die Array-Elemente und die Iteration viel schneller als bei einem Array.</li><li class="- topic/li ">Typsicherheit: Im strikten Modus kann der Compiler Datentypfehler erkennen. Datentypfehler treten beispielsweise auf, wenn einem Vektor ein Wert mit einem falschen Datentyp zugewiesen wird oder wenn beim Lesen eines Werts von einem Vektor der falsche Datentyp erwartet wird. Beachten Sie jedoch Folgendes: Wenn Sie einem Vektor mithilfe der <codeph class="+ topic/ph pr-d/codeph ">push()</codeph>- oder <codeph class="+ topic/ph pr-d/codeph ">unshift()</codeph>-Methode Werte hinzufügen, werden die Datentypen der Argumente bei der Kompilierung nicht überprüft. Sie werden stattdessen zur Laufzeit überprüft.</li><li class="- topic/li ">Zuverlässigkeit: Die Laufzeit-Bereichsüberprüfung (oder Festlängenüberprüfung) erhöht die Zuverlässigkeit im Vergleich mit Arrays erheblich.</li></ul> |
| |
| </apiDesc></apiClassifierDetail><related-links class="- topic/related-links "><link href="operators.html#array_access" class="- topic/link "><linktext class="- topic/linktext ">[] Array-Zugriff</linktext></link><link href="package.html#Vector()" class="- topic/link "><linktext class="- topic/linktext ">Vector(), globale Funktion</linktext></link><link href="#Array" class="- topic/link "><linktext class="- topic/linktext ">Array-Klasse</linktext></link></related-links><apiConstructor id="Vector:Vector" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation apiOperation/apiConstructor"><apiName class="- topic/title reference/title apiRef/apiName ">Vector</apiName><shortdesc class="- topic/shortdesc "> |
| Erstellt einen Vector mit dem festgelegten Basistyp.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiConstructorDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail apiOperation/apiConstructorDetail"><apiConstructorDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiConstructorDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">length</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die ursprüngliche Länge (Anzahl der Elemente) des Vectors. Wenn dieser Parameter größer als null ist, wird die festgestellte Anzahl der Vector-Elemente erstellt und mit dem Standardwert gefüllt, der dem Basistyp (<codeph class="+ topic/ph pr-d/codeph ">null</codeph> für Verweistypen) entspricht. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fixed</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">false</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Gibt an, ob die Länge des Vectors fixiert ist (<codeph class="+ topic/ph pr-d/codeph ">true</codeph>) oder verändert werden kann (<codeph class="+ topic/ph pr-d/codeph ">false</codeph>). Dieser Wert kann auch mithilfe der <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph>-Eigenschaft festgelegt werden. |
| |
| </apiDesc></apiParam></apiConstructorDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Erstellt einen Vector mit dem festgelegten Basistyp. |
| |
| <p class="- topic/p ">Beim Aufrufen des <codeph class="+ topic/ph pr-d/codeph ">Vector.<T>()</codeph>-Konstruktors legen Sie den Basistyp mithilfe der Syntax des type-Parameters fest. Die Syntax des type-Parameters ist eine Sequenz, die einen Punkt (<codeph class="+ topic/ph pr-d/codeph ">.</codeph>), eine linke spitze Klammer (<codeph class="+ topic/ph pr-d/codeph "><</codeph>), einen Klassennamen, dann eine rechte spitze Klammer (<codeph class="+ topic/ph pr-d/codeph ">></codeph>) enthält, wie in diesem Beispiel angezeigt:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var v:Vector.<String> = new Vector.<String>(); |
| </codeblock> |
| |
| |
| |
| |
| |
| <p class="- topic/p ">Um eine Vector-Instanz aus einem Array oder einem anderen Vector (z. B. einem Vector mit einem unterschiedlichen Basistypen) zu erstellen, verwenden Sie die globale <codeph class="+ topic/ph pr-d/codeph ">Vector()</codeph>-Funktion.</p> |
| |
| <p class="- topic/p ">Um eine bereits mit Werten versehene Vector-Instanz zu erstellen, verwenden Sie die folgende Syntax anstatt der unten angegebenen Parameter:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| // var v:Vector.<T> = new <T>[E0, ..., En-1 ,]; |
| // For example: |
| var v:Vector.<int> = new <int>[0,1,2,]; |
| </codeblock> |
| |
| <p class="- topic/p ">Für diese Syntax gelten die folgenden Informationen: |
| <ul class="- topic/ul "><li class="- topic/li ">Sie wird in Flash Professional CS5 und höher, Flash Builder 4 und höher sowie Flex 4 und höher unterstützt. </li><li class="- topic/li "> Das nachgestellte Komma ist optional. </li><li class="- topic/li "> Leere Elemente im Array werden nicht unterstützt; eine Anweisung wie <codeph class="+ topic/ph pr-d/codeph ">var v:Vector.<int> = new <int>[0,,2,]</codeph> führt zu einem Compilerfehler.</li><li class="- topic/li ">Sie können keine Standardlänge für die Vektorinstanz festlegen. Stattdessen ist die Länge mit der Anzahl der Elemente in der Initialisierungsliste identisch. </li><li class="- topic/li ">Sie können nicht angeben, ob die Vector-Instanz eine feste Länge hat. Verwenden Sie stattdessen die <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph>-Eigenschaft. </li><li class="- topic/li "> Datenverluste oder -fehler können auftreten, wenn Elemente, die als Werte übergeben wurden, nicht dem angegebenen Typ entsprechen. Beispiel:</li><codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock "> |
| var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode |
| trace(v[0]); //returns 4 when not running in strict mode |
| </codeblock></ul> </p> |
| |
| </apiDesc></apiConstructorDetail><related-links class="- topic/related-links "><link href="#Vector/fixed" class="- topic/link "><linktext class="- topic/linktext ">fixed</linktext></link><link href="package.html#Vector()" class="- topic/link "><linktext class="- topic/linktext ">Vector(), globale Funktion</linktext></link></related-links></apiConstructor><apiOperation id="Vector:AS3:concat" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">concat</apiName><shortdesc class="- topic/shortdesc "> |
| Verkettet die in den Parametern angegebenen Elemente mit den Elementen im Vector und erstellt einen neuen Vector.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.concat, concat, concatenate |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn ein beliebiges Argument keine Instanz des Basistyps ist und nicht in den Basistyp konvertiert werden kann. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Vector mit dem gleichen Basistyp wie dieser Vector, der die Elemente von diesem Element enthält, gefolgt von Elementen der Parameter. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein oder mehrere Werte des Basistyps dieses in einem neuen Vector zu verkettenden Vectors. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Verkettet die in den Parametern angegebenen Elemente. |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Verkettet die in den Parametern angegebenen Elemente mit den Elementen im Vector und erstellt einen neuen Vector. Wenn die Parameter einen Vector festlegen, werden die Elemente dieses Vectors verkettet. Wenn Sie keine Parameter übergeben, wird der neue Vektor als Duplikat („Shallow Clone“) des ursprünglichen Vektors erstellt. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Vector:AS3:every" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">every</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Vector eine Testfunktion aus, bis ein Element erreicht wird, das für die festgelegte Funktion „false“ zurückgibt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein boolescher Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, falls die festgelegte Funktion beim Aufruf in allen Elementen <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgibt und andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element des Vectors ausgeführt werden soll. Diese Funktion wird mit drei Argumenten aufgerufen: Das aktuelle Element des Vectors, die Indexposition des Elements und das Vector-Objekt: |
| <pre xml:space="preserve" class="- topic/pre ">function callback(item:T, index:int, vector:Vector.<T>):Boolean { |
| // your code here |
| } |
| </pre> |
| |
| <p class="- topic/p ">Die Rückruffunktion sollte einen booleschen Wert zurückgeben.</p> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt, auf das der Bezeichner <codeph class="+ topic/ph pr-d/codeph ">this</codeph> in der Rückruffunktion verweist, wenn die Funktion aufgerufen wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Vector eine Testfunktion aus, bis ein Element erreicht wird, das für die festgelegte Funktion <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurückgibt. Sie verwenden diese Methode, um zu ermitteln, ob alle Elemente in einem Vector ein Kriterium erfüllen, z. B. dass die Werte unter einer bestimmten Zahl liegen. |
| |
| <p class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.</p> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext aufrufen möchten:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(item:T, index:int, vector:Vector.<T>):Boolean { |
| // your code here |
| } |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, dass Sie dann die <codeph class="+ topic/ph pr-d/codeph ">every()</codeph>-Methode bei einem Vector mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myVector</codeph> verwenden:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myVector.every(myFunction, someObject); |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean { |
| //your code here |
| }; |
| myVector.every(myFunction, someObject); |
| </pre> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/some()" class="- topic/link "><linktext class="- topic/linktext ">Vector.some()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:filter" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">filter</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Vector eine Testfunktion aus und erstellt einen neuen Vector für alle Elemente, die für die angegebene Funktion „true“ zurückgeben.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein neuer Vector, der alle Elemente des ursprünglichen Vectors enthält, für den die <codeph class="+ topic/ph pr-d/codeph ">callback</codeph>-Funktion <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgibt. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element des Vectors ausgeführt werden soll. Diese Funktion wird mit drei Argumenten aufgerufen: Das aktuelle Element des Vectors, die Indexposition des Elements und das Vector-Objekt: |
| <pre xml:space="preserve" class="- topic/pre ">function callback(item:T, index:int, vector:Vector.<T>):Boolean;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt, auf das der Bezeichner <codeph class="+ topic/ph pr-d/codeph ">this</codeph> in der Rückruffunktion verweist, wenn die Funktion aufgerufen wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Vector eine Testfunktion aus und erstellt einen neuen Vector für alle Elemente, die für die festgelegte Funktion <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgeben. Wenn ein Element <codeph class="+ topic/ph pr-d/codeph ">false</codeph> zurückgibt, ist es nicht im Ergebnisvektor enthalten. Der Basistyp des Rückgabevektors stimmt mit dem Basistyp des Vectors überein, bei dem die Methode aufgerufen wurde. |
| |
| <p class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.</p> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext aufrufen möchten:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(item:T, index:int, vector:Vector.<T>):Boolean { |
| // your code here |
| } |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, dass Sie dann die <codeph class="+ topic/ph pr-d/codeph ">filter()</codeph>-Methode bei einem Vector mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myVector</codeph> verwenden:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var result:Vector.<T> = myVector.filter(myFunction, someObject); |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean { |
| //your code here |
| }; |
| myVector.filter(myFunction, someObject); |
| </pre> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/map()" class="- topic/link "><linktext class="- topic/linktext ">Vector.map()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:forEach" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">forEach</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Vector eine Funktion aus.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiType value="void" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element des Vectors ausgeführt werden soll. Diese Funktion wird mit drei Argumenten aufgerufen: Das aktuelle Element des Vectors, die Indexposition des Elements und das Vector-Objekt: |
| <pre xml:space="preserve" class="- topic/pre ">function callback(item:T, index:int, vector:Vector.<T>):void;</pre> |
| <p class="- topic/p ">Jeder Rückgabewert von diesem Funktionsaufruf wird verworfen.</p> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt, auf das der Bezeichner <codeph class="+ topic/ph pr-d/codeph ">this</codeph> in der Rückruffunktion verweist, wenn die Funktion aufgerufen wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Vector eine Funktion aus. |
| |
| <p class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.</p> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext aufrufen möchten:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(item:T, index:int, vector:Vector.<T>):void { |
| // your code here |
| } |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, dass Sie dann die <codeph class="+ topic/ph pr-d/codeph ">forEach()</codeph>-Methode bei einem Vector mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myVector</codeph> verwenden:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myVector.forEach(myFunction, someObject); |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void { |
| //your code here |
| }; |
| myVector.forEach(myFunction, someObject); |
| </pre> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Vector:AS3:indexOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">indexOf</apiName><shortdesc class="- topic/shortdesc "> |
| Sucht nach einem Element im Vector und gibt die Indexposition des Elements zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine auf Null basierende Indexposition des Elements im Vector. Wird das <codeph class="+ topic/ph pr-d/codeph ">searchElement</codeph>-Argument nicht gefunden, lautet der Rückgabewert -1. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">searchElement</apiItemName><apiType value="T" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Element, das im Vector gesucht werden soll. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fromIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position im Vector, ab der die Suche nach dem Element gestartet werden soll. Wenn dieser Parameter negativ ist, wird er als <codeph class="+ topic/ph pr-d/codeph ">length + fromIndex</codeph> behandelt. Dies bedeutet, dass der Suchvorgang am Ende der <codeph class="+ topic/ph pr-d/codeph ">-fromIndex</codeph>-Elemente beginnt und von dieser Position vorwärts bis zum Ende des Vectors sucht. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sucht nach einem Element im Vector und gibt die Indexposition des Elements zurück. Das Element wird mit dem Operator für strikte Gleichheit (<codeph class="+ topic/ph pr-d/codeph ">===</codeph>) verglichen. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/lastIndexOf()" class="- topic/link "><linktext class="- topic/linktext ">Vector.lastIndexOf()</linktext></link><link href="operators.html#strict_equality" class="- topic/link "><linktext class="- topic/linktext ">=== (strikte Gleichheit)</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:join" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">join</apiName><shortdesc class="- topic/shortdesc "> |
| Wandelt die Elemente in einem Vector in Strings um, fügt zwischen ihnen das festgelegte Trennzeichen ein, verkettet die Elemente und gibt den Ergebnisstring zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.join, join |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String, der aus den Elementen eines Vectors besteht, die in Strings umgewandelt und durch den angegebenen Parameter getrennt werden sollen. |
| |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">sep</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">,</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Zeichen oder String, mit dem die Vector-Elemente im zurückgegebenen String voneinander getrennt werden. Wenn Sie diesen Parameter weglassen, wird als Standardtrennzeichen das Komma verwendet. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Konvertiert die Elemente in einem Vector in Strings. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Wandelt die Elemente in einem Vector in Strings um, fügt zwischen ihnen das festgelegte Trennzeichen ein, verkettet die Elemente und gibt den Ergebnisstring zurück. Ein verschachtelter Vector wird immer durch ein Komma (,) getrennt und nicht durch das Trennzeichen, das an die <codeph class="+ topic/ph pr-d/codeph ">join()</codeph>-Methode übergeben wurde. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/split()" class="- topic/link "><linktext class="- topic/linktext ">String.split()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:lastIndexOf" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">lastIndexOf</apiName><shortdesc class="- topic/shortdesc "> |
| Sucht nach einem Element im Vector, wobei von der festgelegten Indexposition nach hinten gesucht wird und gibt dann die Indexposition des übereinstimmenden Elements zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine auf Null basierende Indexposition des Elements im Vector. Wird das <codeph class="+ topic/ph pr-d/codeph ">searchElement</codeph>-Argument nicht gefunden, lautet der Rückgabewert -1. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">searchElement</apiItemName><apiType value="T" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Element, das im Vector gesucht werden soll. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">fromIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0x7fffffff</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Position im Vector, ab der die Suche nach dem Element gestartet werden soll. Der Standardwert ist der maximal zulässige Indexpositionswert. Dies bedeutet, dass der Suchvorgang beim letzten Element im Vector beginnt. |
| <p class="- topic/p ">Wenn dieser Parameter negativ ist, wird er als <codeph class="+ topic/ph pr-d/codeph ">length + fromIndex</codeph> behandelt. Dies bedeutet, dass der Suchvorgang am Ende der <codeph class="+ topic/ph pr-d/codeph ">-fromIndex</codeph>-Elemente beginnt und von dieser Position zurück bis zur Indexposition 0 sucht.</p> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sucht nach einem Element im Vector, wobei von der festgelegten Indexposition nach hinten gesucht wird und gibt dann die Indexposition des übereinstimmenden Elements zurück. Das Element wird mit dem Operator für strikte Gleichheit (<codeph class="+ topic/ph pr-d/codeph ">===</codeph>) verglichen. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/indexOf()" class="- topic/link "><linktext class="- topic/linktext ">Vector.indexOf()</linktext></link><link href="operators.html#strict_equality" class="- topic/link "><linktext class="- topic/linktext ">=== (strikte Gleichheit)</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:map" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">map</apiName><shortdesc class="- topic/shortdesc "> |
| Führt eine Funktion in jedem Element des Vectors aus und gibt einen neuen Vector mit Elementen zurück, die den Ergebnissen des Funktionsaufrufs in jedem Element dieses Vectors entsprechen.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein neuer Vector, der die Ergebnisse des Funktionsaufrufs in jedem Element dieses Vectors enthält. Der Ergebnisvektor hat den gleichen Basistyp und <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert wie das Original. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element des Vectors ausgeführt werden soll. Diese Funktion wird mit drei Argumenten aufgerufen: Das aktuelle Element des Vectors, die Indexposition des Elements und das Vector-Objekt: |
| <pre xml:space="preserve" class="- topic/pre ">function callback(item:T, index:int, vector:Vector.<T>):T;</pre> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt, auf das der Bezeichner <codeph class="+ topic/ph pr-d/codeph ">this</codeph> in der Rückruffunktion verweist, wenn die Funktion aufgerufen wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt eine Funktion in jedem Element des Vectors aus und gibt einen neuen Vector mit Elementen zurück, die den Ergebnissen des Funktionsaufrufs in jedem Element dieses Vectors entsprechen. Der Ergebnisvektor hat den gleichen Basistyp und <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert wie der ursprüngliche Vector. Das Element an der Indexposition <codeph class="+ topic/ph pr-d/codeph ">i</codeph> im Ergebnisvektor ist das Ergebnis des Elementaufrufs an der Indexposition <codeph class="+ topic/ph pr-d/codeph ">i</codeph> im ursprünglichen Vector. |
| |
| <p class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.</p> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext aufrufen möchten:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(item:Object, index:int, vector:Vector.<T>):T { |
| // your code here |
| } |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, dass Sie dann die <codeph class="+ topic/ph pr-d/codeph ">map()</codeph>-Methode bei einem Vector mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myVector</codeph> verwenden:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myVector.map(myFunction, someObject); |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void { |
| //your code here |
| }; |
| myVector.map(myFunction, someObject); |
| </pre> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/filter()" class="- topic/link "><linktext class="- topic/linktext ">Vector.filter()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:pop" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">pop</apiName><shortdesc class="- topic/shortdesc "> |
| Entfernt das letzte Element aus einem Vector und gibt dieses Element zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.pop, pop |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn diese Methode aufgerufen wird, während <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> entspricht. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Wert des letzten Elements im festgelegten Vector. |
| |
| </apiDesc><apiType value="T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Entfernt das letzte Element aus einem Vector und gibt dieses Element zurück. Die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft des Vectors verringert sich um eins, wenn diese Funktion aufgerufen wird. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/push()" class="- topic/link "><linktext class="- topic/linktext ">Vector.push()</linktext></link><link href="#Vector/shift()" class="- topic/link "><linktext class="- topic/linktext ">Vector.shift()</linktext></link><link href="#Vector/unshift()" class="- topic/link "><linktext class="- topic/linktext ">Vector.unshift()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:push" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">push</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt am Ende eines Vectors ein oder mehrere Elemente hinzu und gibt die neue Länge des Vectors zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.push, push |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn ein beliebiges Argument keine Instanz des Basistyps <codeph class="+ topic/ph pr-d/codeph ">T</codeph> des Vectors ist. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn diese Methode aufgerufen wird, während <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> entspricht. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Länge des Vectors, nachdem die neuen Elemente hinzugefügt wurden. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein oder mehrere Werte, die an den Vector angehängt werden. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt am Ende eines Vectors ein oder mehrere Elemente hinzu und gibt die neue Länge des Vectors zurück. |
| |
| <p class="- topic/p ">Da diese Funktion mehrere Argumente akzeptieren kann, wird der Datentyp der Argumente während des Kompilierens auch im Strict-Modus nicht überprüft. Wird jedoch ein Argument übergeben, das keine Instanz des Basistyps ist, tritt zur Laufzeit eine Ausnahme auf.</p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/pop()" class="- topic/link "><linktext class="- topic/linktext ">Vector.pop()</linktext></link><link href="#Vector/shift()" class="- topic/link "><linktext class="- topic/linktext ">Vector.shift()</linktext></link><link href="#Vector/unshift()" class="- topic/link "><linktext class="- topic/linktext ">Vector.unshift()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:reverse" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">reverse</apiName><shortdesc class="- topic/shortdesc "> |
| Kehrt die Reihenfolge der Elemente im Vector um.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.reverse, reverse |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der Vector mit den Elementen in umgekehrter Reihenfolge. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Kehrt die Reihenfolge der Elemente im Vector um. Diese Methode ändert den Vector, über den sie aufgerufen wurde. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Vector:AS3:shift" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">shift</apiName><shortdesc class="- topic/shortdesc "> |
| Entfernt das erste Element aus einem Vector und gibt dieses Element zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.shift, shift |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert<codeph class="+ topic/ph pr-d/codeph ">true</codeph> entspricht. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das erste Element im Vector. |
| |
| </apiDesc><apiType value="T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Entfernt das erste Element aus einem Vector und gibt dieses Element zurück. Die verbleibenden Vector-Elemente werden von ihrer ursprünglichen Position i nach i-1 verschoben. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/pop()" class="- topic/link "><linktext class="- topic/linktext ">Vector.pop()</linktext></link><link href="#Vector/push()" class="- topic/link "><linktext class="- topic/linktext ">Vector.push()</linktext></link><link href="#Vector/unshift()" class="- topic/link "><linktext class="- topic/linktext ">Vector.unshift()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:slice" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">slice</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen neuen Vector zurück, der aus mehreren Elementen des ursprünglichen Vectors besteht, ohne dabei den ursprünglichen Vector zu ändern.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.slice, slice |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Vector, der aus mehreren Elementen des ursprünglichen Vectors besteht. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">0</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die die Indexposition des Segmentanfangs angibt. Wenn <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> eine negative Zahl ist, beginnt der Startpunkt am Ende des Vectors, wobei -1 das letzte Element ist. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">endIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">16777215</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Zahl, die die Indexposition des Segmentendes angibt. Wenn Sie diesen Parameter weglassen, umfasst das Segment alle Elemente vom Anfang bis zum Ende des Vectors. Wenn <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph> eine negative Zahl ist, wird der Endpunkt vom Ende des Vectors aus festgelegt, wobei -1 das letzte Element ist. |
| |
| </apiDesc></apiParam><apiTipTexts><apiTipText class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiTipText ">Gibt einen neuen Vector zurück, der aus mehreren Elementen des ursprünglichen Vectors besteht. |
| |
| </apiTipText></apiTipTexts></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen neuen Vector zurück, der aus mehreren Elementen des ursprünglichen Vectors besteht, ohne dabei den ursprünglichen Vector zu ändern. Der zurückgegebene Vector beinhaltet das <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph>-Element und alle Elemente bis zum <codeph class="+ topic/ph pr-d/codeph ">endIndex</codeph>-Element, schließt dieses jedoch nicht ein. |
| |
| <p class="- topic/p "> Wenn Sie keine Parameter übergeben, wird der neue Vektor als Duplikat („Shallow Clone“) des ursprünglichen Vektors erstellt. Wenn Sie den Wert 0 für beide Parameter übergeben, wird ein neuer, leerer Vektor desselben Typs wie der ursprüngliche Vektor erstellt.</p> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Vector:AS3:some" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">some</apiName><shortdesc class="- topic/shortdesc "> |
| Führt für jedes Element im Vector eine Testfunktion aus, bis ein Element erreicht wird, das „true“ zurückgibt.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Der boolesche Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph>, wenn ein Element im Vector für die festgelegte Funktion <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgibt; andernfalls <codeph class="+ topic/ph pr-d/codeph ">false</codeph>. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Boolean</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">callback</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Die Funktion, die für jedes Element des Vectors ausgeführt werden soll. Diese Funktion wird mit drei Argumenten aufgerufen: Das aktuelle Element des Vectors, die Indexposition des Elements und das Vector-Objekt: |
| <pre xml:space="preserve" class="- topic/pre ">function callback(item:T, index:int, vector:Vector.<T>):Boolean</pre> |
| |
| <p class="- topic/p ">Die Rückruffunktion sollte einen booleschen Wert zurückgeben.</p> |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">thisObject</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Object</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">null</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Das Objekt, auf das der Bezeichner <codeph class="+ topic/ph pr-d/codeph ">this</codeph> in der Rückruffunktion verweist, wenn die Funktion aufgerufen wird. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Führt für jedes Element im Vector eine Testfunktion aus, bis ein Element erreicht wird, das <codeph class="+ topic/ph pr-d/codeph ">true</codeph> zurückgibt. Verwenden Sie diese Methode, um festzustellen, ob alle Elemente in einem Vector ein Kriterium erfüllen, z. B. dass die Werte unter einer bestimmten Zahl liegen. |
| |
| <p class="- topic/p ">Für diese Methode muss der zweite Parameter (<codeph class="+ topic/ph pr-d/codeph ">thisObject</codeph>) den Wert <codeph class="+ topic/ph pr-d/codeph ">null</codeph> haben, wenn der erste Parameter (<codeph class="+ topic/ph pr-d/codeph ">callback</codeph>) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.</p> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie an, dass Sie eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext aufrufen möchten:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean { |
| // your code here |
| } |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Nehmen Sie weiter an, dass Sie dann die <codeph class="+ topic/ph pr-d/codeph ">some()</codeph>-Methode bei einem Vector mit dem Namen <codeph class="+ topic/ph pr-d/codeph ">myVector</codeph> verwenden:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| myVector.some(myFunction, someObject); |
| </pre> |
| |
| <p product="flash" class="- topic/p ">Da <codeph class="+ topic/ph pr-d/codeph ">myFunction</codeph> ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen <codeph class="+ topic/ph pr-d/codeph ">this</codeph>-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:</p> |
| |
| <pre product="flash" xml:space="preserve" class="- topic/pre "> |
| var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean { |
| //your code here |
| }; |
| myVector.some(myFunction, someObject); |
| </pre> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/every()" class="- topic/link "><linktext class="- topic/linktext ">every()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:sort" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">sort</apiName><shortdesc class="- topic/shortdesc "> |
| Sortiert die Elemente im Vector.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.sort, sort |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Dieser Vector mit Elementen in der neuen Reihenfolge. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">compareFunction</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">Function</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Vergleichsmethode, die das Verhalten der Sortierung ermittelt. |
| |
| <p class="- topic/p ">Die festgelegte Methode muss zwei Argumente vom Basistyp (<codeph class="+ topic/ph pr-d/codeph ">T</codeph>) des Vectors aufweisen und eine Zahl zurückgeben:</p> |
| |
| <codeblock xml:space="preserve" class="+ topic/pre pr-d/codeblock ">function compare(x:T, y:T):Number {}</codeblock> |
| |
| <p class="- topic/p ">Die Logik der <codeph class="+ topic/ph pr-d/codeph ">compareFunction</codeph>-Funktion besteht darin, bei zwei gegebenen Elementen <codeph class="+ topic/ph pr-d/codeph ">x</codeph> und <codeph class="+ topic/ph pr-d/codeph ">y</codeph> einen der drei folgenden Werte zurückzugeben:</p> |
| |
| <ul class="- topic/ul "><li class="- topic/li ">Eine negative Zahl, wenn <codeph class="+ topic/ph pr-d/codeph ">x</codeph> vor <codeph class="+ topic/ph pr-d/codeph ">y</codeph> in der sortierten Sequenz eingeblendet werden sollte</li><li class="- topic/li ">0, wenn <codeph class="+ topic/ph pr-d/codeph ">x</codeph> und <codeph class="+ topic/ph pr-d/codeph ">y</codeph> einander entsprechen</li><li class="- topic/li ">Eine positive Zahl, wenn <codeph class="+ topic/ph pr-d/codeph ">x</codeph> in der sortierten Sequenz nach <codeph class="+ topic/ph pr-d/codeph ">y</codeph> eingeblendet werden soll</li></ul> |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Sortiert die Elemente im Vector. Diese Methode sortiert nach der Funktion, die als <codeph class="+ topic/ph pr-d/codeph ">compareFunction</codeph>-Parameter bereitgestellt wurde. |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Vector:AS3:splice" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">splice</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt einem Vector Elemente hinzu bzw. entfernt diese.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.splice, splice |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn die <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph>- und <codeph class="+ topic/ph pr-d/codeph ">deleteCount</codeph>-Argumente eine zu löschende Indexposition festlegen, die sich außerhalb der Grenzen des Vectors befindet. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn diese Methode aufgerufen wird, während <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> entsprich, und der <codeph class="+ topic/ph pr-d/codeph ">splice()</codeph>-Vorgang den <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert des Vectors ändert. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein Vector, der die aus dem ursprünglichen Vector entfernten Elemente enthält. |
| |
| </apiDesc><apiType value="Vector$T" name="type" class="- topic/state reference/state apiRef/apiType "/></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">startIndex</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">int</apiOperationClassifier><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Indexposition des Vector-Elements angibt, an der der Einfüge- oder Löschvorgang beginnt. Sie können hier negative Ganzzahlen verwenden, um eine Position in Bezug auf das Ende des Vectors anzugeben (so ist -1 das letzte Element des Vectors). |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">deleteCount</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier><apiData class="- topic/ph reference/ph apiRef/apiData ">4294967295</apiData><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die Anzahl der zu löschenden Elemente angibt. Diese Zahl schließt das im <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph>-Parameter angegebene Element ein. Wenn kein Wert für den <codeph class="+ topic/ph pr-d/codeph ">deleteCount</codeph>-Parameter festgelegt ist, löscht die Methode alle Werte des <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph>-Elements bis zum letzten Vector-Element. (Der Standardwert ist <codeph class="+ topic/ph pr-d/codeph ">uint.MAX_VALUE</codeph>.) Wenn der Wert 0 lautet, werden keine Elemente gelöscht. |
| |
| </apiDesc></apiParam><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">items</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine optionale Liste mit mindestens zwei durch Kommas getrennten Werten, die an der durch den Parameter <codeph class="+ topic/ph pr-d/codeph ">startIndex</codeph> angegebenen Position in den Vektor einzufügen sind. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt einem Vector Elemente hinzu bzw. entfernt diese. Bei dieser Methode werden Änderungen am Vector vorgenommen, ohne eine Kopie zu erstellen. |
| |
| <p class="- topic/p "><b class="+ topic/ph hi-d/b ">Hinweis:</b> Um diese Methode in einer Vector-Unterklasse zu überschreiben, verwenden Sie, wie im folgenden Beispiel gezeigt, <codeph class="+ topic/ph pr-d/codeph ">...args</codeph> für die Parameter:</p> |
| |
| <pre xml:space="preserve" class="- topic/pre "> |
| public override function splice(...args) { |
| // your statements here |
| } |
| </pre> |
| |
| </apiDesc></apiOperationDetail></apiOperation><apiOperation id="Vector:toLocaleString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toLocaleString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der die Elemente im angegebenen Vector repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String mit Vector-Elementen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der die Elemente im angegebenen Vector repräsentiert. Alle Vector-Elemente von der Indexposition 0 bis zur höchsten Indexposition werden in einen verketteten, durch Kommas getrennten String konvertiert. In der ActionScript 3.0-Implementierung gibt diese Methode den gleichen Wert wie die <codeph class="+ topic/ph pr-d/codeph ">Vector.toString()</codeph>-Methode zurück. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/toString()" class="- topic/link "><linktext class="- topic/linktext ">Vector.toString()</linktext></link></related-links></apiOperation><apiOperation id="Vector:toString" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">toString</apiName><shortdesc class="- topic/shortdesc "> |
| Gibt einen String zurück, der die Elemente im Vector repräsentiert.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.toString, toString |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Ein String mit Vector-Elementen. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">String</apiOperationClassifier></apiReturn></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Gibt einen String zurück, der die Elemente im Vector repräsentiert. Alle Vector-Elemente von der Indexposition 0 bis zur höchsten Indexposition werden in einen verketteten, durch Kommas getrennten String konvertiert. Verwenden Sie die <codeph class="+ topic/ph pr-d/codeph ">Vector.join()</codeph>-Methode, um ein benutzerdefiniertes Trennzeichen festzulegen. |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#String/split()" class="- topic/link "><linktext class="- topic/linktext ">String.split()</linktext></link><link href="#Vector/join()" class="- topic/link "><linktext class="- topic/linktext ">Vector.join()</linktext></link></related-links></apiOperation><apiOperation id="Vector:AS3:unshift" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiOperation/apiOperation "><apiName class="- topic/title reference/title apiRef/apiName ">unshift</apiName><shortdesc class="- topic/shortdesc "> |
| Fügt am Beginn eines Vectors ein oder mehrere Elemente hinzu und gibt die neue Länge des Vectors zurück.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">Vector.unshift, unshift |
| |
| </keyword></asCustoms></prolog><apiOperationDetail class="- topic/body reference/refbody apiRef/apiDetail apiOperation/apiOperationDetail "><apiOperationDef class="- topic/section reference/section apiRef/apiDef apiOperation/apiOperationDef "><apiAccess value="AS3" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn ein beliebiges Argument keine Instanz des Basistyps <codeph class="+ topic/ph pr-d/codeph ">T</codeph> des Vectors ist. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">TypeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">TypeError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn diese Methode aufgerufen wird, während <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> entspricht. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiReturn class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiReturn "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine Ganzzahl, die die neue Länge des Vectors darstellt. |
| |
| </apiDesc><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">uint</apiOperationClassifier></apiReturn><apiParam class="- topic/ph reference/ph apiRef/apiDefItem apiOperation/apiParam "><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">args</apiItemName><apiType value="restParam" name="type" class="- topic/state reference/state apiRef/apiType "/><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Eine oder mehrere Instanzen des Basistyps des Vectors, die am Anfang des Vectors eingefügt werden sollen. |
| |
| </apiDesc></apiParam></apiOperationDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Fügt am Beginn eines Vectors ein oder mehrere Elemente hinzu und gibt die neue Länge des Vectors zurück. Die anderen Elemente in diesem Vector werden von ihrer ursprünglichen Position i nach i + der Anzahl der neuen Elemente verschoben. |
| |
| <p class="- topic/p ">Da diese Funktion mehrere Argumente akzeptieren kann, wird der Datentyp der Argumente während des Kompilierens auch im Strict-Modus nicht überprüft. Wird jedoch ein Argument übergeben, das keine Instanz des Basistyps ist, tritt zur Laufzeit eine Ausnahme auf.</p> |
| |
| </apiDesc></apiOperationDetail><related-links class="- topic/related-links "><link href="#Vector/pop()" class="- topic/link "><linktext class="- topic/linktext ">Vector.pop()</linktext></link><link href="#Vector/push()" class="- topic/link "><linktext class="- topic/linktext ">Vector.push()</linktext></link><link href="#Vector/shift()" class="- topic/link "><linktext class="- topic/linktext ">Vector.shift()</linktext></link></related-links></apiOperation><apiValue id="Vector:fixed:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">fixed</apiName><shortdesc class="- topic/shortdesc "> |
| Zeigt an, ob die length-Eigenschaft des Vectors geändert werden kann.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">vector.fixed, fixed |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">Boolean</apiValueClassifier></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Zeigt an, ob die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft des Vectors geändert werden kann. Wenn der Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> ist, kann die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft nicht geändert werden. Dies bedeutet, dass die folgenden Vorgänge nicht zulässig sind, wenn <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> entspricht: |
| |
| <ul class="- topic/ul "><li class="- topic/li ">direktes Festlegen der <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft</li><li class="- topic/li ">Zuweisen eines Wertes zur Indexposition <codeph class="+ topic/ph pr-d/codeph ">length</codeph></li><li class="- topic/li ">Aufrufen einer Methode, die die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft ändert, einschließlich: |
| <ul class="- topic/ul "><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">pop()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">push()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">shift()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">unshift()</codeph></li><li class="- topic/li "><codeph class="+ topic/ph pr-d/codeph ">splice()</codeph> (wenn der <codeph class="+ topic/ph pr-d/codeph ">splice()</codeph>-Aufruf den <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert des Vectors ändert).</li></ul> |
| </li></ul> |
| |
| </apiDesc></apiValueDetail></apiValue><apiValue id="Vector:length:get" ditaarch:DITAArchVersion="1.0" domains="(topic ui-d) (topic hi-d) (topic pr-d) (topic sw-d) (topic ut-d) (topic pr-d api-d)" class="- topic/topic reference/reference apiRef/apiRef apiValue/apiValue "><apiName class="- topic/title reference/title apiRef/apiName ">length</apiName><shortdesc class="- topic/shortdesc "> |
| Der Bereich der gültigen Indexpositionen, die im Vector verfügbar sind.</shortdesc><prolog class="- topic/prolog "><asMetadata class="+ topic/metadata adobe-api-d/asMetadata "><apiVersion class="+ topic/ph adobe-api-d/apiVersion "><apiLanguage version="3.0" class="+ topic/ph adobe-api-d/apiLanguage "/><apiPlatform description="" name="Flash" version="10" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="AIR" version="1.5" class="+ topic/ph adobe-api-d/apiPlatform "/><apiPlatform description="" name="Lite" version="4" class="+ topic/ph adobe-api-d/apiPlatform "/></apiVersion></asMetadata><asCustoms class="+ topic/metadata adobe-api-d/asCustoms "><keyword class="- topic/keyword ">vector.length, length |
| |
| </keyword></asCustoms></prolog><apiValueDetail class="- topic/body reference/refbody apiRef/apiDetail apiValue/apiValueDetail "><apiValueDef class="- topic/section reference/section apiRef/apiDef apiValue/apiValueDef "><apiProperty class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiProperty "/><apiAccess value="public" class="- topic/state reference/state apiRef/apiQualifier adobe-api-d/apiAccess "/><apiDynamic class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiDynamic "/><apiValueAccess value="readwrite" class="+ topic/state reference/state apiRef/apiQualifier adobe-api-d/apiValueAccess "/><apiValueClassifier class="- topic/xref reference/xref apiRef/apiRelation apiValue/apiValueClassifier ">uint</apiValueClassifier><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn diese Eigenschaft geändert wird, während <codeph class="+ topic/ph pr-d/codeph ">fixed</codeph> dem Wert <codeph class="+ topic/ph pr-d/codeph ">true</codeph> entspricht. |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException><apiException class="+ topic/ph reference/ph apiRef/apiDefItem apiOperation/apiEvent adobe-api-d/apiException "><apiDesc class="- topic/section reference/section apiRef/apiDesc ">Wenn diese Eigenschaft auf einen Wert festgelegt ist, der höher als die maximal zulässige Indexposition ist (2<sup class="+ topic/ph hi-d/sup ">32</sup>). |
| |
| </apiDesc><apiItemName class="- topic/keyword reference/keyword apiRef/apiItemName ">RangeError</apiItemName><apiOperationClassifier class="- topic/xref reference/xref apiRef/apiRelation apiOperation/apiOperationClassifier ">RangeError</apiOperationClassifier></apiException></apiValueDef><apiDesc class="- topic/section reference/section apiRef/apiDesc "> |
| Der Bereich der gültigen Indexpositionen, die im Vector verfügbar sind. Eine Vector-Instanz hat Indexpositionen bis zum <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert, schließen diesen jedoch nicht ein. |
| |
| <p class="- topic/p ">Jedes Vector-Element hat immer einen Wert, der eine Instanz des Basistyps oder <codeph class="+ topic/ph pr-d/codeph ">null</codeph> ist. Wenn für die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft ein Wert festgelegt wird, der größer als der vorhergehende ist, werden zusätzliche Elemente erstellt und mit dem Standardwert gefüllt, der dem Basistyp (<codeph class="+ topic/ph pr-d/codeph ">null</codeph> für Verweistypen) entspricht.</p> |
| |
| <p class="- topic/p ">Wenn für die <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Eigenschaft ein Wert festgelegt wird, der kleiner als der vorhergehende ist, werden alle Elemente in den Indexpositionen, die größer oder gleich dem neuen <codeph class="+ topic/ph pr-d/codeph ">length</codeph>-Wert sind, vom Vector entfernt.</p> |
| |
| </apiDesc></apiValueDetail></apiValue></apiClassifier></apiPackage> |
