레코드와 메서드
필드를 TYPE 레코드로 묶고, 값으로 복사하고, WITH로 필드에 접근하고, 메서드와 생성자, 소멸자를 붙이는 법을 다룹니다.
한 줄 요약#
TYPE은 레코드를 선언합니다. 이름 붙은 필드의 묶음이며, 필드마다 자기 타입이 있습니다. 레코드는 숫자처럼 값입니다. 선언된 변수에 대입하면 복사본이 만들어집니다. METHOD는 레코드에 속한 함수를 추가하며, 그 안에서는 SELF를 씁니다.
TYPE Ship
name AS string
fuel AS integer
speed AS float
ENDTYPE
hero AS Ship
hero.name = "Comet"
hero.fuel = 80
hero.speed = 2.5
Console(hero.name + " " + Str(hero.fuel) + " " + Str(hero.speed)) ' Comet 80 2.5TYPE … ENDTYPE#
TYPE <Name>
<field>
…
[METHOD …]
ENDTYPE
| 필드 형태 | 필드가 담는 것 |
|---|---|
name | 32비트 정수 |
name$ | 문자열 |
name# | 소수 |
name AS <type> | 그 타입: integer, float, string, uint8… 또는 다른 레코드 타입 |
name AS <type> [<last index>, …] | 그 타입의 배열 |
name [<last index>, …] | 정수 배열 |
LIST name.<type>() | 리스트. 컬렉션 참고 |
MAP name.<type>([<slots>]) | 맵 |
ARRAY name.<type>(<last index>, …) | PureBasic 방식으로 선언한 배열 |
TYPE Player
name AS string
score
lives AS uint8
slots AS integer [3]
LIST items.s()
MAP counts.i()
ENDTYPE
p AS Player
p.name = "Ada"
p.score = 2.9
p.lives = 260
p.slots[3] = 7
AddElement(p.items())
p.items() = "Potion"
p.counts("Potion") = 3
Console(p.name + " " + Str(p.score) + " " + Str(p.lives) + " " + Str(p.slots[3])) ' Ada 2 4 7
Console(p.items() + " " + Str(p.counts("Potion"))) ' Potion 3
시길도
AS도 없는 필드는 정수입니다. 위의score는 2.9를 2로 저장했습니다. 위치와 속도에는AS float(32비트) 또는AS float64가 필요합니다. AGK와 DarkBASIC도 같은 기본값을 씁니다.
- 새 레코드는 숫자는 0, 문자열은
"", 컬렉션은 빈 상태로 시작합니다. - 필드에 쓰면 값이 필드의 타입으로 변환됩니다.
lives AS uint8은 260을 4로 바꿨습니다. - 필드 이름은 대소문자를 무시하며, 같은 이름의 필드 두 개는 컴파일 오류입니다. "Duplicate BASIC field in Player: …". 같은 이름의 타입 두 개도 거부됩니다.
- 필드는 프로그램의 뒤쪽에서 선언된 레코드 타입을 쓸 수 있습니다.
- 알 수 없는 필드 타입은 컴파일 오류입니다. "Unknown BASIC field type".
- 닫는 단어는
ENDTYPE입니다.END TYPE(QBasic, VB)은 거부됩니다.
TYPE Point
x
END TYPE
⚠️ 시길보다 AS를 쓰세요. name$로 쓴 필드는 프로그램 어디에서도 같은 이름이 $ 없이 쓰이지 않을 때만 타입을 유지합니다. 다른 곳에 name이라는 변수가 있으면 충분히 문제가 됩니다. 그러면 필드가 정수가 되고, 거기에 텍스트를 저장하면 프로그램이 멈춥니다. name AS string에는 그런 문제가 없습니다.
⚠️ b a w u l i q f d s c 중 한 글자짜리 필드 이름은 피하세요. 이 글자들은 PureBasic 타입 접미사입니다. 메서드 안에서 SELF.w = 10은 "16비트 변수를 선언한다"로 읽혀서 필드에는 값이 쓰이지 않습니다. width라고 이름 지으세요.
PureBasic의 필드 접미사(x.f)는 TYPE 안에서 받아들여지지 않습니다. x AS float라고 쓰세요.
한 줄 형태#
TYPE Point x AS float y AS float ENDTYPE
TYPE Hero name AS string hp AS integer bag AS integer [2] ENDTYPE
p AS Point
p.x = 1.5
h AS Hero
h.bag[2] = 4
Console(Str(p.x) + " " + Str(h.bag[2])) ' 1.5 4
필드가 단순하면 TYPE 전체를 한 줄에 쓸 수 있습니다. 이름, 선택적인 AS <type>, 선택적인 [bounds]만 해당합니다. LIST, MAP, ARRAY 필드와 메서드에는 긴 형태가 필요합니다.
레코드 안의 레코드#
필드는 레코드일 수 있습니다. TYPE을 다른 TYPE 안에서 선언할 수도 있으며, 그 이름은 여전히 어디서나 쓸 수 있습니다.
TYPE Vec
x AS float
y AS float
ENDTYPE
TYPE Ship
pos AS Vec
vel AS Vec
ENDTYPE
s AS Ship
s.pos.x = 3
s.vel.y = -1.5
Console(Str(s.pos.x) + " " + Str(s.vel.y)) ' 3 -1.5
배열 필드#
배열 필드는 차원마다 대괄호 한 쌍으로 인덱싱합니다. b.grid[1][2]. 다른 철자는 컴파일되지만 잘못 동작합니다. b.grid(1, 2)는 실행될 때 프로그램을 멈추고, b.grid[1, 2]는 조용히 다른 칸에 닿습니다.
TYPE Board
ARRAY grid.i(2, 2)
marks AS integer [4]
ENDTYPE
b AS Board
b.grid[1][2] = 5
b.marks[4] = 1
Console(Str(b.grid[1][2]) + " " + Str(b.marks.length)) ' 5 4
배열 멤버(.length, .insert, .sort()…)는 배열 필드에서도 동작합니다. 컬렉션을 참고하세요.
레코드 선언#
<name> AS <Type>
<name> AS <Type> = <record>
<name> AS <Type> = NEW <Type>(<arguments>)
<name> AS <Type>[<last index>]
DIM <name>(<last index>) AS <Type>
NewList <name>.<Type>()
NewMap <name>.<Type>()
- 레코드 변수는
AS로 선언해야 합니다. 선언한 적 없는 이름에q.x = 1을 쓰면 컴파일은 되지만 프로그램이 "q is not defined"로 멈춥니다. - 타입 이름은 대소문자를 무시합니다.
hero AS ship도 됩니다. - 모든 선언은 새 레코드를 만들고,
New메서드가 있으면 실행합니다. 레코드 배열의 모든 칸, 레코드 리스트의 모든AddElement, 모든 새 맵 항목, 새 레코드 안의 모든 레코드 필드도 마찬가지입니다.
필드에 접근하기#
| 레코드가 있는 곳 | 철자 |
|---|---|
| 변수 | hero.fuel |
| 레코드 안의 레코드 | s.pos.x |
| 배열 칸 | fleet(2).fuel 또는 fleet[2].fuel |
| 리스트의 현재 요소 | foes().hp |
| 맵 항목 | bag("sword").qty |
백슬래시 철자 hero\fuel은 WITH 블록의 것입니다. 블록 밖에서는 "Not a BASIC statement"로 거부됩니다.
⚠️ 리스트 요소나 맵 항목을 통한 쓰기는 필드의 타입으로 변환되지 않습니다. foes().hp = 3.7은 정수 필드에 3.7을 유지합니다. 변수나 배열 칸을 통한 쓰기는 변환됩니다.
레코드는 값입니다#
TYPE Vec
x AS float
ENDTYPE
TYPE Ship
pos AS Vec
name AS string
ENDTYPE
a AS Ship
a.pos.x = 3
b AS Ship
b = a
b.pos.x = 9
Console(Str(a.pos.x) + " " + Str(b.pos.x)) ' 3 9
선언된 변수에 레코드를 대입하면 깊은 복사가 만들어집니다. 중첩된 레코드, 배열, 리스트, 맵도 함께 복사됩니다. 그러면 두 레코드는 서로 독립적입니다.
x AS T = other, 리스트 요소(l() = rec), 맵 항목(m("k") = rec)에서도 같은 복사가 일어납니다. 레코드를 FUNCTION에 넘길 때도 매개변수가 REF가 아니면 복사됩니다. 함수를 참고하세요.
⚠️ 세 가지 대입은 복사하지 않고 공유합니다.
| 대입 | 결과 |
|---|---|
fleet(1) = hero, 배열 칸 | 그 칸과 hero가 같은 레코드 |
s.pos = v, 레코드 필드 | 그 필드와 v가 같은 레코드 |
w = hero, w가 AS Ship으로 선언된 적 없음 | w와 hero가 같은 레코드 |
이 중 어느 것이든 한 이름을 통한 변경이 다른 이름에도 보입니다. 배열 칸이나 필드에 독립적인 복사본을 저장하려면 필드를 하나씩 복사하세요.
TYPE Vec
x AS float
y AS float
ENDTYPE
DIM path(1) AS Vec
v AS Vec
v.x = 1
v.y = 2
path(0).x = v.x
path(0).y = v.y
v.x = 7
Console(Str(path(0).x)) ' 1, 그 칸은 자기 값을 유지함
레코드 비교. 두 레코드에 대한 a = b는 필드가 같은지가 아니라 같은 레코드인지를 묻습니다. 필드가 같아도 별개의 두 레코드는 절대 =가 아닙니다. 필요한 필드를 직접 비교하세요.
WITH#
WITH <record>
\<field> …
ENDWITH
TYPE Vec
x AS float
y AS float
ENDTYPE
TYPE Ship
pos AS Vec
name AS string
fuel AS integer
ENDTYPE
s AS Ship
WITH s
\name = "Comet"
\fuel = 80
\pos\x = 1.5
\pos.y = 2.5
Console(\name + " " + Str(\fuel) + " " + Str(\pos\x) + " " + Str(\pos\y)) ' Comet 80 1.5 2.5
ENDWITH
- 블록 안에서
\field는 줄의 어디서나<record>.field를 뜻합니다. - 연쇄는
\pos\x또는\pos.x로 씁니다. - 블록은
ENDWITH또는END WITH로 닫습니다. - 레코드는 어떤 식이든 가능합니다.
WITH fleet(i),WITH foes(). - 문자열과 주석 안의 텍스트는 건드리지 않습니다.
"C:\games"는 경로로 남습니다. - WITH 블록은 중첩되지 않습니다. WITH 안의 WITH는 컴파일 오류입니다. "Nested WITH blocks are not supported".
⚠️ 레코드 식은 \마다 다시 읽힙니다. 컴파일러는 각 필드 앞에 그 식을 씁니다. WITH fleet(i)에서 블록 안의 i를 바꾸면 이후 줄이 다른 칸으로 옮겨 갑니다.
WITH hero는 WITH SPRITE s가 아닙니다. WITH 뒤에 단어가 하나면 레코드 블록입니다. 단어가 둘이고 첫 번째가 명령어 계열의 이름이면 명령어 단축 표기가 됩니다. \position 100, 200은 SpritePosition(s, 100, 200)을 호출합니다. 단축 표기를 참고하세요.
METHOD#
TYPE <Name>
<fields>
METHOD <method>([<parameters>])
<statements>
[EXITMETHOD [<value>]]
ENDMETHOD
ENDTYPE
TYPE Counter
value AS integer
METHOD Add(amount AS integer)
SELF.value = SELF.value + amount
EXITMETHOD SELF.value
ENDMETHOD
METHOD Reset()
SELF.value = 0
ENDMETHOD
ENDTYPE
c AS Counter
Console(Str(c.Add(5))) ' 5
Console(Str(c.Add(3))) ' 8
c.Reset()
Console(Str(c.value)) ' 0
- 메서드는 자기 TYPE 안에서 필드들과 함께 선언합니다.
SELF는 메서드가 호출된 레코드입니다.SELF.value에 쓰면 그 레코드가 바뀌며, 배열 칸이나 리스트 요소일 때도 마찬가지입니다.counters(2).Reset(),counters().Add(3).record.method(arguments)로 호출합니다. 문장으로도, 식 안에서도 쓸 수 있습니다. 메서드 이름은 대소문자를 무시합니다.EXITMETHOD는 메서드를 빠져나옵니다.EXITMETHOD <value>는 값을 반환합니다.RETURN <value>도 같은 일을 합니다.- 괄호는 비어 있어도 필수입니다.
METHOD Reset(). - 메서드는 내부적으로 FUNCTION입니다. 타입이 있는 매개변수, 기본값,
LOCAL변수,OPTIONAL이 모두 동작합니다. 함수를 참고하세요. - 메서드는
SELF를 통해 다른 메서드를 호출할 수 있습니다.SELF.Reset(). - 레코드의 복사본은 원본과 같은 메서드를 가집니다.
- DO 루프가 있는 프로그램에서 메서드가 쓰는 프로그램 변수는 다른 FUNCTION과 마찬가지로
GLOBAL로 선언해야 합니다.
컴파일 시점에 거부되는 것: TYPE 밖의 METHOD("METHOD requires a containing TYPE"), METHOD 안의 METHOD, 한 TYPE 안의 같은 이름 메서드 두 개, ENDMETHOD 뒤의 값. ENDFUNCTION과 달리 ENDMETHOD는 값을 받지 않으며 END METHOD는 올바른 철자가 아닙니다.
TYPE Counter
value AS integer
METHOD Get()
ENDMETHOD SELF.value
ENDTYPE
⚠️ 메서드 이름을 Length, Find, Sort, Insert, Remove로 짓지 마세요. 이 이름들은 배열 멤버의 것이며, 호출하면 실행될 때 프로그램이 멈춥니다.
New: 생성자#
New라는 이름의 메서드는 그 타입의 레코드가 만들어질 때마다 실행됩니다.
TYPE Counter
value AS integer
METHOD New(start AS integer = 0)
SELF.value = start
ENDMETHOD
ENDTYPE
a AS Counter
b AS Counter = NEW Counter(7)
Console(Str(a.value) + " " + Str(b.value)) ' 0 7
- **
NEW <Type>(<arguments>)**는 레코드를 만들고 인자를New에 넘깁니다. 선언에서도, 이후의 대입에서도 동작합니다.b = NEW Counter(2). - 그 외의 모든 생성은
New를 인자 없이 호출합니다.x AS T,DIM a(n) AS T의 각 칸, 레코드 리스트의AddElement, 새 맵 항목, 그 타입의 레코드 필드가 그렇습니다. - 복사는
New를 실행하지 않습니다.b = a와x AS T = other는 필드를 있는 그대로 복사합니다.
⚠️ New의 모든 매개변수에 기본값을 주세요. 대부분의 생성이 인자를 넘기지 않으므로, 기본값 없는 타입 지정 매개변수는 프로그램을 멈추게 하고("BASIC integer requires an integral value"), 타입 없는 매개변수는 필드를 값 없이 남깁니다.
DELETE와 Delete 메서드#
DELETE <record variable>
DELETE <array>[<index>]
DELETE <record>.<field>
alive = 0
TYPE Enemy
hp AS integer
METHOD New()
alive = alive + 1
ENDMETHOD
METHOD Delete()
alive = alive - 1
ENDMETHOD
ENDTYPE
e AS Enemy
f AS Enemy
Console(Str(alive)) ' 2
DELETE e
Console(Str(alive)) ' 1
DELETE는 레코드에Delete메서드가 있으면 호출한 다음, 레코드를 삭제됨으로 표시합니다.- 변수에 대해서는
DELETE가 변수도 비웁니다. 이후 그 필드를 읽으면 프로그램이 멈춥니다. - 배열 칸이나 필드에 대해서는 칸이 남지만, 그 메서드를 호출하면 프로그램이 "BASIC record has been deleted"로 멈춥니다. 경로에는 대괄호를 씁니다.
DELETE fleet[2].DELETE fleet(2)는 거부됩니다. Delete는DELETE를 통해서만 실행됩니다. 변수를 다시 대입하거나 프로그램이 끝에 도달해도 호출되지 않습니다.
PureBasic의 Structure#
Structure … EndStructure는 한 줄 형태를 포함해 TYPE … ENDTYPE의 또 다른 철자로 받아들여집니다. 단축 표기를 참고하세요.
Structure Size width height EndStructure
s AS Size
s.width = 2
Console(Str(s.width)) ' 2다른 BASIC에서 오셨다면#
| 쓰던 방식 | aukimi에서는 |
|---|---|
Type … End Type | TYPE … ENDTYPE |
Structure 안의 x.f (PureBasic) | x AS float |
With 밖의 p\x (PureBasic) | p.x |
AllocateStructure (PureBasic) | p AS Point, 또는 NEW Point() |
FreeStructure (PureBasic) | DELETE p |
END METHOD, ENDMETHOD value | ENDMETHOD, 그 앞에 EXITMETHOD value |
중첩된 With | 한 번에 WITH 하나 |