Vector  - AS3

Vector의 length 속성을 변경할 수 있는지 여부를 나타냅니다. 값이 true이면 length 속성을 변경할 수 없습니다. 즉, fixed가 true이면 다음 작업을 수행할 수 없습니다.

• length 속성을 직접 설정
• 인덱스 위치 length에 값 할당
• length 속성을 변경하는 다음과 같은 메서드 호출
  • pop()
  • push()
  • shift()
  • unshift()
  • splice()(splice() 호출로 인해 Vector의 length가 변경되는 경우)

Vector에서 사용할 수 있는 유효한 인덱스의 범위입니다. Vector 인스턴스에는 length 값 바로 전까지의 인덱스 위치가 있습니다.

모든 Vector 요소의 값은 항상 기본 유형의 인스턴스이거나 null입니다. length 속성을 이전 값보다 큰 값으로 설정하면 요소가 추가로 만들어지고 기본 유형에 맞는 기본값(참조 유형의 경우 null)으로 채워집니다.

length 속성을 이전 값보다 작은 값으로 설정하면 새 length 값보다 크거나 같은 인덱스 위치의 모든 요소가 Vector에서 제거됩니다.

지정된 기본 유형으로 Vector를 만듭니다.

Vector.<T>() 생성자를 호출할 때 유형 매개 변수 구문을 사용하여 기본 유형을 지정합니다. Type 매개 변수 구문은 다음 예제와 같이 마침표(.), 여는 각괄호(<), 클래스 이름, 닫는 각괄호(>) 순서로 구성됩니다.

     var v:Vector.<String> = new Vector.<String>();
     

Array 또는 다른 Vector(예: 기본 유형이 다른 Vector)를 사용하여 Vector 인스턴스를 만들려면 Vector() 전역 함수를 사용합니다.

미리 채워진 Vector 인스턴스를 만들려면 아래에 지정된 매개 변수를 사용하지 말고 다음 구문을 사용해야 합니다.

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

이 구문에는 다음과 같은 사항이 적용됩니다.

• Flash Professional CS5 이상, Flash Builder 4 이상 및 Flex 4 이상에서 이 구문을 사용할 수 있습니다.
• 끝부분의 쉼표는 선택 사항입니다.
• 배열의 항목을 비워둘 수 없습니다. 즉, var v:Vector.<int> = new <int>[0,,2,]와 같은 명령문은 컴파일러 오류를 발생시킵니다.
• Vector 인스턴스에 대해 기본 길이를 지정할 수 없습니다. 대신, 길이는 초기화 목록의 요소 수와 같습니다.
• Vector 인스턴스의 길이를 고정할 것인지 여부를 지정할 수 없습니다. 대신, fixed 속성을 사용합니다.
• 값으로 전달된 항목이 지정된 유형과 맞지 않으면 데이터 손실 또는 오류가 발생할 수 있습니다. 예를 들면 다음과 같습니다.

     var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
     trace(v[0]); //returns 4 when not running in strict mode
     

관련 API 요소

매개 변수 목록에 지정된 Vector를 이 Vector의 요소와 연결하여 새 Vector를 만듭니다. 매개 변수 목록의 Vector는 이 Vector와 기본 유형 또는 하위 유형이 같아야 합니다. 매개 변수를 하나도 전달하지 않을 경우 반환되는 Vector는 원본 Vector의 복제본(단순 복제본)입니다.

매개 변수

지정된 함수에 대해 false를 반환하는 항목에 도달할 때까지 Vector의 각 항목에 대해 테스트 함수를 실행합니다. 이 메서드를 사용하면 Vector의 모든 항목이 특정 숫자보다 값이 작아야 한다는 등의 조건에 맞는지 확인할 수 있습니다.

이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.

그러나 Flash Professional을 사용하여 기본 타임라인의 프레임에 함수를 만들고 다른 this 컨텍스트에서 이 함수를 호출하려는 경우를 가정해 봅니다.

    function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

그런 다음 Vector에 대해 every() 메서드를 사용합니다. Vector의 이름은 myVector입니다.

    myVector.every(myFunction, someObject);
    

myFunction은 SWF 파일의 기본 클래스의 멤버이므로 다른 this 컨텍스트에서 실행할 수 없습니다. 이 코드를 실행하면 Flash 런타임에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

매개 변수

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

관련 API 요소

Vector의 각 항목에 대해 테스트 함수를 실행하고 지정된 함수에 대해 true를 반환하는 모든 항목이 포함된 새 Vector를 반환합니다. false를 반환하는 항목은 결과 Vector에 포함되지 않습니다. 반환되는 Vector의 기본 유형은 메서드가 호출된 Vector의 기본 유형과 일치합니다.

이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.

그러나 Flash Professional을 사용하여 기본 타임라인의 프레임에 함수를 만들고 다른 this 컨텍스트에서 이 함수를 호출하려는 경우를 가정해 봅니다.

     function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

