StringTools  - AS3

Nazwa bieżącego identyfikatora ustawień narodowych używanych przez dany obiekt klasy StringTools.

Istnieją trzy warianty wartości nazwy — w zależności od systemu operacyjnego i wartości parametru requestedLocaleIDName przekazywanego do konstruktora StringTools().

1. Jeśli zażądano innych ustawień narodowych niż LocaleID.DEFAULT, a system operacyjny zapewnia obsługę dla żądanych ustawień, wówczas zwrócona nazwa będzie taka sama, jak właściwość requestedLocaleIDName.
2. Jeśli wartością parametru requestedLocaleIDName przekazanego do konstruktora było LocaleID.DEFAULT, wówczas używana będzie nazwa bieżących ustawień narodowych określonych przez system operacyjny użytkownika. Wartość LocaleID.DEFAULT powoduje zachowanie niestandardowych ustawień użytkownika w systemie operacyjnym. Przekazanie wartości jawnej jako parametru requestedLocaleIDName nie spowoduje uzyskania takiego samego rezultatu, jak użycie LocaleID.DEFAULT, nawet jeśli obydwa identyfikatory ustawień narodowych są takie same. Możliwe, że użytkownik dostosował ustawienia narodowe na własnym komputerze, a żądanie jawnego identyfikatora ustawień narodowych — zamiast użyciaLocaleID.DEFAULT — sprawi, że aplikacja nie odczyta tych niestandardowych ustawień.
3. Jeśli system nie obsługuje parametru requestedLocaleIDName określonego w konstruktorze, wówczas zostanie udostępniony identyfikator alternatywnych ustawień narodowych.

Powiązane elementy interfejsu API

Status ostatniej operacji wykonanej przez ten obiekt StringTools. Właściwość lastOperationStatus zostanie ustawiona przy każdym wywołaniu konstruktora lub metody tej klasy, a także w przypadku ustawienia innej właściwości. Możliwe wartości przedstawiają opisy poszczególnych metod.

Powiązane elementy interfejsu API

Nazwa identyfikatora żądanych ustawień narodowych, która została przekazana do konstruktora obiektu klasy StringTools.

Jeśli użyto wartości LocaleID.DEFAULT, wówczas zwrócona zostanie nazwa „i-default”. W przypadku zastosowania awaryjnych ustawień narodowych rzeczywiste ustawienia mogą się różnić od żądanych ustawień narodowych. Nazwę rzeczywistych ustawień narodowych można uzyskać za pomocą właściwości actualLocaleIDName.

Powiązane elementy interfejsu API

Konstruuje nowy obiekt StringTools, który będzie realizował przekształcanie wielkości liter i inne operacje zgodnie z konwencjami właściwymi dla danych ustawień narodowych.

Ten konstruktor określa, czy aktualny system operacyjny obsługuje żądane ustawienia narodowe identyfikowane przez identyfikator. Jeśli nie są obsługiwane, wówczas zostaną wykorzystane alternatywne ustawienia narodowe. Jeśli używane są alternatywne ustawienia narodowe, wówczas właściwość lastOperationStatus będzie wskazywała typ rozwiązania alternatywnego, a właściwość actualLocaleIDName będzie zawierała identyfikator alternatywnych ustawień narodowych.

Gdy ten konstruktor pomyślnie zakończy działanie, właściwości lastOperationStatus przypisywana jest wartość:

• LastOperationStatus.NO_ERROR

Jeśli identyfikator żądanych ustawień narodowych nie jest dostępny, wówczas właściwość lastOperationStatus zostanie ustawiona na jedną z poniższych wartości:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Wyświetla listę identyfikatorów ustawień narodowych obsługiwanych przez tę klasę.

Jeśli ta klasa nie jest obsługiwana w bieżącym systemie operacyjnym, wówczas ta metoda zwróci wartość null.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Przekształca litery w ciągu znaków na małe, zgodnie z konwencjami obowiązującymi w danym języku. W przypadku niektórych ustawień narodowych długość wynikowego ciągu znaków może być różna od długości ciągu wejściowego.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

Przekształca litery w ciągu znaków na wielkie, zgodnie z konwencjami obowiązującymi w danym języku. W przypadku niektórych ustawień narodowych długość wynikowego ciągu znaków może być różna od długości ciągu wejściowego.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

Przykładowy kod wykonuje następujące czynności:

1. Tworzy nowy obiekt StringTools.
2. Definiuje trzy ciągi znaków zawierające znaki unikatowe dla języka tureckiego, greckiego i niemieckiego.
3. Konwertuje każdy ciąg znaków na małe i wielki litery i wyświetla wyniki. W tym przykładzie przedstawiono ciekawe zachowanie właściwe dla ustawień narodowych dotyczące znaków: tureckich "ı" i "Ä°", niemieckich "ß" oraz greckich "Σςσ".

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