NumberFormatter  - AS3 Flex

Der Name der Gebietsschema-ID, die von diesem Klassenobjekt verwendet wird. Dies ist das Gebietsschema, das verwendet wird, um auf Formatierungsdaten und Funktionen vom Betriebssystem aus zuzugreifen.

Wenn das vom locale-Stil festgelegte Gebietsschema nicht verfügbar ist, sind der Wert des actualLocaleIDName und der Wert des locale-Stils unterschiedlich. Er gibt das Ersatzgebietsschema an, das verwendet wird. Wenn für den locale-Stil LocaleID.DEFAULT festgelegt wurde, wird der Name des vom Betriebssystem des Benutzers festgelegten Gebietsschemas verwendet.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Verwandte API-Elemente

Ein numerischer Wert, der ein Formatierungsmuster für negative Zahlen angibt. Dieses Muster definiert die Position des Negativsymbols oder von Klammern in Relation zum numerischen Teil der formatierten Zahl.

In der folgenden Tabelle sind die möglichen Formate für negative Zahlen aufgeführt. Wenn eine negative Zahl formatiert wird, wird das Minuszeichen im Format durch den Wert der negativeSymbol-Eigenschaft ersetzt und das Zeichen 'n' wird durch den formatierten numerischen Wert ersetzt.

Der Standardwert hängt vom Gebietsschema und Betriebssystem ab.

Diese Eigenschaft kann als Quelle für die Datenbindung verwendet werden. Beim Ändern dieser Eigenschaft wird das change -Ereignis ausgelöst.

Verwandte API-Elemente

Konstruiert ein neues NumberFormatter-Objekt, um Zahlen entsprechend den Konventionen eines gegebenen Gebietsschemas zu formatieren.

Das Gebietsschema für diese Klasse wird vom Gebietsschemastil bereitgestellt. Der Gebietsschemastil kann auf verschiedene Weisen festgelegt werden:

• Durch Verwenden der Klasse in einer MXML-Deklaration und Übernehmen des Gebietsschemas aus dem Dokument, das die Deklaration enthält. Beispiel:

        <fx:Declarations> 
               <s:NumberFormatter id="nf" />
        </fx:Declarations>

• Durch Verwenden einer MXML-Deklaration und Festlegen des Gebietsschemawerts in der Liste mit Zuweisungen. Beispiel:

        <fx:Declarations>
            <s:NumberFormatter id="nf_French_France" locale="fr_FR" />
        </fx:Declarations>

• Aufrufen der setStyle-Methode. Beispiel:

        nf.setStyle("locale", "fr-FR")

• Übernehmen des Stils aus einer UIComponent durch Aufruf der addStyleClient()-Methode der UIComponent.

Wenn der locale-Stil nicht durch eine der oben beschriebenen Methoden festgelegt wird, wird die Instanz dieser Klasse als StyleClient der topLevelApplication hinzugefügt und übernimmt daher den locale-Stil aus dem topLevelApplication-Objekt, wenn die locale-abhängige Get-Funktion oder locale-abhängige Methode aufgerufen wird.

Die meisten Eigenschaften dieser Klasse werden automatisch basierend auf dem Gebietsschemastil festgelegt. Wenn der Gebietsschemastil geändert wird, werden auch alle Eigenschaften, die nicht explizit festgelegt wurden, basierend auf dem neuen Gebietsschema aktualisiert. Beachten Sie, dass das verwendete Gebietsschema von der actualLocaleIDName-Eigenschaft festgelegt wird.

Verwandte API-Elemente

Formatiert eine Zahl.

Diese Funktion formatiert die Zahl anhand der Eigenschaftenwerte des Formatters. Wenn die Eigenschaften nach dem Festlegen des locale-Stils nicht geändert werden, werden die Zahlen so formatiert, wie es die gebietsschemaspezifischen Konventionen vorsehen, die vom Betriebssystem für das von der actualLocaleIDName-Eigenschaft angegebene Gebietsschema bereitgestellt werden. Zur Anpassung des Formats können die Eigenschaften geändert werden, um bestimmte Aspekte der Zahlenformatierung zu steuern.

