배열 길이 함수 (array_length)
이 문서는 array_length 함수에 대해 설명합니다. 이 함수는 배열의 길이(항목 수)를 반환합니다. 배열을 입력하면, 해당 배열에 포함된 항목 수를 나타내는 정수 값을 반환합니다. 이 함수는 다차원 배열에도 사용할 수 있으며, 배열 인덱스를 제공할 때 어떤 차원의 길이를 얻고 싶은지를 지정해야 합니다.
사용법
다음은 array_length 함수의 기본 사용법입니다:
// 배열의 첫 번째 차원 길이 반환
val = array_length(my_array);
// 배열의 두 번째 차원 길이 반환
val = array_length(my_array[0]);
// 배열의 세 번째 차원 길이 반환
val = array_length(my_array[0][0]);
이와 같이 배열의 각 차원에 대해 길이를 얻을 수 있습니다. 만약 배열이 아닌 데이터 타입이 전달되면 함수는 0을 반환합니다.
문법
array_length(array);
인수 설명
| 인수 | 타입 | 설명 |
|---|---|---|
| array | Array | 확인할 배열 |
반환 값
- 실수 (Real)
예제
다음은 array_length 함수를 사용하는 예제입니다:
for (var i = 0; i < array_length(a); ++i) {
a[i] = -1;
}
위 코드는 배열을 순회하며 각 항목을 -1로 설정합니다.
활용 예제
- 배열 초기화: 배열의 길이를 사용하여 동적으로 배열을 초기화할 수 있습니다.
gml var my_array = array_create(5); // 길이가 5인 배열 생성 for (var i = 0; i < array_length(my_array); i++) { my_array[i] = i * 2; // 각 항목에 2의 배수 할당 } - 다차원 배열 처리: 다차원 배열의 각 차원을 순회하여 값을 설정할 수 있습니다.
gml var my_2d_array = array_create(3); // 3x3 배열 생성 for (var i = 0; i < array_length(my_2d_array); i++) { my_2d_array[i] = array_create(3); // 각 행에 3개의 열 생성 for (var j = 0; j < array_length(my_2d_array[i]); j++) { my_2d_array[i][j] = i + j; // 행과 열의 인덱스 합으로 값 설정 } } - 조건부 배열 처리: 배열의 길이에 따라 조건부 로직을 구현할 수 있습니다.
gml if (array_length(my_array) > 0) { // 배열이 비어있지 않을 때만 실행 var first_value = my_array[0]; } - 배열 복사: 배열의 길이를 사용하여 새로운 배열에 기존 배열의 값을 복사할 수 있습니다.
gml var new_array = array_create(array_length(old_array)); for (var i = 0; i < array_length(old_array); i++) { new_array[i] = old_array[i]; // 값 복사 }
이와 같은 다양한 활용 예제를 통해 array_length 함수를 효과적으로 사용할 수 있습니다.