This page was saved using jaction on 2006-09-04 8:34:06.
Address: http://flexdocs.kr/docs/flex2/langref/String.html
Title: String (Flex™ 2 레퍼런스 가이드)  •  Size: 85138
Package톱 레벨
Classpublic final class String
InheritanceString Inheritance Object

String 클래스는, 캐릭터의 string를 나타내는 데이터형입니다. String 클래스는, 원시적인 string치의 형태의 조작을 가능하게 하는 Methods와 property를 제공합니다. String() 함수를 사용해 임의의 object의 값을 String 데이터형 object로 변환할 수 있습니다.

concat(),fromCharCode(),slice(),substr() 를 제외하는 String 클래스의 모든 Methods는 범용 Methods입니다. 즉, Methods가 toString() 를 호출한 다음에, Methods의 조작이 실행됩니다. 이러한 Methods는 String object 이외의 object에서도 사용할 수 있습니다.

모든 string 인덱스는 제로로부터 시작되기 (위해)때문에, 각 string x 의 최종 캐릭터의 인덱스는 x.length - 1 과 같이 됩니다.

constructor    Methods new String() 를 사용해 새로운 string 변수를 작성하는지, 또는 단지 string 리터럴치를 할당할까에 관계없이, String 클래스의 Methods를 어떤 것에서도 호출할 수가 있습니다. 구버젼의 ActionScript 과는 달리, String 클래스의 Methods에는, constructor    을 사용하는지, 글로벌 함수를 사용하는지, 또는 단지 string 리터럴치를 할당할까에 의한 차이는 없습니다. 다음의 각 행의 코드는 같습니다.

 var str:String = new String("foo");
 var str:String = "foo";
 var str:String = String("foo");

string 변수를 undefined 로 설정하면, Adobe® Flash® Player 에 의해 undefinednull 에 형태 변환됩니다. 다음에 예를 나타냅니다.

var s:String = undefined;
이 명령문(statement)에서는, 값은 undefined 는 아니고 null 로 설정됩니다. undefined 를 사용할 필요가 있는 경우는,String() 함수를 사용합니다.

View the examples

See also

String Function
데이터형의 상세
형태 변환
string의 조작
정규 표현의 개요


Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  length : int
[read-only] 지정한 String object내에 있는 캐릭터수를 나타내는 정수입니다.
String
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
Public Methods
 Methods정의
  String (val:String )
지정된 string에 초기화된 새로운 String object를 작성합니다.
String
  charAt (index:Number = 0):String
index Parameters로 지정된 위치에 있는 캐릭터를 돌려줍니다.
String
  charCodeAt (index:Number = 0):Number
지정된 index 에 있는 캐릭터의 수치 Unicode 문자 코드를 돌려줍니다.
String
  concat (... args):String
지정된 인수를 필요에 따라서 string로 변환해, String object의 마지막에 추가해 결과의 string를 돌려줍니다.
String
  fromCharCode (... charCodes):String
[static] Parameters내의 Unicode 문자 코드에 대응하는 캐릭터를 string로서 돌려줍니다.
String
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
  indexOf (val:String , startIndex:Number = 0):int
string내를 검색해, string내의 startIndex 이후의 위치에서 발견된 최초의 val 의 위치를 돌려줍니다.
String
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
  lastIndexOf (val:String , startIndex:Number = 0x7FFFFFFF):int
string를 금방 다른 곳으로찾아,startIndex 의 전에 발견된 마지막 val 의 인덱스를 돌려줍니다.
String
  localeCompare (other:String , ... values):int
복수의 string의 소트순서를 비교해, 비교의 결과를 정수로 돌려줍니다.
String
  match (pattern:* ):Array
지정된 pattern 를 string와 조합합니다.
String
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
  replace (pattern:* , repl:Object ):String
지정된 pattern 를 string와 조합해, 새로운 string를 돌려줍니다. 이 새로운 string에서는,pattern 와 최초로 일치한 부분이 repl 로 지정된 내용으로 옮겨집니다.
String
  search (pattern:* ):int
지정된 pattern 를 검색해, 최초로 일치한 substring의 인덱스를 돌려줍니다.
String
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
  slice (startIndex:Number = 0, endIndex:Number = 0x7fffffff):String
