StringTools

패키지	flash.globalization
클래스	public final class StringTools
상속	StringTools Object

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

StringTools 클래스는 로캘별 대/소문자 변환 메서드를 제공합니다.

경우에 따라 대문자 및 소문자의 변환이 문자 대 문자로 간단히 매핑되지 않고 언어 또는 컨텍스트 관련 처리가 필요할 수 있습니다. 예를 들면 다음과 같습니다.

터키어 또는 아제리어에서 점이 있는 소문자 i의 대문자는 점이 있는 대문자 İ(U+0130)이며, 마찬가지로 점이 없는 대문자 I의 소문자는 점이 없는 소문자 ı(U+0131)입니다.
독일어에서 사용되는 소문자 샤프 S, ß(U+00DF)는 대문자 이중 SS로 변환됩니다.
그리스어에서 소문자 시그마는 σ(U+03C3) 및 ς(U+03C2)의 두 가지로 표현되며 둘 다 하나의 대문자 시그마 Σ(U+03A3)로 변환됩니다.

이 클래스의 toLowerCase() 및 toUpperCase() 메서드는 이와 같은 특수한 변환 논리를 지원합니다.

요청된 로캘이 지원되지 않을 경우 사용자 설정, 운영 체제에서 제공된 대/소문자 변환 규칙 및 대체 로캘이 사용되기 때문에 같은 로캘 ID를 사용하는 경우에도 사용자에 따라 대/소문자 변환 결과가 다르게 표시될 수 있습니다.

예제 보기

공용 속성

상속되는 공용 속성 숨기기

상속되는 공용 속성 표시

	속성		정의 주체
		actualLocaleIDName : String [읽기 전용] 이 StringTools 객체에서 사용되는 실제 로캘 ID 이름입니다.	StringTools
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		lastOperationStatus : String [읽기 전용] 이 StringTools에서 수행한 가장 최근 작업의 상태입니다.	StringTools
		requestedLocaleIDName : String [읽기 전용] 이 StringTools 객체의 생성자에 전달된 요청된 로캘 ID의 이름입니다.	StringTools

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		StringTools(requestedLocaleIDName:String) 지정된 로캘 규칙에 따라 대/소문자 변환 및 기타 유틸리티를 제공하는 새 StringTools 객체를 생성합니다.	StringTools
		getAvailableLocaleIDNames():Vector.<String> [정적] 이 클래스에서 지원되는 로캘 ID 이름을 모두 나열합니다.	StringTools
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toLowerCase(s:String):String 언어 규칙에 따라 문자열을 소문자로 변환합니다.	StringTools
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		toUpperCase(s:String):String 언어 규칙에 따라 문자열을 대문자로 변환합니다.	StringTools
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object

속성 세부 정보

actualLocaleIDName

속성

