레코드와 메서드

필드를 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.5

TYPE … ENDTYPE#

TYPE <Name>
  <field>
  …
  [METHOD …]
ENDTYPE
필드 형태필드가 담는 것
name32비트 정수
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 TypeTYPE … 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 valueENDMETHOD, 그 앞에 EXITMETHOD value
중첩된 With한 번에 WITH 하나