LocaleID  - AS3

이 LocaleID 객체에서 수행한 가장 최근 작업의 상태입니다. lastOperationStatus 속성은 이 클래스의 생성자 또는 메서드가 호출되거나 다른 속성이 설정될 때마다 설정됩니다. 가능한 값은 각 메서드의 설명을 참조하십시오.

관련 API 요소

좀 더 "정규화된" 로캘 식별자를 반환합니다.

이 메서드는 로캘 ID 이름에 대해 다음 변환을 수행하여 좀 더 정규화된 형식을 제공합니다.

• 모든 구성 요소에 적절한 대/소문자 구분이 적용됩니다.
• 밑줄이 대시로 변환됩니다.

추가 처리가 수행되지 않습니다. 예를 들어 별칭이 대체되지 않으며 어떤 요소도 추가되거나 제거되지 않습니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

지정된 로캘 이름으로 새 LocaleID 객체를 생성합니다. 로캘 이름은 유니코드 기술 표준 #35(http://unicode.org/reports/tr35/)에서 정의된 구문을 따라야 합니다.

생성자가 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

요청된 로캘 ID 이름이 지원되지 않으면 lastOperationStatus가 다음 중 하나로 설정됩니다.

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

위에 나열된 경고 및 lastOperationStatus 속성의 다른 가능한 값에 대한 자세한 내용은 LastOperationStatus 클래스의 설명을 참조하십시오.

관련 API 요소

원하는 로캘 목록과 현재 지원되는 로캘 목록을 기반으로 사용 가능한 로캘 목록을 반환합니다.

결과 목록이 환경 설정 순으로 정렬됩니다.

이 메서드의 일반적인 사용 예는 다음과 같습니다.

• 사용자가 이해하는 언어 목록을 지정합니다. 이 목록은 사용자 프로파일, 브라우저 설정 또는 쿠키에 저장됩니다. 사용자가 가장 잘 이해하는 언어를 첫 번째로 나열하므로 목록에서 언어의 순서가 관련이 있습니다. 이 목록은 "want" 목록입니다.
• 응용 프로그램이 여러 가지 언어로 지역화됩니다. 이 목록은 "have" 목록입니다.
• determinePreferredLocales() 메서드는 사용자의 기본 언어가 처음에 오도록 정렬된 두 목록의 교차 목록을 반환합니다.

이 기능이 현재 운영 체제에서 지원되지 않는 경우 이 메서드는 null 값을 반환합니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

매개 변수

관련 API 요소

LocaleID 객체의 키와 값 쌍을 모두 포함하는 객체를 반환합니다.

반환된 객체는 해시 테이블 또는 연관 배열로 구성되며, 여기서 각 속성 이름은 키와 해당 키의 값인 속성의 값을 나타냅니다. 예를 들어 다음 코드는 getKeysAndValues() 메서드를 사용하여 LocaleID 객체에서 가져온 모든 키와 값을 나열합니다.

         var myLocale:LocaleID = new LocaleID("fr-CA");
         var localeData:Object = myLocale.getKeysAndValues();
         for (var propertyName:String in localeData)
         {
           trace(propertyName + " = " + localeData[propertyName]);
         }
         

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

로캘 ID 이름에서 지정한 언어 코드를 반환합니다.

로캘 이름을 올바르게 파싱할 수 없으면 언어 코드는 전체 로캘 이름과 같아집니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

로캘 ID 이름에서 지정한 지역 코드를 반환합니다.

이 메서드는 지역 코드를 파싱하거나 추측할 수 없는 경우 빈 문자열을 반환합니다. "xy" 같은 알 수 없거나 불완전한 로캘 ID 이름이 사용된 경우가 이에 해당됩니다. 지역 코드는 고정된 목록에 대해 유효성이 검사되지 않습니다. 예를 들어 "xx-YY"의 로캘 ID 이름에 대해 지역 코드 "YY"가 반환됩니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

지정된 로캘 이름에 해당 지역이 속하지 않으면 해당 로캘에 대해 가장 근접한 지역 코드가 "추측"되고 lastOperationStatus 속성이 LastOperationStatus.USING_FALLBACK_WARNING으로 설정됩니다.

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

로캘 ID 이름에서 지정한 스크립트 코드를 반환합니다.

이 메서드는 스크립트 코드를 파싱하거나 추측할 수 없는 경우 빈 문자열을 반환합니다. "xy" 같은 알 수 없거나 불완전한 로캘 ID 이름이 사용된 경우가 이에 해당됩니다. 스크립트 코드는 고정된 목록에 대해 유효성이 검사되지 않습니다. 예를 들어 "xx-Abcd-YY"의 로캘 ID 이름에 대해 스크립트 코드 "Abcd"가 반환됩니다.

언어뿐 아니라 지역도 반환 값에 영향을 줄 수 있습니다. 예를 들어 "mn-MN"(몽골어-몽골)에 대한 스크립트 코드는 "Cyrl"(키릴어)이 되고 "mn-CN"(몽골어-중국)에 대한 스크립트 코드는 "Mong"(몽골어)이 됩니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

