| 패키지 | 최상위 |
| 클래스 | public dynamic class Vector |
| 상속 | Vector Object |
| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Array와 마찬가지로 배열 액세스([]) 연산자를 사용하여 Vector 요소의 값을 설정하거나 검색할 수 있습니다. 또한 몇 가지 Vector 메서드를 통해 요소 값을 설정 및 검색하는 메커니즘이 제공됩니다. 이러한 메서드로는 push(), pop(), shift(), unshift() 등이 있습니다. Vector 객체의 속성 및 메서드는 Array의 속성 및 메서드와 비슷하며 대부분의 경우 동일합니다. 사용하는 Array의 모든 요소가 같은 데이터 유형인 경우 항상 Vector 인스턴스를 사용하는 것이 좋습니다.
Vector의 기본 유형은 접미사 유형 매개 변수 구문을 사용하여 지정됩니다. 유형 매개 변수 구문은 다음 예제와 같이 마침표(.), 여는 각괄호(<), 클래스 이름, 닫는 각괄호(>) 순서로 구성됩니다.
var v:Vector.<String>; v = new Vector.<String>();
예제의 첫 번째 행에서는 변수 v를 Vector.<String> 인스턴스로 선언합니다. 즉, 이 변수는 String 인스턴스만 포함할 수 있으며 String 인스턴스만 검색할 수 있는 Vector(배열)를 나타냅니다. 두 번째 행에서는 동일한 Vector 유형(요소가 모두 String 객체인 Vector)의 인스턴스를 생성하여 v에 할당합니다.
Vector.<T> 데이터 유형으로 선언된 변수에는 같은 기본 유형 T로 생성된 Vector 인스턴스만 저장할 수 있습니다. 예를 들어 new Vector.<String>()을 호출하여 생성된 Vector를 Vector.<int> 데이터 유형으로 선언된 변수에 할당할 수는 없습니다. 기본 유형은 정확히 일치해야 합니다. 예를 들어 다음 코드에서는 객체의 기본 유형이 변수의 선언된 기본 유형과 다르므로 코드가 컴파일되지 않습니다. Sprite가 DisplayObject의 하위 클래스이지만 결과는 마찬가지입니다.
// This code doesn't compile even though Sprite is a DisplayObject subclass var v:Vector.<DisplayObject> = new Vector.<Sprite>();
기본 유형이 T인 Vector를 T의 수퍼 클래스의 Vector로 변환하려면 Vector() 전역 함수를 사용합니다.
Vector 클래스에는 데이터 유형 제한뿐만 아니라 Array 클래스의 경우와 다른 몇 가지 제한이 더 있습니다.
null이 있어야 합니다.
length - 1)보다 큰 인덱스에서는 값을 읽을 수 없습니다. 현재 마지막 인덱스를 벗어난 인덱스에는 값을 설정할 수 없습니다. 즉, 기존 인덱스나 [length] 인덱스에만 값을 설정할 수 있습니다.
이러한 제한 사항으로 인해 Vector에는 모든 요소가 단일 클래스의 인스턴스인 Array 인스턴스보다 두 가지 우수한 점이 있습니다.
push() 메서드나 unshift() 메서드를 사용하여 Vector에 값을 추가할 때는 인수의 데이터 유형이 컴파일 타임이 아닌 런타임에 검사됩니다.
참고 사항
| 속성 | 다음에 의해 정의됨 | ||
|---|---|---|---|
![]() | constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | |
| fixed : Boolean Vector의 length 속성을 변경할 수 있는지 여부를 나타냅니다. | Vector | ||
| length : uint Vector에서 사용할 수 있는 유효한 인덱스의 범위입니다. | Vector | ||
![]() | prototype : Object [정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다. | Object | |
| 메서드 | 다음에 의해 정의됨 | ||
|---|---|---|---|
지정된 기본 유형으로 Vector를 만듭니다. | Vector | ||
매개 변수에 지정된 요소를 Vector의 요소와 연결하여 새 Vector를 만듭니다. | Vector | ||
지정된 함수에 대해 false를 반환하는 항목에 도달할 때까지 Vector의 각 항목에 대해 테스트 함수를 실행합니다. | Vector | ||
Vector의 각 항목에 대해 테스트 함수를 실행하고 지정된 함수에 대해 true를 반환하는 모든 항목이 포함된 새 Vector를 반환합니다. | Vector | ||
Vector의 각 항목에 대해 함수를 실행합니다. | Vector | ||
![]() | 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | |
Vector의 항목을 검색하고 항목의 인덱스 위치를 반환합니다. | Vector | ||
![]() | Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | |
Vector의 요소를 문자열로 변환하고, 지정된 분리 기호를 요소 사이에 삽입하고, 요소를 서로 연결한 후 결과 문자열을 반환합니다. | Vector | ||
Vector의 지정된 인덱스 위치부터 역순으로 항목을 검색하고 일치하는 항목의 인덱스 위치를 반환합니다. | Vector | ||
Vector의 각 항목에 대해 함수를 실행하고 이 Vector의 각 항목에 대한 함수 호출의 결과에 해당하는 항목으로 구성된 새 Vector를 반환합니다. | Vector | ||
pop():T Vector에서 마지막 요소를 제거하고 해당 요소를 반환합니다. | Vector | ||
![]() | 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | |
Vector 끝에 하나 이상의 요소를 추가하고 Vector의 새 길이를 반환합니다. | Vector | ||
Vector에서 요소의 순서를 뒤집습니다. | Vector | ||
![]() | 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | |
shift():T Vector에서 첫 번째 요소를 제거하고 해당 요소를 반환합니다. | Vector | ||
원본 Vector에서 특정 범위에 있는 요소로 구성된 새 Vector를 반환하며 원본 Vector를 수정하지 않습니다. | Vector | ||
true를 반환하는 항목에 도달할 때까지 Vector의 각 항목에 대해 테스트 함수를 실행합니다. | Vector | ||
Vector의 요소를 정렬합니다. | Vector | ||
Vector에 요소를 추가하고 Vector에서 요소를 제거합니다. | Vector | ||
지정된 Vector의 요소를 나타내는 문자열을 반환합니다. | Vector | ||
Vector의 요소를 나타내는 문자열을 반환합니다. | Vector | ||
Vector 시작 부분에 하나 이상의 요소를 추가하고 Vector의 새 길이를 반환합니다. | Vector | ||
![]() | 지정된 객체의 프리미티브 값을 반환합니다. | Object | |
| fixed | 속성 |
fixed:Boolean [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 length 속성을 변경할 수 있는지 여부를 나타냅니다. 값이 false이면 length 속성을 변경할 수 없습니다. 즉, fixed가 true이면 다음 작업을 수행할 수 없습니다.
length 속성을 직접 설정
length에 값 할당
length 속성을 변경하는 다음과 같은 메서드 호출
pop()
push()
shift()
unshift()
splice()(splice() 호출로 인해 Vector의 length가 변경되는 경우)
public function get fixed():Boolean public function set fixed(value:Boolean):void| length | 속성 |
length:uint [읽기/쓰기] | 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector에서 사용할 수 있는 유효한 인덱스의 범위입니다. Vector 인스턴스에는 length 값 바로 전까지의 인덱스 위치가 있습니다.
모든 Vector 요소의 값은 항상 기본 유형의 인스턴스이거나 null입니다. length 속성을 이전 값보다 큰 값으로 설정하면 요소가 추가로 만들어지고 기본 유형에 맞는 기본값(참조 유형의 경우 null)으로 채워집니다.
length 속성을 이전 값보다 작은 값으로 설정하면 새 length 값보다 크거나 같은 인덱스 위치의 모든 요소가 Vector에서 제거됩니다.
public function get length():uint public function set length(value:uint):voidRangeError —
fixed가 true일 때 이 속성을 변경한 경우입니다.
| |
RangeError —
이 속성이 허용되는 최대 인덱스(232)보다 큰 값으로 설정된 경우입니다.
|
| Vector | () | 생성자 |
public function Vector(length:uint = 0, fixed:Boolean = false)| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
지정된 기본 유형으로 Vector를 만듭니다.
Vector.<T>() 생성자를 호출할 때 유형 매개 변수 구문을 사용하여 기본 유형을 지정합니다. 유형 매개 변수 구문은 다음 예제와 같이 마침표(.), 여는 각괄호(<), 클래스 이름, 닫는 각괄호(>) 순서로 구성됩니다.
var v:Vector.<String> = new Vector.<String>();
Array 클래스와 달리 Vector.<T>() 생성자를 사용하여 미리 채워진 Vector 인스턴스를 만들 수는 없습니다. Array 또는 다른 Vector(예: 기본 유형이 다른 Vector)를 사용하여 Vector 인스턴스를 만들려면 Vector() 전역 함수를 사용합니다.
length:uint (default = 0) —
Vector의 초기 길이(요소 수)입니다. 이 매개 변수가 0보다 크면 지정된 수의 Vector 요소가 만들어지고 기본 유형에 맞는 기본값(참조 유형의 경우 null)으로 채워집니다.
| |
fixed:Boolean (default = false) —
Vector의 길이가 고정되었는지(true) 아니면 변경 가능한지(false) 여부입니다. fixed 속성을 사용하여 이 값을 설정할 수도 있습니다.
|
참고 사항
| concat | () | 메서드 |
AS3 function concat(... args):Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
매개 변수에 지정된 요소를 Vector의 요소와 연결하여 새 Vector를 만듭니다. 매개 변수로 Vector를 지정한 경우 해당 Vector의 요소가 연결됩니다.
hello world
매개 변수
... args — 이 Vector의 기본 유형과 같으며 새 Vector로 연결할 하나 이상의 값입니다. 값을 전달하지 않으면 원본 Vector를 복제한 새 Vector가 만들어집니다. |
Vector.<T> — 이 Vector와 기본 유형이 같으며 이 Vector의 요소와 매개 변수의 요소가 차례로 들어 있는 Vector입니다. |
TypeError — 기본 유형의 인스턴스가 아니며 기본 유형으로 변환할 수 없는 인수가 있는 경우입니다. |
| every | () | 메서드 |
AS3 function every(callback:Function, thisObject:Object = null):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
지정된 함수에 대해 false를 반환하는 항목에 도달할 때까지 Vector의 각 항목에 대해 테스트 함수를 실행합니다. 이 메서드를 사용하면 Vector의 모든 항목이 특정 숫자보다 값이 작아야 한다는 등의 조건에 맞는지 확인할 수 있습니다.
이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.
그러나 기본 타임라인의 프레임에 함수를 만들고 다른 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 Player 또는 AIR에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
//your code here
};
myVector.every(myFunction, someObject);
매개 변수
callback:Function —
Vector의 각 항목에 대해 실행할 함수입니다. 이 함수는 세 개의 인수(Vector의 현재 항목, 항목의 인덱스 및 Vector 객체)를 사용하여 호출됩니다.
function callback(item:T, index:int, vector:Vector.<T>):Boolean {
// your code here
}
콜백 함수는 부울 값을 반환해야 합니다. | |
thisObject:Object (default = null) —
콜백 함수를 호출할 때 해당 함수에서 식별자 this가 참조하는 객체입니다.
|
Boolean —
부울 값이 true이면 Vector의 모든 항목에 대해 지정된 함수를 호출하여 true가 반환된 경우이고, false이면 그렇지 않은 경우입니다.
|
참고 사항
| filter | () | 메서드 |
AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 각 항목에 대해 테스트 함수를 실행하고 지정된 함수에 대해 true를 반환하는 모든 항목이 포함된 새 Vector를 반환합니다. false를 반환하는 항목은 결과 Vector에 포함되지 않습니다. 반환되는 Vector의 기본 유형은 메서드가 호출된 Vector의 기본 유형과 일치합니다.
이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.
그러나 기본 타임라인의 프레임에 함수를 만들고 다른 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 Player에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
//your code here
};
myVector.filter(myFunction, someObject);
매개 변수
callback:Function —
Vector의 각 항목에 대해 실행할 함수입니다. 이 함수는 세 개의 인수(Vector의 현재 항목, 항목의 인덱스 및 Vector 객체)를 사용하여 호출됩니다.
function callback(item:T, index:int, vector:Vector.<T>):Boolean; | |
thisObject:Object (default = null) —
콜백 함수를 호출할 때 해당 함수에서 식별자 this가 참조하는 객체입니다.
|
Vector.<T> —
원래 Vector에서 callback 함수가 true를 반환한 모든 항목이 들어 있는 새 Vector 입니다.
|
참고 사항
| forEach | () | 메서드 |
AS3 function forEach(callback:Function, thisObject:Object = null):void| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 각 항목에 대해 함수를 실행합니다.
이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.
그러나 기본 타임라인의 프레임에 함수를 만들고 다른 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 Player에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
//your code here
};
myVector.forEach(myFunction, someObject);
매개 변수
callback:Function —
Vector의 각 항목에 대해 실행할 함수입니다. 이 함수는 세 개의 인수(Vector의 현재 항목, 항목의 인덱스 및 Vector 객체)를 사용하여 호출됩니다.
function callback(item:T, index:int, vector:Vector.<T>):void; 함수 호출의 반환 값은 모두 무시됩니다. | |
thisObject:Object (default = null) —
콜백 함수를 호출할 때 해당 함수에서 식별자 this가 참조하는 객체입니다.
|
| indexOf | () | 메서드 |
AS3 function indexOf(searchElement:T, fromIndex:int = 0):int| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 항목을 검색하고 항목의 인덱스 위치를 반환합니다. 항목은 완전 항등 연산자(===)를 사용하여 Vector 요소와 비교됩니다.
매개 변수
searchElement:T — Vector에서 찾을 항목입니다. | |
fromIndex:int (default = 0) —
Vector에서 항목 검색을 시작할 위치입니다. 이 매개 변수가 음수이면 length + fromIndex로 간주됩니다. 즉, 끝에서 -fromIndex 위치의 항목부터 Vector 끝까지 검색합니다.
|
int —
Vector에서 항목의 인덱스 위치(0부터 시작)입니다. searchElement 인수를 찾지 못한 경우 -1 값이 반환됩니다.
|
참고 사항
| join | () | 메서드 |
AS3 function join(sep:String = ","):String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 요소를 문자열로 변환하고, 지정된 분리 기호를 요소 사이에 삽입하고, 요소를 서로 연결한 후 결과 문자열을 반환합니다. 중첩 Vector는 항상 join() 메서드에 전달된 분리 기호가 아닌 쉼표(,)로 구분됩니다.
매개 변수
sep:String (default = ",") — 반환된 문자열에서 Vector 요소를 구분하는 문자 또는 문자열입니다. 이 매개 변수를 생략하면 쉼표가 기본 분리 기호로 사용됩니다. |
String — 문자열로 변환한 Vector 요소를 지정된 문자열로 구분하여 구성한 문자열입니다. |
참고 사항
| lastIndexOf | () | 메서드 |
AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 지정된 인덱스 위치부터 역순으로 항목을 검색하고 일치하는 항목의 인덱스 위치를 반환합니다. 항목은 완전 항등 연산자(===)를 사용하여 Vector 요소와 비교됩니다.
매개 변수
searchElement:T — Vector에서 찾을 항목입니다. | |
fromIndex:int (default = 0x7fffffff) —
Vector에서 항목 검색을 시작할 위치입니다. 기본값은 가능한 최대 인덱스 값입니다. 즉, Vector의 마지막 항목부터 검색을 시작합니다.
이 매개 변수가 음수이면 |
int —
Vector에서 항목의 인덱스 위치(0부터 시작)입니다. searchElement 인수를 찾지 못한 경우 -1 값이 반환됩니다.
|
참고 사항
| map | () | 메서드 |
AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 각 항목에 대해 함수를 실행하고 이 Vector의 각 항목에 대한 함수 호출의 결과에 해당하는 항목으로 구성된 새 Vector를 반환합니다. 결과 Vector는 원래 Vector와 기본 유형 및 length가 동일합니다. 결과 Vector에서 인덱스 i에 있는 요소는 원래 Vector에서 인덱스 i에 있는 요소에 대해 함수를 호출한 결과입니다.
이 메서드에서 첫 번째 매개 변수인 callback이 메서드 클로저인 경우 두 번째 매개 변수인 thisObject는 null이어야 합니다. 이는 이 메서드를 사용하는 가장 일반적인 방법입니다.
그러나 기본 타임라인의 프레임에 함수를 만들고 다른 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 Player에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
//your code here
};
myVector.map(myFunction, someObject);
매개 변수
callback:Function —
Vector의 각 항목에 대해 실행할 함수입니다. 이 함수는 세 개의 인수(Vector의 현재 항목, 항목의 인덱스 및 Vector 객체)를 사용하여 호출됩니다.
function callback(item:T, index:int, vector:Vector.<T>):T; | |
thisObject:Object (default = null) —
콜백 함수를 호출할 때 해당 함수에서 식별자 this가 참조하는 객체입니다.
|
Vector.<T> —
이 Vector의 각 항목에 대해 함수를 호출한 결과가 들어 있는 새 Vector입니다. 결과 Vector는 원래 Vector와 기본 유형 및 length가 동일합니다.
|
참고 사항
| pop | () | 메서드 |
AS3 function pop():T| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector에서 마지막 요소를 제거하고 해당 요소를 반환합니다. 이 함수를 호출하면 Vector의 length 속성이 1만큼 감소합니다.
T — 지정된 Vector에 있는 마지막 요소의 값입니다. |
RangeError —
fixed가 true일 때 이 메서드를 호출한 경우입니다.
|
참고 사항
| push | () | 메서드 |
AS3 function push(... args):uint| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector 끝에 하나 이상의 요소를 추가하고 Vector의 새 길이를 반환합니다.
이 함수는 여러 인수를 받을 수 있으므로 엄격 모드에서도 컴파일 타임에 인수의 데이터 유형이 검사되지 않습니다. 그러나 기본 유형의 인스턴스가 아닌 인수를 전달하면 런타임에 예외가 발생합니다.
매개 변수
... args — Vector에 추가할 하나 이상의 값입니다. |
uint — 새 요소가 추가된 후 Vector의 길이입니다. |
TypeError —
Vector의 기본 유형 T의 인스턴스가 아닌 인수가 있는 경우입니다.
| |
RangeError —
fixed가 true일 때 이 메서드를 호출한 경우입니다.
|
참고 사항
| reverse | () | 메서드 |
AS3 function reverse():Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector에서 요소의 순서를 뒤집습니다. 이 메서드는 호출된 Vector를 변경합니다.
반환값Vector.<T> — 요소의 순서가 뒤집힌 Vector입니다. |
| shift | () | 메서드 |
AS3 function shift():T| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector에서 첫 번째 요소를 제거하고 해당 요소를 반환합니다. Vector의 나머지 요소는 원래 위치 i에서 i - 1로 이동합니다.
반환값T — Vector의 첫 번째 요소입니다. |
RangeError —
fixed가 true인 경우입니다.
|
참고 사항
| slice | () | 메서드 |
AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
원본 Vector에서 특정 범위에 있는 요소로 구성된 새 Vector를 반환하며 원본 Vector를 수정하지 않습니다. 반환되는 Vector에는 startIndex 요소부터 endIndex 요소 바로 앞까지의 모든 요소가 포함됩니다.
매개 변수를 전달하지 않으면 원본 Vector의 복제본이 만들어집니다.
매개 변수
startIndex:int (default = 0) —
슬라이스 시작점의 인덱스를 지정하는 숫자입니다. startIndex가 음수인 경우 시작점은 Vector의 끝에서 시작합니다. 여기에서 -1은 마지막 요소입니다.
| |
endIndex:int (default = 16777215) —
슬라이스 끝점의 인덱스를 지정하는 숫자입니다. 이 매개 변수를 생략하면 시작점부터 Vector 끝까지 모든 요소가 슬라이스에 포함됩니다. endIndex가 음수인 경우 끝점은 Vector의 끝을 기준으로 지정됩니다. 여기에서 -1은 마지막 요소입니다.
|
Vector.<T> — 원본 Vector에서 특정 범위에 있는 요소로 구성된 새 Vector입니다. |
| some | () | 메서드 |
AS3 function some(callback:Function, thisObject:Object = null):Boolean| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
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 Player에서 예외가 발생합니다. 다음과 같이 함수를 변수에 할당하면 이 런타임 오류를 방지할 수 있습니다.
var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
//your code here
};
myVector.some(myFunction, someObject);
매개 변수
callback:Function —
Vector의 각 항목에 대해 실행할 함수입니다. 이 함수는 세 개의 인수(Vector의 현재 항목, 항목의 인덱스 및 Vector 객체)를 사용하여 호출됩니다.
function callback(item:T, index:int, vector:Vector.<T>):Boolean 콜백 함수는 부울 값을 반환해야 합니다. | |
thisObject:Object (default = null) —
콜백 함수를 호출할 때 해당 함수에서 식별자 this가 참조하는 객체입니다.
|
Boolean —
부울 값이 true이면 지정된 함수에 대해 true를 반환하는 항목이 Vector에 있는 것이고, false이면 그렇지 않은 것입니다.
|
참고 사항
| sort | () | 메서드 |
AS3 function sort(compareFunction:Function):Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 요소를 정렬합니다. 이 메서드는 compareFunction 매개 변수에 제공된 함수에 따라 정렬합니다.
매개 변수
compareFunction:Function —
정렬 동작을 결정하는 비교 메서드입니다.
지정된 메서드는 Vector의 기본 유형( function compare(x:T, y:T):Number {}
|
Vector.<T> — 요소가 새로 정렬된 Vector입니다. |
| splice | () | 메서드 |
AS3 function splice(startIndex:int, deleteCount:uint, ... items):Vector.<T>| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector에 요소를 추가하고 Vector에서 요소를 제거합니다. 이 메서드는 복사본을 만들지 않고 Vector를 수정합니다.
참고: Vector의 하위 클래스에서 이 메서드를 재정의하려면 다음 예제와 같이 매개 변수로 ...args를 사용합니다.
public override function splice(...args) {
// your statements here
}
매개 변수
startIndex:int — Vector에서 삽입 또는 삭제가 시작되는 요소의 인덱스를 지정하는 정수입니다. 음의 정수를 사용하면 Vector의 끝을 기준으로 상대 위치를 지정할 수 있습니다. 예를 들어 -1은 Vector의 마지막 요소입니다. | |
deleteCount:uint —
삭제할 요소의 수를 지정하는 정수입니다. 이 수에는 startIndex 매개 변수로 지정된 요소가 포함됩니다. deleteCount 매개 변수에 값을 지정하지 않으면 startIndex 요소에서 Vector의 마지막 요소까지 모든 값이 삭제됩니다. 값이 0이면 요소가 삭제되지 않습니다.
| |
... items —
선택 요소로서, Vector에서 startIndex 매개 변수로 지정된 위치에 삽입할 하나 이상의 값을 쉼표로 구분한 목록 또는 Vector입니다.
|
Vector.<T> — 원본 Vector에서 제거된 요소가 들어 있는 Vector입니다. |
RangeError —
startIndex 및 deleteCount 인수에 지정된 삭제할 인덱스가 Vector의 경계를 벗어나는 경우입니다.
| |
RangeError —
fixed가 true이고 splice() 작업으로 인해 Vector의 length가 변경될 때 이 메서드를 호출한 경우입니다.
|
| toLocaleString | () | 메서드 |
public function toLocaleString():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
지정된 Vector의 요소를 나타내는 문자열을 반환합니다. 인덱스 0에서 시작하여 최대 인덱스로 끝나는 Vector에 포함된 모든 요소가 연결된 문자열로 변환되고 쉼표로 구분됩니다. ActionScript 3.0 구현에서 이 메서드의 반환 값은 Vector.toString() 메서드와 같습니다.
String — Vector 요소의 문자열입니다. |
참고 사항
| toString | () | 메서드 |
public function toString():String| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector의 요소를 나타내는 문자열을 반환합니다. 인덱스 0에서 시작하여 최대 인덱스로 끝나는 Vector에 포함된 모든 요소가 연결된 문자열로 변환되고 쉼표로 구분됩니다. 사용자 정의 분리 기호를 지정하려면 Vector.join() 메서드를 사용합니다.
String — Vector 요소의 문자열입니다. |
참고 사항
| unshift | () | 메서드 |
AS3 function unshift(... args):uint| 언어 버전: | ActionScript 3.0 |
| 런타임 버전: | Flash Player 10, AIR 1.5 |
Vector 시작 부분에 하나 이상의 요소를 추가하고 Vector의 새 길이를 반환합니다. Vector의 다른 요소는 원래 위치 i에서 i + 새 요소 수로 이동합니다.
이 함수는 여러 인수를 받을 수 있으므로 엄격 모드에서도 컴파일 타임에 인수의 데이터 유형이 검사되지 않습니다. 그러나 기본 유형의 인스턴스가 아닌 인수를 전달하면 런타임에 예외가 발생합니다.
매개 변수
... args — Vector의 시작 부분에 삽입할 하나 이상의 인스턴스(Vector의 기본 유형)입니다. |
uint — Vector의 새 길이를 나타내는 정수입니다. |
TypeError —
Vector의 기본 유형 T의 인스턴스가 아닌 인수가 있는 경우입니다.
| |
RangeError —
fixed가 true일 때 이 메서드를 호출한 경우입니다.
|
참고 사항