돌려주어지는 string에는,startIndex 캐릭터로부터 endIndex 캐릭터의 전까지의 모든 캐릭터가 포함됩니다.
String
  split (delimiter:* , limit:Number = 0x7fffffff):Array
지정된 delimiter Parameters가 있는 여러분치로 String object를 substring의 배열에 분할합니다.
String
  substr (startIndex:Number = 0, len:Number = 0x7fffffff):String
지정되었다 startIndex 로 개시하는 캐릭터로 구성되어len 로 지정된 길이를 가지는 substring를 돌려줍니다.
String
  substring (startIndex:Number = 0, endIndex:Number = 0x7fffffff):String
startIndex 로 지정된 캐릭터로부터 endIndex - 1 까지의 모든 캐릭터로 구성되는 string를 돌려줍니다.
String
  toLocaleLowerCase ():String
이 string의 복사를 돌려줍니다. 모든 대문자가 소문자에 변환됩니다.
String
  toLocaleUpperCase ():String
이 string의 복사를 돌려줍니다. 모든 소문자가 대문자에 변환됩니다.
String
  toLowerCase ():String
이 string의 복사를 돌려줍니다. 모든 대문자가 소문자에 변환됩니다.
String
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
  toUpperCase ():String
이 string의 복사를 돌려줍니다. 모든 소문자가 대문자에 변환됩니다.
String
  valueOf ():String
String 인스턴스의 원시적치를 돌려줍니다.
String
property의 상세
lengthproperty
length:int   [read-only]

지정한 String object내에 있는 캐릭터수를 나타내는 정수입니다.

모든 string 인덱스는 제로로부터 시작되기 (위해)때문에, 각 string x 의 최종 캐릭터의 인덱스는 x.length - 1 과 같이 됩니다.

Implements
    public function get length():int

See also

constructor    의 상세
String()constructor   
public 함수 String(val:String )

지정된 string에 초기화된 새로운 String object를 작성합니다.

메모 :String object보다 string 리터럴을 사용하는 (분)편이 부하가 적고, 일반적으로보다 간단하게 사용할 수 있습니다. String object를 사용하는 것에 특별한 이유가 없는 경우 이외는, String 클래스보다 string 리터럴을 사용하는 것을 추천합니다.

Parameters
val:String — 새로운 String object의 초기치입니다.

See also

Methods의 상세
charAt()Methods
AS3 function charAt(index:Number = 0):String

index Parameters로 지정된 위치에 있는 캐릭터를 돌려줍니다. index 로 지정된 값이 0 ~ string.length - 1 의 범위내에 없는 경우는, empty의 string를 돌려줍니다.

이 Methods는 String.charCodeAt() 를 닮아 있습니다만, 16 비트 정수의 문자 코드는 아니고 캐릭터가 돌려주어지는 점이 다릅니다.

Parameters
index:Number (default = 0) — string내의 캐릭터의 위치를 나타내는 정수입니다. 최초의 캐릭터의 위치는 0 으로, 마지막 캐릭터의 위치는 my_str.length - 1 입니다.

반환값
String — 지정된 인덱스 위치에 있는 캐릭터입니다. 지정된 인덱스가 이 string의 인덱스의 범위외인 경우는, empty의 string가 돌려주어집니다.

See also

charCodeAt()Methods 
AS3 function charCodeAt(index:Number = 0):Number

지정된 index 에 있는 캐릭터의 수치 Unicode 문자 코드를 돌려줍니다. index 로 지정된 값이 0 ~ string.length - 1 의 범위내에 없는 경우는,NaN 를 돌려줍니다.

이 Methods는,String.charAt() 와 닮아 있습니다만, 실제의 캐릭터는 아니고 16 비트 정수 문자 코드를 돌려주는 점이 다릅니다.

Parameters
index:Number (default = 0) — string내의 캐릭터의 위치를 나타내는 정수입니다. 최초의 캐릭터의 위치는 0 으로, 마지막 캐릭터의 위치는 my_str.length - 1 입니다.

반환값
Number — 지정된 인덱스에 있는 캐릭터의 Unicode 문자 코드를 돌려줍니다. 또는, 인덱스가 이 string의 인덱스의 범위외인 경우는, NaN 를 돌려줍니다.

See also

concat()Methods 
AS3 function concat(... args):String

지정된 인수를 필요에 따라서 string로 변환해, String object의 마지막에 추가해 결과의 string를 돌려줍니다. 소스의 String object의 원의 값은 변경되지 않습니다.