Mit dieser Funktion können sehr große und sehr kleine Zahlen formatiert werden. Die Anzahl der gültigen Ziffern wird jedoch durch die vom Number-Objekt angegebene Genauigkeit limitiert. Die wissenschaftliche Schreibweise wird nicht unterstützt.

Wenn aufgrund eines unzulässigen Eingabewerts oder anderen Fehlers ein Fehler beim Formatieren auftritt, gibt die format()-Methode standardmäßig null zurück. Wenn die errorText-Eigenschaft jedoch ungleich null ist, wird der Wert der errorText-Eigenschaft zurückgegeben. Die lastOperationStatus-Eigenschaft wird festgelegt, um den aufgetretenen Fehler anzugeben.

Parameter

Verwandte API-Elemente

Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden. Dies ist eine Liste von Gebietsschemas, die vom Betriebssystem unterstützt werden. Dies ist keine Liste von Gebietsschemas, für die der ResourceManager Ressourcen hat.

Analysiert einen String und gibt ein NumberParseResult-Objekt zurück, das die analysierten Elemente enthält.

Das NumberParseResult-Objekt enthält den Wert der ersten Zahl, die im Eingabestring gefunden wird, den Startindex für die Zahl in diesem String und den Index des ersten Zeichens nach der Zahl im String.

Wenn der String keine Zahl enthält, wird die value-Eigenschaft von NumberParseResult auf NaN gesetzt und die Eigenschaften startIndex und endIndex werden auf den Hexadezimalwert 0x7fffffff gesetzt.

Diese Funktion verwendet den Wert der decimalSeparator-Eigenschaft, um den Teil der Zahl zu ermitteln, der gebrochene Ziffern enthält, die groupingSeparator-Eigenschaft, um zu ermitteln, welche Zeichen in den Ziffern einer Zahl zulässig sind, und die negativeNumberFormat-Eigenschaft, um zu steuern, wie negative Werte dargestellt werden.

In der folgenden Tabelle sind die Ergebnisse von analysierten Strings für die verschiedenen Werte von NegativeNumberFormat aufgeführt:

Zwischen den Zahlen und dem Minuszeichen oder den Klammern ist ein einzelner Leerraum zulässig. Ein Leerraumzeichen ist ein Zeichen, das eine Space Separator(Zs)-Eigenschaft in der Unicode-Zeichendatenbank hat. Weitere Informationen finden Sie unter http://www.unicode.org/ucd/.

Andere Eigenschaften werden beim Ermitteln einer gültigen Nummer ignoriert. Speziell der Wert der digitsType-Eigenschaft wird ignoriert und die Ziffern können aus einem der Ziffernsätze stammen, die in der NationalDigitsType-Klasse aufgezählt werden. Die Werte der Eigenschaften groupingPattern und useGrouping haben keinen Einfluss auf die Analyse der Zahl.

Wenn vor oder hinter einer Zahl im String ein Pluszeichen + steht, wird das Pluszeichen als Zeichen gewertet, das kein Teil der Zahl ist.

Diese Funktion analysiert keine Strings, die Zahlen in wissenschaftlicher Schreibweise enthalten (z. B. 1.23e40).

Parameter

Verwandte API-Elemente

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale","fr-FR");
      var str:String = "1,56 mètre"
      var result:NumberParseResult = nf.parse(str);
      trace(result.value) // 1.56
      trace(str.substr(0,result.startIndex));                // ""
      trace(str.substr(result.startIndex, result.endIndex)); // "1,56"
      trace(str.substr(result.endIndex));                 // " mètre"
      

Analysiert einen String, der nur Ziffern und optionale Leerraumzeichen enthält und gibt eine Zahl zurück. Wenn der String nicht mit einer Zahl beginnt oder andere Zeichen als Leerraum enthält, die nicht Teil der Zahl sind, gibt diese Methode NaN zurück. Leerraum vor oder nach den numerischen Zeichen wird ignoriert.

Wenn vor oder hinter der numerischen Ziffer ein Pluszeichen „+“ steht, wird es als Nicht-Leerraumzeichen behandelt. Der Rückgabewert ist NaN.

Weitere Informationen zur Analyse von Zahlen und der Definition von gültigen Zahlen finden Sie in der Beschreibung der parse-Funktion.

Parameter

Verwandte API-Elemente