Arrays — Aurora Script Commands

배열(Array) 은 여러 개의 데이터를 하나로 묶어 표현하기 위한 개념입니다. 동일한 종류의 값들을 한 변수에 담아 두고, 명령어에 한 번에 전달하거나 Do ~ Loop 으로 순회할 때 사용합니다.

Aurora 배열은 일반적인 프로그래밍 언어의 [1, 2, 3] 표기와 다릅니다. %{ }로 감싸고, 각 항목은 작은따옴표로 감쌉니다.

배열 표기

배열은 다음 세 가지 규칙으로 작성합니다.

예를 들어 숫자 123, 456, 789 를 배열로 표현하면 다음과 같습니다.

%{'123','456','789'}

문자열도 같은 방식입니다.

%{'apple','banana','cherry'}

배열 변수의 각 요소는 변수 이름 뒤에 &N 을 붙여 참조합니다. N 은 0부터 시작하는 요소의 위치입니다.

mGetTexts 가 %{'123','456','789'} 라는 값을 가진 배열 변수일 때:

N 을 계속 변경해서 배열의 모든 요소에 접근할 수 있습니다.

위 배열에서 mGetTexts&0 으로 첫 번째 요소를 출력하면 123 이 나옵니다.

배열 인덱스 참조 출력 예

배열은 보통 두 가지 방식으로 활용됩니다.

배열의 전체 내용을 변수에 저장한 뒤 명령어 인자에 그대로 넘기는 방식입니다.

mVarArray 변수에 %{'123','456','789'} 라는 값이 저장되어 있으면, 명령어 실행 시 변수가 치환되어 배열로 사용됩니다.

배열 전체를 변수로 전달하는 예

배열을 만드는 시점에 항목 자리에 변수를 넣어 동적으로 구성할 수도 있습니다.

mVarValue 변수에 456 이 저장되어 있다면, 다음 두 표현은 동일하게 평가됩니다.

%{'123','[mVarValue]','789'}
↓
%{'123','456','789'}

배열 항목 안에 변수를 넣는 예

스크립트에서 사용하는 모든 입력의 [ ] 는 변수로 판단되므로, 배열 항목 안에서도 일반 Expression 규칙이 그대로 적용됩니다.

배열의 모든 요소를 순회할 때는 Do ~ Loop 명령어와 mIndex 기본 변수를 함께 사용합니다. mIndex 는 반복할 때마다 자동으로 0, 1, 2, ... 로 증가하므로 그대로 인덱스로 활용할 수 있습니다.

Do 3
    Print [mGetTexts&[mIndex]]
Loop

위 흐름은 mGetTexts 의 모든 요소(123, 456, 789)를 순서대로 출력합니다.