Parameters
... args — 연결되는 0 개 이상의 값입니다.

반환값
String — 지정의 Parameters에 의해 연결된 이 string로 구성되는 새로운 string입니다.

See also

fromCharCode()Methods 
AS3 static function fromCharCode(... charCodes):String

Parameters내의 Unicode 문자 코드에 대응하는 캐릭터를 string로서 돌려줍니다.

Parameters
... charCodes — Unicode 값를 나타내는 일련의 10 진정수입니다.

반환값
String — 지정된 Unicode 문자 코드의 string치입니다.

See also

indexOf()Methods 
AS3 function indexOf(val:String , startIndex:Number = 0):int

string내를 검색해, string내의 startIndex 이후의 위치에서 발견된 최초의 val 의 위치를 돌려줍니다. 이 인덱스는 제로로부터 시작됩니다. 즉 string의 최초의 캐릭터는, 인덱스 1 은 아니고 인덱스 0 에 있다고 보여집니다. val 가 발견되지 않는 경우, Methods는 -1 을 돌려줍니다.

Parameters
val:String — 검색 대상의 string입니다.
 
startIndex:Number (default = 0) — 검색을 개시하는 인덱스를 나타내는 정수입니다. 이것은 옵션입니다.

반환값
int — 지정의 substring 또는 -1 으로 최초로 발견된 지정의 substring의 인덱스입니다.

See also

lastIndexOf()Methods 
AS3 function lastIndexOf(val:String , startIndex:Number = 0x7FFFFFFF):int

string를 금방 다른 곳으로찾아,startIndex 의 전에 발견된 마지막 val 의 인덱스를 돌려줍니다. 이 인덱스는 제로로부터 시작됩니다. 즉 최초의 캐릭터는 인덱스 0 에 있어, 마지막 캐릭터는 string.length - 1 에 있습니다. val 가 발견되지 않았던 경우는,-1 을 돌려줍니다.

Parameters
val:String — 검색 대상의 string입니다.
 
startIndex:Number (default = 0x7FFFFFFF)val 의 검색을 개시하는 인덱스를 나타내는 정수입니다. 이것은 옵션입니다. 디폴트는, 인덱스에 허가되고 있는 최대치입니다. startIndex 가 지정되어 있지 않은 경우, string내의 마지막 아이템으로부터 검색이 개시됩니다.

반환값
int — 마지막에 발견된 지정의 substring의 위치입니다. 발견되지 않았던 경우는 -1 을 돌려줍니다.

See also

localeCompare()Methods 
AS3 function localeCompare(other:String , ... values):int

복수의 string의 소트순서를 비교해, 비교의 결과를 정수로 돌려줍니다. 이 Methods는 로케일에 특화한 방법으로 비교를 처리하는 것을 목적으로 하고 있습니다만, ActionScript 3.0 Implements에서는, 등가 (==) 연산자 또는 부등값 (! =) 연산자등의 다른 string 비교와 다른 결과를 생성하지 않습니다. string가 등가의 경우, 반환값은 0 이 됩니다. 원의 string치가 other 로 지정된 string치보다 앞에 오는 경우, 반환값은 부의 정수가 됩니다. 이 값의 절대치는, 2 개의 string치를 멀리하는 캐릭터수를 나타냅니다. 원의 string치가 other 의 뒤에 오는 경우, 반환값은 정의 정수가 됩니다. 이 값의 절대치는, 2 개의 string치를 멀리하는 캐릭터수를 나타냅니다.

Parameters
other:String — 비교하는 string치입니다.
 
... values — 비교하는 string의 추가 세트입니다. 이것은 옵션입니다.

반환값
int — string가 등가의 경우, 값 0 이 됩니다. 그 이외의 경우, 원의 string가 string 인수보다 앞에 오는 경우는 부의 정수, string 인수가 원의 string보다 앞에 오는 경우는 정의 정수가 됩니다. 어느 쪽의 경우도, 수치의 절대치는 2 개의 string의 차이를 나타냅니다.
match()Methods 
AS3 function match(pattern:* ):Array

지정된 pattern 를 string와 조합합니다.

