배열, 리스트, 맵

배열, 리스트, 맵에 많은 값을 저장하고, FOR와 FOREACH로 순회하고, DATA와 READ로 상수 표를 읽는 법을 다룹니다.

한 줄 요약#

aukimi에는 많은 값을 담는 컨테이너가 세 가지 있고, 프로그램 안에 상수 표를 직접 쓰는 방법도 있습니다.

배열리스트맵
선언DIM a(10) 또는 a AS integer[]NewList l.i()NewMap m.i()
값을 찾는 기준위치: a(3)현재 요소: l()텍스트 키: m("gold")
늘리기.insert(v), .length = nAddElement(l())새 키에 쓰기
순회FOR i = 0 TO a.lengthFOREACH l()FOREACH m()

컨테이너를 다른 변수에 대입해도 복사되지 않습니다. b = a 뒤에는 두 이름이 같은 배열, 리스트, 맵을 가리키며, 한쪽에서 바꾼 내용이 다른 쪽에도 보입니다. 복사하려면 CopyArray, CopyList, CopyMap을 쓰세요.

이름 붙은 필드를 묶는 레코드는 별도의 페이지에 있습니다. 레코드와 메서드를 보세요.

DIM#

DIM <name>(<last index> [, <last index>…]) [AS <type>] [= [<value>, …]]
DIM <name>[<last index> [, <last index>…]] [AS <type>] [= [<value>, …]]
DIM scores(4)
scores(0) = 10
scores(4) = 50
Console(Str(scores.length))   ' 4, 마지막 인덱스
FOR i = 0 TO scores.length
  Console(Str(scores(i)))   ' 10, 0, 0, 0, 50
NEXT

숫자는 개수가 아니라 마지막 인덱스입니다. DIM scores(4)는 0부터 4까지 번호가 붙은 다섯 칸을 만듭니다. 이는 AGK, DarkBASIC, PureBasic의 규칙이며, C나 JavaScript의 규칙이 아닙니다.

  • 모든 칸은 0에서 시작하고, 이름이 $로 끝나면 ""에서 시작합니다.
  • 범위에는 어떤 식이든 쓸 수 있습니다. DIM grid(width, height).
  • AS <type>을 주면 모든 쓰기가 그 타입으로 변환됩니다. AS integer는 소수를 버리고, AS uint8은 256에서 감깁니다. AS에 레코드 타입을 주면 모든 칸이 레코드입니다. 변수와 타입을 참고하세요.
  • 이미 있는 이름에 DIM을 쓰면 새 배열이 만들어지고, 이전 값은 사라집니다. 값을 유지하면서 크기를 바꾸려면 .length에 대입하세요(아래).
  • 프로그램 맨 위의 DIM은 모든 FUNCTION 안에서 보입니다. FUNCTION 안의 DIM은 그 함수에 속합니다.
DIM names$(2)
names$(1) = "Ada"
DIM ages(2) AS integer
ages(0) = 3.7
DIM bytes(1) AS uint8
bytes(0) = 300
Console(names$(1) + " " + Str(ages(0)) + " " + Str(bytes(0)))   ' Ada 3 44

⚠️ GLOBAL DIM과 LOCAL DIM은 안정적으로 동작하지 않습니다. 둥근 괄호를 쓰면 그 배열의 다음 사용이 알 수 없는 명령어로 거부됩니다. FUNCTION 안의 GLOBAL DIM은 배열을 밖에서 보이게 만들지 않습니다. 대신 프로그램 맨 위에 일반 DIM을 쓰세요.

여러 차원, 세 가지 철자#

DIM grid(2, 3)
grid(1, 2) = 7
Console(Str(grid[1, 2]))   ' 7
Console(Str(grid[1][2]))   ' 7
Console(Str(grid.length))   ' 2, 첫 번째 차원의 마지막 인덱스
Console(Str(grid[0].length))   ' 3, 두 번째 차원의 마지막 인덱스

a(i, j), a[i, j], a[i][j]는 같은 칸을 읽고 씁니다. 둥근 괄호는 클래식 철자이고, 대괄호는 AGK 철자입니다.

