StringTools  - AS3

Der Name der Gebietsschema-ID, die von diesem StringTools-Objekt verwendet wird.

Es gibt drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des requestedLocaleIDName-Parameters, der an den StringTools()-Konstruktor übergeben wird.

1. Wenn das angeforderte Gebietsschema nicht LocaleID.DEFAULT war und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit der requestedLocaleIDName-Eigenschaft.
2. Wenn LocaleID.DEFAULT als Wert für den requestedLocaleIDName-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. Der LocaleID.DEFAULT-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts als requestedLocaleIDName-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung von LocaleID.DEFAULT, selbst wenn die beiden Gebietsschema-ID-Namen identisch sind. Der Benutzer hat die Gebietsschemaeinstellungen auf dem Computer möglicherweise angepasst. Wenn Sie einen expliziten Gebietsschema-ID-Namen anfordern, anstatt LocaleID.DEFAULT zu verwenden, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht.
3. Wenn das System den im Konstruktor angegebenen requestedLocaleIDName nicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.

Verwandte API-Elemente

Der Status der letzten Operation, die dieses StringTools-Objekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine andere Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.

Verwandte API-Elemente

Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses StringTools-Objekts übergeben wurde.

Wenn der Wert LocaleID.DEFAULT verwendet wurde, lautet der zurückgegebene Name "i-default". Das tatsächlich verwendete Gebietsschema kann vom angeforderten Gebietsschema abweichen, wenn ein Ersatzgebietsschema verwendet wird. Der Name des tatsächlich verwendeten Gebietsschemas kann mit der actualLocaleIDName-Eigenschaft abgerufen werden.

Verwandte API-Elemente

Konstruiert ein neues StringTools-Objekt, das Groß-/Kleinschreibungskonvertierung und andere Dienstprogramme gemäß den Konventionen eines gegebenen Gebietsschemas bietet.

Dieser Konstruktor ermittelt, ob das aktuelle Betriebssystem den angeforderten Gebietsschema-ID-Namen unterstützt. Wenn dieser nicht unterstützt wird, wird stattdessen ein Ersatzgebietsschema verwendet. Wenn ein Ersatzgebietsschema verwendet wird, gibt die lastOperationStatus-Eigenschaft den Typ der Ausweichlösung an und die actualLocaleIDName-Eigenschaft enthält den Namen der Ersatzgebietsschema-ID.

Wenn dieser Konstruktor erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft auf diesen Wert gesetzt:

• LastOperationStatus.NO_ERROR

Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat lastOperationStatus einen der folgenden Werte:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.

Wenn diese Klasse vom aktuellen Betriebssystem nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Konvertiert einen String in Großbuchstaben gemäß den Sprachkonventionen. Je nach Gebietsschema kann die Länge des Ausgabestrings von der Länge des Eingabestrings abweichen.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Parameter

Verwandte API-Elemente

Konvertiert einen String in Kleinbuchstaben gemäß den Sprachkonventionen. Je nach Gebietsschema kann die Länge des Ausgabestrings von der Länge des Eingabestrings abweichen.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Parameter

Verwandte API-Elemente

Dieses Beispiel führt die folgenden Schritte aus:

1. Erstellt ein StringTools-Objekt.
2. Definiert drei Strings mit Zeichen, die im Türkischen, Griechischen und Deutschen verwendet werden.
3. Konvertiert jeden String in Großbuchstaben und Kleinbuchstaben und zeigt die Ergebnisse an. Dieses Beispiel demonstriert interessante gebietsschemaspezifische Verhaltensweisen für Zeichen wie das türkische „ı“ und „Ä°, das deutsche „ß“ und das griechische „Σςσ“.

package {
    import flash.display.Sprite;
    import flash.globalization.LocaleID;
    import flash.globalization.StringTools;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class StringToolsExample extends Sprite
    {
        public function StringToolsExample()
        {
            var localeName:String= LocaleID.DEFAULT;
            var strTool:StringTools = new StringTools(localeName);
            
            trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName 
            + "; actual: " + nf.actualLocaleIDName);
            trace( "Last Operation Status:" + nf.lastOperationStatus );  
            
            var turkishStr:String = "iI ıİ";
            var greekStr:String = "Σςσβΰ�Σ";
            var germanStr:String= "ß";
            
            var tfTurInp:TextField = createTextField(10, 10);
            tfTurInp.text="Turkish Input: \t " + turkishStr;
            
            var tfdash:TextField = createTextField(10, 20);
            tfdash.text="-------------------";
            
            var tf1:TextField = createTextField(10, 30);
            tf1.text="\t Upper case: \t " + strTool.toUpperCase(turkishStr);
            
            var tf2:TextField = createTextField(10, 40);
            tf2.text="\t Lower case: \t " + strTool.toLowerCase(turkishStr);
            
            var tfgreekInp:TextField = createTextField(10, 60);
            tfgreekInp.text="Greek Input: \t " + greekStr;
            
            var tfdash1:TextField = createTextField(10, 70);
            tfdash1.text="-------------------";
            
            var tf3:TextField = createTextField(10, 80);
            tf3.text="\t Upper case: \t " + strTool.toUpperCase(greekStr);
            
            var tf4:TextField = createTextField(10, 90);
            tf4.text="\t Lower case: \t " + strTool.toLowerCase(greekStr);
            
            var tfgermanInp:TextField = createTextField(10, 110);
            tfgermanInp.text="German Input: \t " + germanStr;
            
            var tfdash2:TextField = createTextField(10, 120);
            tfdash2.text="-------------------";
                         
            var tf5:TextField = createTextField(10, 130);
            tf5.text="\t Upper case: \t " + strTool.toUpperCase(germanStr);
            
            var tf6:TextField = createTextField(10, 140);
            tf6.text="\t Lower case: \t " + strTool.toLowerCase(germanStr);
        }
        
        private function createTextField(x:Number, y:Number):TextField 
        {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.autoSize=TextFieldAutoSize.LEFT;
            addChild(result);
            return result;
        }
    }
}