Parameters
pattern:* — 조합하는 패턴입니다. 패턴에는 임의의 형태의 object를 지정할 수 있습니다만, 일반적으로 string 또는 정규 표현을 사용합니다. pattern 가 정규 표현도 string도 아닌 경우, Methods는 실행하기 전에 이것을 string로 변환합니다.

반환값
Array — 지정된 pattern 와 일치하는 string내의 모든 substring로 구성되는 string의 배열입니다.

pattern 가 정규 표현의 경우, 일치하는 substring를 복수 포함한 배열을 돌려주기 위해서(때문에),g (글로벌) 플래그를 정규 표현으로 설정할 필요가 있습니다.

  • g (글로벌) 플래그를 설정하지 않는경우, 돌려주어지는 배열에 포함되는 일치하는 substring는 1 개만되어, 정규 표현의 lastIndex property는 변경되지 않습니다.
  • g (글로벌) 플래그를 설정했을경우, Methods는 string의 선두 (인덱스 위치 0)로부터 검색을 개시합니다. /x*/ 등의 정규 표현을 사용했을 경우는, 일치하는 substring가 empty의 string인 일이 있습니다. 그 경우, Methods는 그 empty의 string를 일치하는 substring의 배열에 추가해, 다음의 인덱스 위치로부터 검색을 속행합니다. Methods가 완료하면, 정규 표현의 lastIndex property는 0 으로 설정됩니다.

일치하는 substring가 발견되지 않았던 경우, Methods는 null 를 돌려줍니다. pattern Parameters의 값을 건네주지 않았던 경우, 또는 미정의치를 건네주었을 경우, Methods는 null 를 돌려줍니다.

See also

replace()Methods 
AS3 function replace(pattern:* , repl:Object ):String

지정된 pattern 를 string와 조합해, 새로운 string를 돌려줍니다. 이 새로운 string에서는,pattern 와 최초로 일치한 부분이 repl 로 지정된 내용으로 옮겨집니다. pattern Parameters에는, string 또는 정규 표현을 지정할 수 있습니다. repl Parameters에는, string 또는 함수를 지정할 수 있습니다. 함수를 지정했을 경우, 일치한 부분이, 함수에 의해 돌려주어지는 string로 옮겨집니다. 원의 string는 변경되지 않습니다.

다음의 예에서는,"sh" (대문자와 소문자는 구별)의 최초의 인스턴스만이 옮겨놓을 수 있습니다.

 var myPattern:RegExp = /sh/;  
 var str:String = "She sells seashells by the seashore. ";
 trace(str.replace(myPattern, "sch"));  
    // She sells seaschells by the seashore. 

다음의 예에서는,g (글로벌) 플래그가 정규 표현으로 설정되어 있으므로,"sh" (대문자와 소문자는 구별)의 모든 인스턴스를 옮겨놓을 수 있습니다.

 var myPattern:RegExp = /sh/g;  
 var str:String = "She sells seashells by the seashore. ";
 trace(str.replace(myPattern, "sch"));  
    // She sells seaschells by the seaschore. 

다음의 예에서는,g (글로벌) 플래그가 정규 표현으로 설정되어 있으므로,"sh" 의 모든 인스턴스를 옮겨놓을 수 있습니다. 또,i (ignoreCase) 플래그가 설정되어 있기 (위해)때문에, 일치는 대문자와 소문자를 구별 하지 않습니다.

 var myPattern:RegExp = /sh/gi;  
 var str:String = "She sells seashells by the seashore. ";
 trace(str.replace(myPattern, "sch"));  
    // sche sells seaschells by the seaschore. 
Parameters
pattern:* — 조합하는 패턴입니다. 패턴에는 임의의 형태의 object를 지정할 수 있습니다만, 일반적으로 string 또는 정규 표현을 사용합니다. string 또는 정규 표현 이외의 object를 pattern Parameters로 지정했을 경우,toString() Methods가 Parameters에 적용되어 결과의 string를 pattern 로서 사용해 replace() Methods가 실행됩니다.
 
repl:Object — 통상은, 일치한 내용에 옮겨놓는 string입니다. 다만, 이 Parameters에 함수를 지정할 수도 있습니다. 함수를 지정했을 경우, 일치한 내용이, 함수에 의해 돌려주어지는 string로 옮겨집니다.

repl Parameters에 string를 지정해,pattern Parameters에 정규 표현을 지정했을 경우,repl string에 다음의 특수한 $ 값환 코드를 사용할 수가 있습니다.