actualLocaleIDName:String [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

이 StringTools 객체에서 사용되는 실제 로캘 ID 이름입니다.

운영 체제와 StringTools() 생성자에 전달된 requestedLocaleIDName 매개 변수의 값에 따라 세 가지 이름 값이 가능합니다.

요청된 로캘이 LocaleID.DEFAULT가 아니고 운영 체제에서 요청된 로캘을 지원하는 경우 requestedLocaleIDName 속성과 같은 이름이 반환됩니다.
LocaleID.DEFAULT가 생성자에 전달되는 requestedLocaleIDName 매개 변수의 값으로 사용된 경우 사용자의 운영 체제에서 지정된 현재 로캘의 이름이 사용됩니다. LocaleID.DEFAULT 값은 OS의 사용자 정의된 설정을 유지합니다. requestedLocaleIDName 매개 변수로 명시적 값을 전달하면 두 로캘 ID 이름이 같아도 LocaleID.DEFAULT를 사용할 때의 결과와 달라질 수 있습니다. 사용자가 컴퓨터에 로캘 설정을 사용자 정의했을 경우 LocaleID.DEFAULT를 사용하는 대신 명시적 로캘 ID 이름을 요청하면 응용 프로그램에서 사용자 정의된 설정을 검색하지 못합니다.
운영 체제가 생성자에 지정된 requestedLocaleIDName을 지원하지 않는 경우 대체 로캘 ID 이름이 제공됩니다.

구현
public function get actualLocaleIDName():String

lastOperationStatus

속성

lastOperationStatus:String [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

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

구현
public function get lastOperationStatus():String

관련 API 요소

LastOperationStatus

requestedLocaleIDName

속성

requestedLocaleIDName:String [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

이 StringTools 객체의 생성자에 전달된 요청된 로캘 ID의 이름입니다.

LocaleID.DEFAULT 값이 사용된 경우 "i-default"가 반환됩니다. 대체 로캘이 적용된 경우 사용된 실제 로캘은 요청된 로캘과 다를 수 있습니다. 실제 로캘 이름은 actualLocaleIDName 속성을 사용하여 검색할 수 있습니다.

구현
public function get requestedLocaleIDName():String

생성자 세부 정보

()

생성자

public function StringTools(requestedLocaleIDName:String)

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

지정된 로캘 규칙에 따라 대/소문자 변환 및 기타 유틸리티를 제공하는 새 StringTools 객체를 생성합니다.

이 생성자는 현재 운영 체제에서 요청된 ID 이름을 지원하는지 여부를 결정합니다. 지원되지 않으면 대체 로캘이 대신 사용됩니다. 대체 로캘이 사용되면 lastOperationStatus 속성에는 대체 로캘의 유형이 나타나고 actualLocaleIDName 속성에는 대체 로캘 ID의 이름이 포함됩니다.

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

LastOperationStatus.NO_ERROR

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

LastOperationStatus.USING_FALLBACK_WARNING
LastOperationStatus.USING_DEFAULT_WARNING

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

매개 변수

requestedLocaleIDName:String — 날짜 및 시간 서식을 결정할 때 사용할 기본 로캘 ID 이름입니다.

오류

ArgumentError — requestedLocaleIDName 매개 변수가 null인 경우

관련 API 요소

LocaleID
lastOperationStatus
requestedLocaleIDName
actualLocaleIDName

메서드 세부 정보

getAvailableLocaleIDNames

()

메서드

public static function getAvailableLocaleIDNames():Vector.<String>

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

이 클래스에서 지원되는 로캘 ID 이름을 모두 나열합니다.

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

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

LastOperationStatus.NO_ERROR

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

반환값

Vector.<String> — 이 클래스에서 지원되는 모든 로캘 ID 이름을 포함하는 문자열 벡터입니다.

toLowerCase

()

메서드

public function toLowerCase(s:String):String

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

언어 규칙에 따라 문자열을 소문자로 변환합니다. 로캘에 따라 출력 문자열 길이가 입력 문자열 길이와 달라질 수도 있습니다.

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

LastOperationStatus.NO_ERROR

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

매개 변수

s:String — 소문자로 변환할 문자열입니다.

반환값

String — 변환된 소문자 문자열입니다.

오류

ArgumentError — s 매개 변수가 null인 경우

관련 API 요소

lastOperationStatus
LastOperationStatus

toUpperCase

()

메서드

public function toUpperCase(s:String):String

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

언어 규칙에 따라 문자열을 대문자로 변환합니다. 로캘에 따라 출력 문자열 길이가 입력 문자열 길이와 달라질 수도 있습니다.

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

LastOperationStatus.NO_ERROR

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

매개 변수

s:String — 대문자로 변환할 문자열입니다.

반환값

String — 변환된 대문자 문자열입니다.

오류

ArgumentError — s 매개 변수가 null인 경우

관련 API 요소

lastOperationStatus
LastOperationStatus

예제 예제 사용 방법

StringToolsExample.as

다음 예제에서는 여러 가지 문자열이 언어적으로 올바른 방식에서 소문자 및 대문자로 변환되는 방식을 보여 줍니다.

이 예제에서는 다음 단계를 수행합니다.

StringTools 객체를 만듭니다.
터키어, 그리스어, 독일어에 고유한 문자를 사용하여 세 개의 문자열을 정의합니다.
각 문자열을 대문자 및 소문자로 변환하고 결과를 표시합니다. 다음 예제에서는 터키어의 "Ä±"와 "Ä°", 독일어의 "ÃŸ" 및 그리스어의 "Î£Ï‚Ïƒ" 같은 문자에 대한 흥미로운 로캘 관련 비헤이비어를 보여 줍니다.

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

법적 고지 사항 | 온라인 개인 정보 보호 정책

StringTools - AS3

패키지x

언어 요소

부록

패키지 flash.globalization

actualLocaleIDName

lastOperationStatus

requestedLocaleIDName

StringTools

getAvailableLocaleIDNames

toLowerCase

toUpperCase