지정된 로캘 이름에 해당 스크립트 코드가 속하지 않으면 가장 근접한 스크립트 코드가 "추측"되고lastOperationStatus 속성이 LastOperationStatus.USING_FALLBACK_WARNING으로 설정됩니다.

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

로캘 ID 이름에서 지정한 언어 변형 코드를 반환합니다.

이 메서드는 지정된 로캘 ID 이름에 언어 변형 코드가 없는 경우 빈 문자열을 반환합니다. 언어 변형을 필요로 하거나 포함하는 로캘은 드물기 때문에 추측이 필요하지 않습니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

지정된 로캘의 텍스트 방향이 오른쪽에서 왼쪽인지 지정합니다.

이 결과는 Flash 텍스트 엔진에서 텍스트 방향을 결정하거나, 현재 텍스트 방향을 지원하기 위해 사용자 인터페이스를 미러링해야 하는지 여부를 결정하는 데 사용할 수 있습니다.

이 메서드가 호출되고 성공적으로 완료되면 lastOperationStatus 속성이 다음으로 설정됩니다.

• LastOperationStatus.NO_ERROR

또는 lastOperationStatus 속성이 LastOperationStatus 클래스에 정의된 상수 중 하나로 설정됩니다.

관련 API 요소

사용자의 운영 체제 설정에 지정된 기본 언어 설정을 사용하도록 나타냅니다. 예를 들어 이러한 환경 설정은 대개 "제어판"(Windows) 또는 "시스템 환경 설정"(Mac OS X)을 사용하여 설정됩니다.

LocaleID.DEFAULT 설정을 사용하면 작업 유형별로 서로 다른 로캘 ID 이름이 사용될 수 있습니다. 예를 들어 정렬 및 서식 지정에서 서로 다른 로캘이 사용될 수 있습니다. 이러한 유연성으로 인해 사용자 환경 설정을 유지할 수 있으며 해당 클래스는 이러한 방식으로 동작하도록 설계되었습니다.

이 로캘 식별자는 사용하기에 가장 적절한 식별자가 아닐 수 있습니다. 브라우저에서 실행되는 응용 프로그램의 경우 브라우저의 기본 로캘이 더 적절할 수 있습니다. 따라서 일반적으로 사용자가 기본 로캘 ID 이름 설정을 변경하고 해당 환경 설정을 사용자 프로파일, 쿠키 또는 공유 객체에 유지할 수 있도록 하는 것이 좋습니다.

이 예제에서는 아랍어(사우디 아라비아), 영어(미국), 영어(미국, POSIX 변형), 중국어(중국), 중국어(대만), 중국어(한자), 중국어(중국 및 여러 키와 값) 로캘을 사용합니다.

이 예제에서는 목록의 각 로캘에 대해 다음 작업을 수행합니다.

1. 새 LocaleID 객체를 만듭니다.
2. 다양한 LocaleID 속성을 표시합니다. 표시되는 값은 운영 체제 및 사용자 환경 설정에 따라 달라집니다.
3. 해당 LocaleID의 전체 키 및 값 집합을 표시합니다.

package 
{
    import flash.display.Sprite;
    import flash.globalization.LocaleID;
    
    public class LocaleIDExample extends Sprite
    {
        public function LocaleIDExample()
        {
            var localeNames:Array = ["ar-SA", "EN_us", "en-US-POSIX", "zh-CH", "zh-TW", "zh-Hans", "zh-CH@collation=pinyin;calendar=chinese;currency=RMB"];
            
            for ( var i:int = 0; i < localeNames.length; i++ ) 
            {
                var locID:LocaleID = new LocaleID( localeNames[i] as String );
                
                trace('\n\n' + "LocaleID requested: " + locID.requestedLocaleIDName 
                    + "; actual: " + locID.actualLocaleIDName);
                trace( "Last Operation Status after new LocaleID: " + locID.lastOperationStatus);
                
                trace("name:     " + locID.name);
                trace("language: " + locID.getLanguage() + "; status: "  + locID.lastOperationStatus);
                trace("script:   " + locID.getScript()  +  "; status: "  + locID.lastOperationStatus);
                trace("region:   " + locID.getRegion()  +  "; status: "  + locID.lastOperationStatus);
                trace("variant:  " + locID.getVariant()  + "; status: "  + locID.lastOperationStatus);
                trace("isRightToLeft: ", locID.isRightToLeft(), "; status: "  + locID.lastOperationStatus);
                
                var keysAndValues:Object = locID.getKeysAndValues();
                var key:String;
                for (key in keysAndValues)
                {
                    trace("key: ", key + " value: " + keysAndValues[ key ]);
                }
                trace( "Last Operation Status after getKeysAndValues(): " + locID.lastOperationStatus);
            }
        }
    }
}