$ 코드 치환 텍스트
$$ $
$& 패턴에 일치한 substring입니다.
$` string 가운데, 패턴에 일치한 substring보다 전의 부분입니다. 이 코드로 사용하는 기호는, 직선 모양의 왼쪽 홑겹 인용부호 (`)입니다. 수직의 홑겹 인용부호 (') 또는 구부러진 왼쪽 홑겹 인용부호 (‘)가 아닙니다.
$' string 가운데, 패턴에 일치한 substring보다 후의 부분입니다. 이 코드로 사용하는 기호는, 수직의 홑겹 인용부호 (')입니다.
$n 괄호 지정된 그룹의 n 번째의 일치입니다. n 는 1 자리수의 숫자 (1 ~ 9)이며,$n 의 뒤에 10 진수자는 계속되지 않습니다.
$nn 괄호 지정된 그룹의 nn 번째 일치입니다. nn 는 2 자리수의 10 진수자 (01 ~ 99)입니다. nn 번째의 패턴이 미정도리의 경우, 값환 텍스트는 empty의 string가 됩니다.

예를 들어, 다음의 예는, 1 번째 및 2 번째에 일치한 capther 그룹을 나타내는 $2$1 값환 코드를 사용하는 방법을 나타내고 있습니다.

var str:String = "flip-flop";
 var pattern:RegExp = /(\w+)-(\w+) /g;
 trace(str.replace(pattern, "$2-$1")); // flop-flip

repl 로서 함수를 지정했을 경우,replace() Methods는 다음의 Parameters를 함수에 건네줍니다.

  • string내의 일치하는 부분.
  • capther 된, 괄호 지정된 그룹과의 모든 일치가 다음의 인수로서 제공됩니다. 이 방법으로 건네받는 인수의 수는, 괄호내의 패턴과의 일치수에 따라서 다릅니다. 괄호내의 패턴과의 일치수는, 함수 코드내의 arguments.length - 3 을 확인해 특정할 수가 있습니다.
  • string내에서 일치 부분이 시작되는 장소의 인덱스 위치.
  • string 전체.

다음에 예를 나타냅니다.

 var str1:String = "abc12 def34";
 var pattern:RegExp = /([a-z]+)([0-9]+)/;
 var str2:String = str1.replace(pattern, replFN);
 trace (str2);   // 12abc 34def
 
 function replFN() :String {
  return arguments[2] + arguments[1];
 }