그런 다음 Vector에 대해 filter() 메서드를 사용합니다. Vector의 이름은 myVector입니다.

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

myFunction은 SWF 파일의 기본 클래스의 멤버이므로 다른 this 컨텍스트에서 실행할 수 없습니다. 이 코드를 실행하면 Flash 런타임에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

매개 변수

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

관련 API 요소

Vector의 각 항목에 대해 함수를 실행합니다.

이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.

그러나 Flash Professional을 사용하여 기본 타임라인의 프레임에 함수를 만들고 다른 this 컨텍스트에서 이 함수를 호출하려는 경우를 가정해 봅니다.

     function myFunction(item:T, index:int, vector:Vector.<T>):void {
        // your code here
     }
     

그런 다음 Vector에 대해 forEach() 메서드를 사용합니다. Vector의 이름은 myVector입니다.

     myVector.forEach(myFunction, someObject);
     

myFunction은 SWF 파일의 기본 클래스의 멤버이므로 다른 this 컨텍스트에서 실행할 수 없습니다. 이 코드를 실행하면 Flash 런타임에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

매개 변수

function callback(item:T, index:int, vector:Vector.<T>):void;

Vector의 항목을 검색하고 항목의 인덱스 위치를 반환합니다. 항목은 strict equality(===)를 사용하여 Vector 요소와 비교됩니다.

매개 변수

관련 API 요소

Vector에 단일 요소를 삽입합니다. 이 메서드는 복사본을 만들지 않고 Vector를 수정합니다.

매개 변수

Vector의 요소를 문자열로 변환하고, 지정된 분리 기호를 요소 사이에 삽입하고, 요소를 서로 연결한 후 결과 문자열을 반환합니다. 중첩 Vector는 항상 join() 메서드에 전달된 분리 기호가 아닌 쉼표(,)로 구분됩니다.

매개 변수

관련 API 요소

Vector의 지정된 인덱스 위치부터 역순으로 항목을 검색하고 일치하는 항목의 인덱스 위치를 반환합니다. 항목은 strict equality(===)를 사용하여 Vector 요소와 비교됩니다.

매개 변수

관련 API 요소

Vector의 각 항목에 대해 함수를 실행하고 이 Vector의 각 항목에 대한 함수 호출의 결과에 해당하는 항목으로 구성된 새 Vector를 반환합니다. 결과 Vector는 원래 Vector와 기본 유형 및 length가 동일합니다. 결과 Vector에서 인덱스 i에 있는 요소는 원래 Vector에서 인덱스 i에 있는 요소에 대해 함수를 호출한 결과입니다.

이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.

그러나 Flash Professional을 사용하여 기본 타임라인의 프레임에 함수를 만들고 다른 this 컨텍스트에서 이 함수를 호출하려는 경우를 가정해 봅니다.

     function myFunction(item:Object, index:int, vector:Vector.<T>):T {
        // your code here
     }
     

그런 다음 Vector에 대해 map() 메서드를 사용합니다. Vector의 이름은 myVector입니다.

     myVector.map(myFunction, someObject);
     

myFunction은 SWF 파일의 기본 클래스의 멤버이므로 다른 this 컨텍스트에서 실행할 수 없습니다. 이 코드를 실행하면 Flash 런타임에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

매개 변수

function callback(item:T, index:int, vector:Vector.<T>):T;

관련 API 요소

Vector에서 마지막 요소를 제거하고 해당 요소를 반환합니다. 이 함수를 호출하면 Vector의 length 속성이 1만큼 감소합니다.

관련 API 요소

Vector 끝에 하나 이상의 요소를 추가하고 Vector의 새 길이를 반환합니다.

이 함수는 여러 인수를 받을 수 있으므로 엄격 모드에서도 컴파일 타임에 인수의 데이터 유형이 검사되지 않습니다. 그러나 기본 유형의 인스턴스가 아닌 인수를 전달하면 런타임에 예외가 발생합니다.

매개 변수

관련 API 요소

Vector에서 단일 요소를 제거합니다. 이 메서드는 복사본을 만들지 않고 Vector를 수정합니다.

매개 변수

Vector에서 요소의 순서를 뒤집습니다. 이 메서드는 호출된 Vector를 변경합니다.

Vector에서 첫 번째 요소를 제거하고 해당 요소를 반환합니다. Vector의 나머지 요소는 원래 위치 i에서 i - 1로 이동합니다.

관련 API 요소

원본 Vector에서 특정 범위에 있는 요소로 구성된 새 Vector를 반환하며 원본 Vector를 수정하지 않습니다. 반환되는 Vector에는 startIndex 요소부터 endIndex 요소 바로 앞까지의 모든 요소가 포함됩니다.