⚠️ 범위 검사가 없습니다. 마지막 인덱스를 넘어 읽으면 값이 전혀 없습니다(Str이 undefined를 보여 줍니다). 넘어서 쓰면 배열이 조용히 늘어나고, 그 사이 칸에도 값이 없습니다. 인덱스를 .length와 직접 비교해 확인하세요.

타입이 있는 배열: AS <type>[]#

<name> AS <type>[]
<name> AS <type>[<last index> [, <last index>…]]
values AS integer[] = [1, 2, 3]
Console(Str(values.length))   ' 2
more AS integer[5] = [9]
Console(Str(more[0]) + " " + Str(more[5]))   ' 9 0
empty AS string[]
Console(Str(empty.length))   ' -1, 칸이 전혀 없음

DIM … AS와 같은 배열이며 AGK 방식으로 쓴 것입니다. 범위 없이 []만 쓰면 배열이 빈 상태로 시작합니다. FUNCTION의 매개변수와 결과도 이 형태를 씁니다. 함수를 참고하세요.

초기화와 리스트 대입#

= [ … ]는 인덱스 0부터 칸을 채웁니다. 1차원 배열에서만 동작합니다. 배열보다 긴 리스트는 배열을 늘립니다.

프로그램 후반에 리스트를 대입하면 인덱스 0부터 쓰고 나머지 칸은 그대로 둡니다. 필요하면 배열을 늘리지만 줄이지는 않습니다.

DIM a(4)
a = [7, 8]
Console(Str(a(0)) + Str(a(1)) + " " + Str(a.length))   ' 78 4

배열 멤버#

DIM a(2) = [30, 10, 20]
a.insert(5)
a.insert(99, 0)
Console(Str(a.length))   ' 4
a.remove()
a.remove(0)
a.sort()
Console(Str(a(0)) + " " + Str(a(1)) + " " + Str(a(2)))   ' 10 20 30
Console(Str(a.find(20)))   ' 1
Console(Str(a.find(42)))   ' -1
멤버하는 일
a.length마지막 인덱스: 칸 수 빼기 1, 비어 있으면 -1
a.length = nn이 마지막 인덱스가 되도록 크기를 바꿈. 유지되는 칸은 값을 보존하고 새 칸은 기본값을 가짐
a.insert(v)끝에 v를 추가
a.insert(v, i)인덱스 i에 v를 끼워 넣고 나머지를 밀어냄
a.remove()마지막 칸을 제거
a.remove(i)i번 칸을 제거하고 나머지를 당김
a.find(v)v와 같은 첫 번째 칸의 인덱스, 없으면 -1
a.sort()제자리에서 오름차순 정렬
UNDIM a[]배열을 비움 (.length가 -1이 됨)

.length는 마지막 인덱스입니다. 모든 칸에 대한 루프는 FOR i = 0 TO a.length이고, 칸의 개수는 a.length + 1입니다. AGK의 규칙입니다. JavaScript에서 왔다면 함정이 됩니다.

  • .insert, .remove, .length = n은 자기 줄에 쓰는 문장입니다. 값을 반환하지 않습니다.
  • .find는 엄격한 동등 비교를 씁니다. a.find("2")는 숫자 2를 찾지 못합니다. 배열 전체를 훑으므로 정렬되어 있을 필요는 없습니다.
  • .sort()는 문자열을 문자 코드 순으로 한 글자씩 비교합니다. 모든 대문자가 모든 소문자보다 앞에 옵니다("Zebra"가 "apple"보다 앞). 레코드 배열은 첫 번째 필드를 기준으로 정렬됩니다.
  • 멤버는 레코드 안의 배열에서도 동작합니다. bag.names.insert("Key").
  • UNDIM은 대괄호를 씁니다. UNDIM a()는 망가진 프로그램으로 컴파일됩니다.
DIM a(2)
UNDIM a()