이 예에서는,repl Parameters에 함수를 사용해 replace() Methods를 호출하고 있습니다. 정규 표현 (/([a-z]([0-9]/g)는 2 회 일치하고 있습니다. 1 번째는, 패턴이 substring "abc12" 에 일치해, 다음의 인수의 리스트가 함수에게 건네집니다.

 {"abc12", "abc", "12", 0, "abc12 def34"}

2 번째는, 패턴이 substring "def23" 에 일치해, 다음의 인수의 리스트가 함수에게 건네집니다.

 {"def34", "def", "34", 6, "abc123 def34"}

반환값
String — 결과의 string입니다. 소스 string는 변경되고 있지 않습니다.

See also

search()Methods 
AS3 function search(pattern:* ):int

지정된 pattern 를 검색해, 최초로 일치한 substring의 인덱스를 돌려줍니다. 일치하는 substring가 없었던 경우, Methods는 -1 을 돌려줍니다.

Parameters
pattern:* — 조합하는 패턴입니다. 패턴에는 임의의 형태의 object를 지정할 수 있습니다만, 일반적으로 string 또는 정규 표현을 사용합니다. pattern 가 정규 표현도 string도 아닌 경우, Methods는 실행하기 전에 이것을 string로 변환합니다. 정규 표현을 지정했을 경우, Methods는 정규 표현의 글로벌 플래그 ("g")를 무시해, 또 정규 표현의 lastIndex property를 무시해, 원인 채 유지합니다. 미정도리의 값을 건네주었을 경우, 또는 값을 건네주지 않았던 경우, Methods는 -1 을 돌려줍니다.

반환값
int — 최초로 일치한 substring의 인덱스, 또는 일치하는 substring가 없는 경우는 -1 입니다. string의 인덱스는 제로로부터 시작되어, string의 선두의 캐릭터는 인덱스 0, 마지막 캐릭터는 string.length - 1 입니다.

See also

slice()Methods 
AS3 function slice(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String

돌려주어지는 string에는,startIndex 캐릭터로부터 endIndex 캐릭터의 전까지의 모든 캐릭터가 포함됩니다. 원의 String object는 변경되지 않습니다. endIndex Parameters를 지정하지 않으면 substring의 마지막은 string의 마지막입니다. startIndex 로 지정된 인덱스 캐릭터가,endIndex 로 지정된 인덱스 캐릭터와 같은가, 그 우측에 있는 경우, Methods는 empty의 string를 돌려줍니다.

Parameters
startIndex:Number (default = 0) — 슬라이스의 시점의 제로로부터 시작되는 인덱스입니다. startIndex 가 부의 수치의 경우, 슬라이스는 오른쪽에서 왼쪽으로 작성됩니다. 이 때,-1 가 마지막 캐릭터입니다.
 
endIndex:Number (default = 0x7fffffff) — 슬라이스의 종점의 인덱스보다 1 큰 정수치입니다. endIndex Parameters로 지정된 인덱스 위치의 캐릭터는, 추출되는 string에는 포함되지 않습니다. endIndex 가 부의 수치의 경우, 종점은 string의 마지막으로부터 카운트 되어 결정됩니다. 이 때,-1 가 마지막 캐릭터가 됩니다. 디폴트는, 인덱스에 허가되고 있는 최대치입니다. 이 Parameters를 생략 하면,String.length 가 사용됩니다.

반환값
String — 지정된 인덱스에 근거하는 substring입니다.

See also

split()Methods 
AS3 function split(delimiter:* , limit:Number = 0x7fffffff):Array

지정된 delimiter Parameters가 있는 여러분치로 String object를 substring의 배열에 분할합니다.

delimiter Parameters가 정규 표현의 경우, string내의 특정의 위치에서 발견된 최초의 일치만이 고려됩니다. 백 트랙킹에 의해, 같은 위치에서 empty이 아닌 substring의 일치가 발견되었다고 해도, 그것은 고려되지 않습니다. 다음에 예를 나타냅니다.

  var str:String = "ab";
  var results:Array = str.split(/a*? /); // results == ["","b"]
  
  results = str.split(/a*/); // results == ["","b"]. )

delimiter Parameters가 그룹화 괄호를 포함한 정규 표현의 경우,delimiter 가 일치할 때마다, 미정도리 결과를 포함한 그룹화 괄호의 결과가 출력 배열에 스프라이스 됩니다. 다음에 예를 나타냅니다.

  var str:String = "Thi5 is a tricky-66 example. ";
  var re:RegExp = /(\d+)/;
  var results:Array = str.split(re);
      // results == ["Thi","5"," is a tricky-","66"," example. "]

limit Parameters를 지정했을 경우, 배열에는 지정된 수를 넘는 엘리먼트는 돌려주어지지 않습니다.

delimiter 가 empty의 string, empty의 정규 표현, 또는 empty의 string도 일치로 여겨지는 정규 표현의 경우, string내의 각각의 1 캐릭터가 배열내의 엘리먼트로서 출력됩니다.

delimiter Parameters가 미정도리의 경우는, string 전체가 돌려주어지는 배열의 최초의 엘리먼트에 삽입됩니다.

Parameters
delimiter:* — 이 string를 분할하는 장소를 나타내는 패턴입니다. 패턴에는 임의의 형태의 object를 지정할 수 있습니다만, 일반적으로 string 또는 정규 표현을 사용합니다. delimiter 가 정규 표현도 string도 아닌 경우, Methods는 실행하기 전에 이것을 string로 변환합니다.
 
limit:Number (default = 0x7fffffff) — 배열에 삽입하는 아이템의 최대수입니다. 디폴트는, 허가되고 있는 최대치입니다.

반환값
Array — substring의 배열입니다.

See also

substr()Methods 
AS3 function substr(startIndex:Number = 0, len:Number = 0x7fffffff):String

지정되었다 startIndex 로 개시하는 캐릭터로 구성되어len 로 지정된 길이를 가지는 substring를 돌려줍니다. 원의 string는 변경되지 않습니다.

Parameters
startIndex:Number (default = 0) — substring의 작성에 사용하는 선두 캐릭터의 인덱스를 나타내는 정수입니다. startIndex 가 부의 수치의 경우, 시점은 string의 마지막으로부터 결정됩니다. 이 때,-1 가 마지막 캐릭터가 됩니다.
 
len:Number (default = 0x7fffffff) — 작성하는 substring의 캐릭터수입니다. 디폴트치는, 허가되고 있는 최대치입니다. len 를 지정하지 않으면 substring에는 startIndex 로부터 마지막까지의 모든 캐릭터가 포함됩니다.

반환값
String — 지정된 Parameters에 근거하는 substring입니다.

See also

substring()Methods 
AS3 function substring(startIndex:Number = 0, endIndex:Number = 0x7fffffff):String

startIndex 로 지정된 캐릭터로부터 endIndex - 1 까지의 모든 캐릭터로 구성되는 string를 돌려줍니다. endIndex 가 지정되어 있지 않은 경우,String.length 가 사용됩니다. startIndex 의 값이 endIndex 의 값과 동일한 경우, empty의 string가 돌려주어집니다. startIndex 의 값이 endIndex 의 값보다 큰 경우, 함수를 실행하기 전에 Parameters가 자동적으로 바뀝니다. 원의 string는 변경되지 않습니다.

Parameters
startIndex:Number (default = 0) — substring의 작성에 사용하는 선두 캐릭터의 인덱스를 나타내는 정수입니다. startIndex 로 지정할 수 있는 값은,0 ~ String.length 입니다. startIndex 가 부의 값의 경우,0 하지만 사용됩니다.
 
endIndex:Number (default = 0x7fffffff) — 추출하는 substring의 마지막 캐릭터의 인덱스에 1 을 더한 정수입니다. endIndex 로 지정할 수 있는 값은,0 ~ String.length 입니다. endIndex 에 있는 캐릭터는 substring에 포함되지 않습니다. 디폴트는, 인덱스에 허가되고 있는 최대치입니다. 이 Parameters를 생략 하면,String.length 가 사용됩니다. 이 Parameters가 부의 값인 경우는,0 이 사용됩니다.

반환값
String — 지정된 Parameters에 근거하는 substring입니다.

See also

toLocaleLowerCase()Methods 
AS3 function toLocaleLowerCase():String

이 string의 복사를 돌려줍니다. 모든 대문자가 소문자에 변환됩니다. 원의 string는 변경되지 않습니다. 이 Methods는 로케일에 특화한 방법으로 변환을 처리하는 것을 목적으로 하고 있습니다만, ActionScript 3.0 Implements에서는,toLowerCase() 와 다른 결과를 생성하지 않습니다.

반환값
String — 이 string의 복사입니다. 모든 대문자가 소문자에 변환됩니다.

See also

toLocaleUpperCase()Methods 
AS3 function toLocaleUpperCase():String

이 string의 복사를 돌려줍니다. 모든 소문자가 대문자에 변환됩니다. 원의 string는 변경되지 않습니다. 이 Methods는 로케일에 특화한 방법으로 변환을 처리하는 것을 목적으로 하고 있습니다만, ActionScript 3.0 Implements에서는,toUpperCase() 와 다른 결과를 생성하지 않습니다.

반환값
String — 이 string의 복사입니다. 모든 소문자가 대문자에 변환됩니다.

See also

toLowerCase()Methods 
AS3 function toLowerCase():String

이 string의 복사를 돌려줍니다. 모든 대문자가 소문자에 변환됩니다. 원의 string는 변경되지 않습니다.

이 Methods는, 대응하는 Unicode 의 소문자가 존재하는 모든 캐릭터 (단지 A ~ Z 는 아니다)를 변환합니다.

  var str:String = " JOSÉ BARÇA";
  trace(str.toLowerCase()); // josé barça

이러한 대문자와 소문자의 매핑은,Unicode Character Database 로 정의되고 있는 대로,UnicodeData.txt 파일과 SpecialCasings.txt 파일로 정의되고 있습니다.

반환값
String — 이 string의 복사입니다. 모든 대문자가 소문자에 변환됩니다.

See also

toUpperCase()Methods 
AS3 function toUpperCase():String

이 string의 복사를 돌려줍니다. 모든 소문자가 대문자에 변환됩니다. 원의 string는 변경되지 않습니다.

이 Methods는, 대응하는 Unicode 의 대문자가 존재하는 모든 캐릭터 (단지 a ~ z 는 아니다)를 변환합니다.

  var str:String = "José Barça";
  trace(str.toUpperCase()); // JOSÉ BARÇA

이러한 대문자와 소문자의 매핑은,Unicode Character Database 로 정의되고 있는 대로,UnicodeData.txt 파일과 SpecialCasings.txt 파일로 정의되고 있습니다.

반환값
String — 이 string의 복사입니다. 모든 소문자가 대문자에 변환됩니다.

See also

valueOf()Methods 
AS3 function valueOf():String

String 인스턴스의 원시적치를 돌려줍니다. 이 Methods는, String object를 원시적인 string치로 변환하도록(듯이) 설계되고 있습니다. Flash Player 는 필요시에 자동적으로 valueOf() 를 호출하게 되어 있기 (위해)때문에, 이 Methods를 명시적으로 호출하는 것이 필요한 것은 거의 없습니다.

반환값
String — string의 값입니다.
Examples

다음의 예에서는, StringExample 및 StringHelper 클래스를 사용해, String 클래스의 다양한 Methods의 사용법을 나타냅니다. 이것을 실시하려면 , 이하의 순서를 실행합니다.
  1. StringExample 의 constructor    은, 몇개의 로컬의 String 인스턴스를 선언합니다. 이러한 인스턴스는 다양한 string와 새로운 StringHelper object에 의해 초기화됩니다.
  2. StringHelper 클래스에는 다음의 Methods가 있습니다.
    • replace(): String 의 split() Methods와 join() Methods를 호출해, 새로운 string에게 건네지는 string의 substring를 삭제합니다.
    • trim(): 건네받은 string를 사용해 trimBack()trimFront() 의 양쪽 모두를 호출해, 갱신된 string를 돌려줍니다.
    • trimFront(): string의 최후로부터 개시해 선두로 향해, string의 말미의 캐릭터가 char Parameters에 일치하지 않게 될 때까지, char Parameters에 일치하는 모든 캐릭터를 재귀적으로 삭제해, 갱신된 string를 돌려줍니다.
    • trimBack(): string의 최후로부터 개시해 선두로 향해, string의 말미의 캐릭터가 char Parameters에 일치하지 않게 될 때까지, char Parameters에 일치하는 모든 캐릭터를 재귀적으로 삭제해, 갱신된 string를 돌려줍니다.
    • stringToCharacter(): 건네받은 string의 선두 캐릭터를 돌려줍니다.
  3. 선언되고 있는 string 변수를 사용해, 2 번째의 string의 작성에 replace() Methods, 3 번째의 string의 작성에 trim() Methods를 호출해, 3 개의 string를 작성합니다.
package {
    import flash.display.Sprite;

    public class StringExample extends Sprite {
        public function StringExample() {
            var companyStr:String = new String("     Company X");
            var productStr:String = "Product Z Basic     ";
            var emptyStr:String = " ";
            var strHelper:StringHelper = new StringHelper();

            var companyProductStr:String = companyStr + emptyStr + productStr;
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Basic     '

            companyProductStr = strHelper.replace(companyProductStr, "Basic", "Professional");
            trace("'" + companyProductStr + "'");    // '     Company X Product Z Professional     '

            companyProductStr = strHelper.trim(companyProductStr, emptyStr);
            trace("'" + companyProductStr + "'");    // 'Company X Product Z Professional'
        }
    }
}

class StringHelper {
    public function StringHelper() {
    }

    public function replace(str:String, oldSubStr:String, newSubStr:String) :String {
        return str.split(oldSubStr). join(newSubStr);
    }

    public function trim(str:String, char:String) :String {
        return trimBack(trimFront(str, char), char);
    }

    public function trimFront(str:String, char:String) :String {
        char = stringToCharacter(char);
        if (str.charAt(0) == char) {
            str = trimFront(str.substring(1), char);
        }
        return str;
    }

    public function trimBack(str:String, char:String) :String {
        char = stringToCharacter(char);
        if (str.charAt(str.length - 1) == char) {
            str = trimBack(str.substring(0, str.length - 1), char);
        }
        return str;
    }

    public function stringToCharacter(str:String) :String {
        if (str.length == 1) {
            return str;
        }
        return str.slice(0, 1);
    }
}






 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/String.html