매개 변수를 전달하지 않으면 원본 Vector를 복제한 새 Vector(단순 복제본)가 만들어집니다. 두 매개 변수에 대해 모두 값 0을 전달하면 원본 Vector와 같은 유형의 빈 Vector가 새로 만들어집니다.

매개 변수

true를 반환하는 항목에 도달할 때까지 Vector의 각 항목에 대해 테스트 함수를 실행합니다. 이 메서드를 사용하면 특정 숫자보다 값이 작아야 한다는 등의 조건에 맞는 항목이 Vector에 하나라도 있는지 확인할 수 있습니다.

이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.

그러나 기본 타임라인의 프레임에 함수를 만들고 다른 this 컨텍스트에서 이 함수를 호출하려는 경우를 가정해 봅니다.

     function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

그런 다음 Vector에 대해 some() 메서드를 사용합니다. Vector의 이름은 myVector입니다.

     myVector.some(myFunction, someObject);
     

myFunction은 SWF 파일의 기본 클래스의 멤버이므로 다른 this 컨텍스트에서 실행할 수 없습니다. 이 코드를 실행하면 Flash 런타임에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

매개 변수

function callback(item:T, index:int, vector:Vector.<T>):Boolean

관련 API 요소

Vector 객체에서 요소를 정렬하고 정렬된 Vector 객체를 반환하기도 합니다. 이 메서드는 두 값을 비교하는 함수이거나 정렬 옵션 집합인 sortBehavior 매개 변수에 따라 정렬합니다.

이 메서드에는 하나의 매개 변수가 사용됩니다. 이 매개 변수는 다음 중 하나입니다.

• 기본 유형(T) Vector의 두 인수를 사용하며 숫자를 반환하는 함수:

  function compare(x:T, y:T):Number {}

  함수의 논리는 두 요소인 x와 y를 사용하여 다음 세 가지 값 중 하나를 반환하는 것입니다.

  • 음수(정렬된 시퀀스에서 x가 y보다 앞에 나와야 하는 경우)
  • 0(x가 y와 같은 경우)
  • 양수(정렬된 시퀀스에서 x가 y보다 뒤에 나와야 하는 경우)

• 다음 값의 bitwise OR인 숫자:
  • 1 또는 Array.CASEINSENSITIVE
  • 2 또는 Array.DESCENDING
  • 4 또는 Array.UNIQUESORT
  • 8 또는 Array.RETURNINDEXEDARRAY
  • 16 또는 Array.NUMERIC

  값이 0인 경우 정렬은 다음 방법으로 작동합니다.

  • 정렬은 대/소문자를 구분합니다. 즉, Z가 a 앞에 옵니다.
  • 정렬은 오름차순입니다. 즉, a가 b 앞에 옵니다.
  • 정렬 순서에 따라 배열이 수정됩니다. 정렬 필드가 동일한 여러 요소는 정렬된 배열에 특정 순서 없이 연속적으로 배치됩니다.
  • 모든 요소는 데이터 유형에 관계없이 문자열로 취급되어 정렬됩니다. 따라서 "1"의 문자열 값이 "9"의 문자열 값보다 낮으므로 100이 99 앞에 옵니다.

매개 변수

관련 API 요소

Vector에 요소를 추가하고 Vector에서 요소를 제거합니다. 이 메서드는 복사본을 만들지 않고 Vector를 수정합니다.

참고: Vector의 하위 클래스에서 이 메서드를 재정의하려면 다음 예제와 같이 매개 변수로 ...args를 사용합니다.

     public override function splice(...args) {
       // your statements here
     }
     

매개 변수

지정된 Vector의 요소를 나타내는 문자열을 반환합니다. 인덱스 0에서 시작하여 최대 인덱스로 끝나는 Vector에 포함된 모든 요소가 연결된 문자열로 변환되고 쉼표로 구분됩니다. ActionScript 3.0 구현에서 이 메서드의 반환 값은 Vector.toString() 메서드와 같습니다.

관련 API 요소

Vector의 요소를 나타내는 문자열을 반환합니다. 인덱스 0에서 시작하여 최대 인덱스로 끝나는 Vector에 포함된 모든 요소가 연결된 문자열로 변환되고 쉼표로 구분됩니다. 사용자 정의 분리 기호를 지정하려면 Vector.join() 메서드를 사용합니다.

관련 API 요소

Vector 시작 부분에 하나 이상의 요소를 추가하고 Vector의 새 길이를 반환합니다. Vector의 다른 요소는 원래 위치 i에서 i + 새 요소 수로 이동합니다.

이 함수는 여러 인수를 받을 수 있으므로 엄격 모드에서도 컴파일 타임에 인수의 데이터 유형이 검사되지 않습니다. 그러나 기본 유형의 인스턴스가 아닌 인수를 전달하면 런타임에 예외가 발생합니다.

매개 변수

관련 API 요소