배열을 받는 카탈로그 명령어. SortArray(a, options)는 옵션으로 정렬하고(큰 값부터는 #AK_ORDER_HIGH_TO_LOW), RandomizeArray(a)는 섞고, CopyArray(source, destination)는 복사하고, CompareArray(a, b)는 두 배열의 값이 같으면 1을 반환하고, ArraySize(a)는 .length처럼 마지막 인덱스를 반환합니다. 명령어 레퍼런스를 보세요.

DIM a(2) = [1, 2, 3]
DIM b(0)
CopyArray(a, b)
b(0) = 99
Console(Str(a(0)) + " " + Str(b.length))   ' 1 2, a는 그대로이고 b는 크기가 바뀜

리스트#

NewList <name>.<type>()
NewList <name>()

리스트는 값을 순서대로 담고 현재 요소를 하나 가집니다. 리스트 작업의 대부분은 이 커서를 옮긴 다음 그 아래의 요소를 읽거나 쓰는 일입니다.

NewList scores.i()
AddElement(scores())
scores() = 10
AddElement(scores())
scores() = 30
FirstElement(scores())
AddElement(scores())
scores() = 20
FOREACH scores()
  Console(Str(ListIndex(scores())) + ": " + Str(scores()))   ' 0: 10, 1: 20, 2: 30
NEXT scores()
Console(Str(ListSize(scores())))   ' 3
  • scores()는 현재 요소입니다. 읽거나 대입할 수 있습니다. scores() = 10. 현재 요소가 없으면 프로그램이 "BASIC list has no current element"로 멈춥니다.
  • AddElement는 현재 요소 뒤에 삽입하고 새 요소를 현재로 만듭니다. 위에서 20이 10과 30 사이에 들어간 이유입니다.
  • 타입은 점 뒤에 옵니다. 짧은 접미사(.i, .f, .d, .s, .q…), 전체 이름(.integer, .string, .float64), 또는 레코드 타입(NewList foes.Foe(), 아래 참고). 타입이 없으면 리스트는 정수를 담습니다.
  • 값은 리스트의 타입으로 변환됩니다. .f는 32비트 float이므로 0.1은 0.10000000149011612로 읽혀 돌아옵니다. 전체 정밀도가 필요하면 .d를 쓰세요.
  • 레코드 리스트는 현재 요소를 통해 필드를 제공합니다. foes().hp = 30.
  • 한 이름이 리스트이면서 맵일 수는 없습니다.

⚠️ $ 시길로는 리스트를 선언할 수 없습니다. NewList names$()는 거부됩니다. 점 뒤에 타입을 쓰세요.

NewList names$()
NewList names.s()
AddElement(names())
names() = "Ada"
Console(names())   ' Ada

⚠️ 현재 요소에 대한 +=는 프로그램이 실행될 때 실패하며, INC scores()도 마찬가지입니다. scores() = scores() + 5라고 쓰세요.

FOREACH#

FOREACH <list>()
  <statements>
NEXT [<list>()]

FOREACH는 리스트를 첫 요소부터 마지막 요소까지 순회합니다. 루프 안에서 list()는 이번 반복의 요소이며, 바꿀 수 있습니다.

NewList a.i()
FOR k = 1 TO 5
  AddElement(a())
  a() = k
NEXT
FOREACH a()
  IF Mod(a(), 2) = 0 THEN DeleteElement(a())
NEXT
FOREACH a()
  Console(Str(a()))   ' 1, 3, 5
NEXT
  • FOREACH 안에서 현재 요소를 삭제해도 안전합니다. 루프는 다음 요소로 계속 진행합니다.
  • EXIT와 CONTINUE는 다른 루프처럼 동작합니다.
  • 괄호는 필수입니다. FOREACH a와 NEXT a는 컴파일 오류입니다. NEXT만 쓰는 것은 괜찮습니다.
  • FOREACH는 맵(아래)과 레코드의 리스트나 맵 필드에서도 동작합니다. FOREACH bag.items().
  • FOREACH는 배열에서는 동작하지 않습니다. FOR i = 0 TO a.length를 쓰세요.
  • FOREACH는 리스트의 커서 하나를 옮깁니다. 같은 리스트에 대한 중첩 FOREACH나 커서를 옮기는 호출은 바깥 루프의 위치를 바꿉니다.
  • PureBasic의 ForEach … Next도 같은 것입니다. 키워드는 대소문자를 무시합니다.

25개의 리스트 호출#

모든 호출은 리스트를 괄호와 함께 받습니다. scores(). 위치는 0부터 셉니다.

호출하는 일반환값
AddElement(l())현재 요소 뒤(없으면 첫 자리)에 요소를 추가하고 현재로 만듦1
InsertElement(l())현재 요소 앞에 요소를 추가하고 현재로 만듦1
DeleteElement(l() [, flags])현재 요소를 삭제함. 그 앞의 요소가 현재가 됨. flags = 1이면 첫 요소를 삭제할 때 새 첫 요소가 현재가 됨삭제 후 현재 요소가 있으면 1, 아니면 0
ClearList(l())모든 요소를 제거없음
FreeList(l())모든 요소를 제거하고 리스트를 해제함. 이후 ListSize는 -1을 반환없음
ListSize(l())요소의 수개수, FreeList 후에는 -1
ListIndex(l())현재 요소의 위치위치, 없으면 -1
ResetList(l())커서를 첫 요소 앞으로 옮김없음
NextElement(l())다음 요소로 이동1, 끝을 넘으면 0
PreviousElement(l())이전 요소로 이동1, 시작 앞이면 0
FirstElement(l())첫 요소로 이동1, 비어 있으면 0
LastElement(l())마지막 요소로 이동1, 비어 있으면 0
SelectElement(l(), i)위치 i로 이동1, 범위 밖이면 0
ChangeCurrentElement(l(), i)SelectElement와 같음1 또는 0
CopyList(source(), destination())대상을 원본의 복사본으로 교체1, 타입이 다르면 0
CompareList(a(), b() [, flags])두 리스트를 요소별로 비교함. #AK_MATCH_FOLD_CASE는 대소문자를 무시같으면 1, 아니면 0
MergeLists(source(), destination() [, where])원본의 모든 요소를 대상으로 옮김. where는 #AK_LIST_LAST(기본값), #AK_LIST_FIRST, 또는 대상의 현재 요소 앞/뒤를 뜻하는 #AK_LIST_BEFORE / #AK_LIST_AFTER없음
SplitList(source(), destination() [, keep])현재 요소와 그 뒤의 모든 요소를 대상으로 옮김. keep = 1이면 현재 요소는 남음없음
SortList(l(), options [, start, end])숫자나 문자열 리스트를 정렬함. 옵션은 #AK_ORDER_LOW_TO_HIGH, #AK_ORDER_HIGH_TO_LOW, #AK_ORDER_FOLD_CASE없음
SortStructuredList(l(), "field", options [, start, end])텍스트로 지정한 필드 하나를 기준으로 레코드 리스트를 정렬없음
RandomizeList(l() [, start, end])리스트 또는 지정한 범위를 섞음없음
PushListPosition(l())현재 요소를 기억없음
PopListPosition(l())기억해 둔 요소로 돌아감없음
MoveElement(l(), where [, i])현재 요소를 옮김. #AK_LIST_FIRST, #AK_LIST_LAST, 또는 위치 i의 요소 앞/뒤를 뜻하는 #AK_LIST_BEFORE / #AK_LIST_AFTER없음
SwapElements(l(), i, j)위치 i와 j의 요소를 맞바꿈없음

인자 수가 틀리면 컴파일 오류입니다. 예: "SortList(...) expects 2-4 argument(s)". 정렬 옵션은 필수이며, SortList(l())만 쓰면 거부됩니다.

TYPE Foe
  name AS string
  hp AS integer
ENDTYPE
NewList foes.Foe()
AddElement(foes())
foes().name = "orc"
foes().hp = 30
AddElement(foes())
foes().name = "elf"
foes().hp = 10
SortStructuredList(foes(), "hp", #AK_ORDER_LOW_TO_HIGH)
FOREACH foes()
  Console(foes().name + " " + Str(foes().hp))   ' elf 10, orc 30
NEXT

PureBasic에서 오셨다면. 이름과 대부분의 인자는 같습니다. aukimi에는 요소 포인터가 없어서, PureBasic이 요소 포인터를 받는 곳에서 세 호출은 위치를 받습니다. SwapElements, ChangeCurrentElement, 그리고 MoveElement의 마지막 인자입니다. SortStructuredList는 오프셋과 타입이 아니라 필드 이름을 텍스트로 받습니다. AddElement는 요소의 주소가 아니라 1을 반환합니다. foes()\hp는 foes().hp로 씁니다.

맵#

NewMap <name>.<type>([<slots>])

맵은 텍스트 키 아래에 값을 저장합니다. 맵에도 현재 요소가 있습니다.

NewMap stock.i()
stock("apple") = 3
stock("pear") = 5
stock("apple") += 2
Console(Str(stock("apple")))   ' 5
Console(Str(MapSize(stock())))   ' 2
IF FindMapElement(stock(), "plum") = 0 THEN Console("no plum")
FOREACH stock()
  Console(MapKey(stock()) + " = " + Str(stock()))   ' apple = 5, pear = 5
NEXT
  • m("key") = v는 항목을 만들거나 그 값을 교체합니다. +=와 다른 복합 대입도 항목에 사용할 수 있습니다.
  • m("key")를 읽으면 항목이 없을 때 기본값으로 항목이 만들어집니다. 만들지 않고 검사하려면 FindMapElement를 쓰세요.
  • 모든 접근은 그 항목을 현재 항목으로 만듭니다. m()은 현재 항목이며 읽거나 대입할 수 있습니다.
  • 키는 텍스트입니다. 숫자는 텍스트로 바뀝니다. m(1)과 m("1")은 같은 항목입니다. 키는 대소문자를 구분합니다. "A"와 "a"는 서로 다른 항목입니다.
  • FOREACH와 NextMapElement는 항목을 만들어진 순서대로 방문합니다.
  • <slots>는 PureBasic 프로그램을 위해 남겨 둔 크기 힌트입니다. 양의 정수여야 하며 그 외에는 아무것도 바꾸지 않습니다.
  • 레코드 맵은 항목을 통해 필드를 제공합니다. bag("sword").qty = 1.

13개의 맵 호출#

호출하는 일반환값
AddMapElement(m(), key [, flags])항목을 만들거나, 이미 있는 항목을 기본값으로 초기화하고 현재로 만듦. flags는 0이어야 함1
FindMapElement(m(), key)항목이 있으면 현재로 만듦. 아무것도 만들지 않음찾으면 1, 아니면 0
DeleteMapElement(m() [, key])항목 또는 현재 항목을 삭제삭제했으면 1, 아니면 0
ClearMap(m())모든 항목을 제거없음
FreeMap(m())모든 항목을 제거하고 맵을 해제함. 이후 MapSize는 -1을 반환없음
MapSize(m())항목의 수개수, FreeMap 후에는 -1
MapKey(m())현재 항목의 키텍스트, 없으면 ""
ResetMap(m())커서를 첫 항목 앞으로 옮김없음
NextMapElement(m())다음 항목으로 이동1, 끝을 넘으면 0
CopyMap(source(), destination())대상을 원본의 복사본으로 교체1, 타입이 다르면 0
CompareMap(a(), b() [, flags])키와 값을 비교함. #AK_MATCH_FOLD_CASE는 대소문자를 무시같으면 1, 아니면 0
PushMapPosition(m())현재 항목을 기억없음
PopMapPosition(m())기억해 둔 항목으로 돌아감없음
NewMap m.s()
m("x") = "1"
m("y") = "2"
ResetMap(m())
WHILE NextMapElement(m())
  Console(MapKey(m()) + "=" + m())   ' x=1, y=2
WEND

INC와 DEC#

INC <target> [, <amount>]
DEC <target> [, <amount>]
n = 5
INC n
INC n, 10
DEC n, 3
Console(Str(n))   ' 13
DIM a(2)
INC a[1], 4
Console(Str(a[1]))   ' 4
b AS uint8 = 255
INC b
Console(Str(b))   ' 0, uint8은 감김
  • INC는 1 또는 지정한 양을 더합니다. DEC는 뺍니다.
  • 대상은 변수, 대괄호로 쓴 배열 칸 a[i], 필드 p.x, 또는 이들의 조합 ps[i].x입니다.
  • 타입이 있는 변수에서는 그 타입에 쓸 때처럼 결과가 감깁니다.
  • OPTION EXPLICIT 아래에서는 대상이 먼저 선언되어 있어야 합니다.

⚠️ 배열 칸에는 대괄호를 쓰세요. INC a(1)은 망가진 프로그램으로 컴파일되고, INC ps(1).x, INC l(), INC m("k")도 마찬가지입니다. INC a[1], INC ps[1].x, l() = l() + 1, m("k") += 1로 쓰세요.

DIM a(2)
INC a(1)

두 값 맞바꾸기#

SWAP a, b 문장은 없습니다. 그 줄은 거부됩니다.

a = 1
b = 2
SWAP a, b

괄호가 있는 Swap()은 존재하지만 다른 일을 합니다. Sync()처럼 프레임을 끝냅니다. 게임 루프와 태스크를 참고하세요.

두 변수나 두 배열 칸은 세 번째 변수를 거쳐 맞바꾸세요. 리스트의 두 요소는 SwapElements(l(), i, j)로 맞바꿉니다.

a = 1
b = 2
temp = a
a = b
b = temp
Console(Str(a) + " " + Str(b))   ' 2 1

DATA, READ, RESTORE#

DATASECTION
  [<label>:]
  DATA[.<type>] <literal> [, <literal>…]
ENDDATASECTION

READ[.<type>] <target>
RESTORE [<label>]

DATASECTION은 프로그램에 쓴 상수 값을 담습니다. READ는 그것을 순서대로 하나씩 가져옵니다. RESTORE는 읽는 위치를 옮깁니다.

RESTORE Levels
READ count
FOR i = 1 TO count
  READ name$
  READ.f speed#
  Console(name$ + " " + Str(speed#))   ' Forest 1.5, Cave 2.25
NEXT
DATASECTION
  Levels:
  DATA 2
  DATA.s "Forest"
  DATA.f 1.5
  DATA.s "Cave"
  DATA.f 2.25
ENDDATASECTION
철자받아들이는 형태
여는 줄DATASECTION 또는 DATA SECTION
닫는 줄ENDDATASECTION, END DATASECTION, END DATA SECTION

DATA 타입. 각 DATA 줄은 점 뒤에 쓰는 타입을 하나 가집니다.

접미사담는 값
없음, .i (.l, .q, .w, .b, .a, .u, .c도 포함)숫자
.f, .d숫자
.s큰따옴표로 감싼 문자열
  • DATA는 DATASECTION 안에서만 허용됩니다. 이 섹션은 실행되지 않으므로 프로그램의 맨 위나 맨 아래에 둘 수 있습니다.
  • 값은 리터럴이어야 합니다. 숫자는 음수, 소수, %1010, 0c12, 0x10, 1.25e2일 수 있습니다. TRUE와 FALSE는 1과 0으로 취급됩니다. DATA 1 + 2는 컴파일 오류이며, .s 없이 DATA 줄에 문자열을 쓰는 것도 마찬가지입니다.
  • 값은 줄과 레이블에 걸쳐 쓴 순서대로 읽힙니다.

READ. 읽을 종류는 READ.<type>에서, 없으면 대상의 시길에서 정해집니다. $는 문자열, #는 소수, 시길이 없으면 정수를 읽습니다.

  • 대상은 변수, 배열 칸(a(1) 또는 a[1]), 필드(p.x)가 될 수 있습니다.
  • 소수 값에서 정수를 읽으면 소수부를 버립니다. 2.9는 2가 됩니다.
  • 다음 값이 숫자인데 문자열로 읽거나 그 반대로 읽으면 프로그램이 멈춥니다. "BASIC READ type does not match DATA".
  • 마지막 값을 넘어서 읽으면 프로그램이 멈춥니다. "BASIC READ reached the end of DATA".

RESTORE. RESTORE만 쓰면 첫 번째 값으로 돌아갑니다. RESTORE Label은 그 레이블 뒤의 첫 번째 값으로 갑니다. 레이블은 대소문자를 무시하며, 모르는 레이블은 컴파일 오류입니다. 데이터 레이블은 GOSUB 레이블이 아니므로 호출할 수 없습니다.

다른 BASIC에서 오셨다면. AGK에는 DATA가 없습니다. DarkBASIC은 섹션 없이 타입 없는 DATA 줄을 읽습니다. aukimi는 PureBasic의 DataSection을 따라 타입이 있는 DATA 줄을 쓰며, 두 가지 단축을 더합니다. 타입 없는 DATA는 숫자를 담고, READ는 시길에서 타입을 가져올 수 있습니다.