프로그램 구조

컴파일러가 받아들이는 프로그램을 쓰는 법을 다룹니다. 줄과 콜론, 여섯 가지 주석 형태, 이름과 대소문자, 문자열, 괄호 규칙, 줄을 거부하는 검사를 설명합니다.

한 줄 요약#

BASIC 프로그램은 줄의 목록입니다. 한 줄에는 문장 하나가 들어가거나, :로 구분한 여러 문장이 들어갑니다. 컴파일러는 실행 전에 프로그램 전체를 읽고, 이해할 수 없는 줄은 추측하지 않고 거부합니다.

이 장은 프로그램의 형태를 다룹니다. 프로그램이 다루는 값은 변수와 타입에, 연산자는 상수와 연산자에 있습니다.

줄과 문장#

<statement>
<statement> : <statement> [: <statement> ...]
<label>:
<label>: <statement> [: <statement> ...]
x = 10
y = 20 : total = x + y
Console(Str(total))   ' 30
  • 한 줄에 문장 하나, 또는 :로 구분한 여러 문장.
  • 들여쓰기는 자유입니다. 줄 앞의 공백과 탭은 아무 의미가 없습니다. 빈 줄은 어디에나 둘 수 있습니다.
  • 문자열 안이나 괄호 안의 :는 줄을 나누지 않습니다. "time: 12:30"은 하나의 문자열로 남습니다.
  • 블록을 한 줄에 쓸 수 있습니다. FOR i = 1 TO 5 : total = total + i : NEXT.

한 줄짜리 IF는 THEN 뒤의 모든 것을 유지합니다#

THEN 뒤의 모든 :는 IF에 속합니다. 조건이 참일 때만 모든 문장이 실행됩니다.

lives = 0
IF lives = 0 THEN Console("Game over") : lives = 3
Console(Str(lives))   ' 3

자세한 내용은 제어 흐름에 있습니다.

레이블#

줄 맨 앞에서 이름 뒤에 :가 오면 레이블입니다. GOSUB와 GOTO의 목적지입니다. 레이블 줄에 문장을 함께 둘 수 있습니다.

GOSUB Greet
Console("back")   ' 두 번째로 출력됨
END
Greet: Console("hello") : RETURN

⚠️ 이 규칙 때문에, 줄의 첫 단어 바로 뒤에 오는 :는 항상 레이블을 선언합니다. start: x = 1은 x = 1을 본문으로 가진 레이블 start이고, 컴파일러는 그 RETURN을 요구합니다. BASIC label start requires RETURN.

존재하지 않는 것#

클래식 기능aukimi에서는
줄 번호 (10 x = 1)거부됨: Not a BASIC statement
줄 잇기 (줄 끝의 _)거부됨: 문장을 한 줄에 쓰세요
주석으로서의 ;주석이 아닙니다. 그 뒤의 텍스트는 코드로 컴파일됩니다

Markdown 코드 펜스(백틱 세 개, 언어 이름은 있어도 없어도 됨)만 있는 줄은 무시됩니다. 펜스가 그대로 붙은 채 웹 페이지에서 복사한 코드도 실행되며, 줄 번호도 정확하게 유지됩니다.

주석#

여섯 가지 형태를 받아들입니다.

형태위치예
'어디서나. 줄의 나머지가 주석x = 1 ' note
//어디서나. 줄의 나머지가 주석x = 1 // note
REM줄의 시작, 또는 문장 뒤REM note
` (백틱)줄의 시작, 또는 문장 뒤x = 1 ` note
REMSTART … REMEND블록. 두 단어 모두 자기 줄에서 시작아래 참고
/* … */블록. /*가 줄의 시작아래 참고
' 한 줄 전체가 주석
REM 한 줄 전체가 주석인 또 다른 형태
// C 스타일 한 줄 주석
x = 1   ' 문장 뒤
y = 2   // 문장 뒤에도 가능
z = 3   ` 백틱 형태
REMSTART
메모 블록
여러 줄에 걸쳐
REMEND
/* C 스타일 블록
   여러 줄에 걸쳐 */
Console(Str(x + y + z))   ' 6

' 또는 //를 쓰세요. 어디서나 안전한 형태는 이 둘뿐입니다. 나머지 넷은 다른 방언의 코드가 계속 컴파일되도록 존재합니다.

⚠️ REM이나 백틱 주석 안의 :는 줄을 나눕니다#

줄 분리기는 '와 //에서 멈춥니다. REM이나 백틱에서는 멈추지 않습니다. 그 뒤의 콜론은 주석을 끝내고, 나머지는 코드로 컴파일됩니다.

x = 1 REM note: this part is compiled
Not a BASIC statement: this part is compiled

콜론이 들어 있는 한 줄 전체 백틱 주석에서도 같은 일이 일어납니다. 줄 전체가 REM인 경우는 안전하지만, 문장 뒤의 REM은 안전하지 않습니다.

⚠️ 블록 주석에는 세 가지 규칙이 있습니다#

  1. REMSTART, REMEND, /*는 줄의 시작에 와야 합니다. x = 1 REMSTART는 블록 주석이 아닙니다.

  2. /*가 있는 줄의 모든 것이 주석이고, */ 뒤의 나머지도 주석입니다. 거기에 쓴 코드는 실행되지 않습니다.

    /* setup */ Console("never shown")
    Console("shown")   ' shown
  3. 블록 안의 줄은 한 단어 뒤에 :가 오는 형태로 시작하면 안 됩니다. 컴파일러가 TODO:나 Note:를 레이블로 읽고 프로그램을 거부합니다.

    REMSTART
    TODO: tidy this up
    REMEND
    BASIC label TODO requires RETURN
    

    TODO - tidy this up이라고 쓰거나 ' 줄을 사용하세요.

닫히지 않은 블록은 오류입니다. REMSTART requires REMEND 또는 /* requires */.

대소문자와 이름#

모든 것이 대소문자를 구분하지 않습니다. 키워드, 명령어 이름, 변수, 사용자 함수, 레코드 필드, 상수 모두 그렇습니다. IF, If, if는 같은 단어입니다. Console, CONSOLE, console은 같은 명령어입니다.

이름의 첫 번째 철자가 유지되고, 이후의 철자는 모두 그것으로 다시 쓰입니다.

Score = 1
SCORE = SCORE + 1
score = score + 1
Console(Str(sCoRe))   ' 3
if score = 3 then Console("keywords in lower case work too")

예외가 둘 있습니다.

이름규칙
PI대문자만 가능. pi나 Pi는 알 수 없는 이름이며, 프로그램이 … is not defined로 멈춥니다.
TRUE, FALSE, NULL대소문자 무관.
area = PI * 2 ^ 2
Console(Str(area))   ' 12.566370614359172

이름 쓰기#

  • 글자, 숫자, _. 글자나 _로 시작합니다.
  • 변수는 시길($, #, %, &)로 끝날 수 있습니다. 시길이 하는 일은 변수와 타입에 있습니다.
  • 상수는 앞에 #를 붙여 씁니다. #MAX_LIVES. 상수와 연산자를 참고하세요.

철자가 같아도 되는 이름#

쌍같은 철자 허용?
변수와 레코드 필드 (speed와 s.speed)예. 서로 만나지 않습니다
변수와 사용자 FUNCTION예
변수와 카탈로그 명령어 (left와 Left)예. 프로그램이 name = …으로 변수에 값을 대입한 뒤부터
사용자 FUNCTION과 카탈로그 명령어예. 그리고 사용자 함수가 우선합니다
상수와 변수 (#SPEED와 SPEED)⚠️ 안 됩니다: 철자가 같으면 프로그램이 시작되지 않습니다
TYPE Ship
  speed
ENDTYPE
s AS Ship
s.speed = 4
speed = 9
Console(Str(s.speed) + " " + Str(speed))   ' 4 9
left = 10
x = left + 1
Console(Str(x) + Left("abc", 1))   ' 11a
FUNCTION Sin(v)
ENDFUNCTION v * 2
Console(Str(Sin(90)))   ' 180: 카탈로그의 Sin이 아니라 직접 만든 Sin

⚠️ JavaScript 단어는 자유롭지 않습니다#

BASIC은 JavaScript로 컴파일됩니다. JavaScript 키워드로 이름 지은 변수는 컴파일은 되지만 프로그램이 시작되지 않습니다.

class = 3

다음 이름은 피하세요. class, const, debugger, default, enum, export, extends, import, in, instanceof, let, new, super, switch, this, throw, typeof, var, void, await. _b나 __basic으로 시작하는 이름과 nextFrame도 피하세요. 컴파일러가 자체적으로 사용합니다.

문자열#

"<text>"
  • 큰따옴표만 사용합니다. '는 주석을 시작하므로 'text'는 문자열이 아닙니다.
  • 이스케이프는 둘뿐입니다. 따옴표는 \", 백슬래시는 \\.
  • 그 외의 백슬래시는 그냥 백슬래시입니다. Windows 경로를 쓴 그대로 쓸 수 있고, \n은 줄바꿈이 아니라 두 글자입니다.
  • 문자열은 한 줄 안에 있어야 합니다.
path$ = "media\background5.jpg"
quote$ = "She said \"hi\""
slash$ = "a\\b"
Console(path$)    ' media\background5.jpg
Console(quote$)   ' She said "hi"
Console(slash$)   ' a\b

줄바꿈이나 따옴표가 필요하면 Chr로 문자열을 만드세요.

twoLines$ = "first" + Chr(10) + "second"
quoted$ = Chr(34) + "aukimi" + Chr(34)
Console(quoted$)   ' "aukimi"

⚠️ QBasic과 Visual Basic의 겹따옴표("")는 지원하지 않습니다. 컴파일은 되지만 프로그램이 시작되지 않습니다. \" 또는 Chr(34)를 쓰세요.

say$ = "say ""hi"""

⚠️ \" 뒤에는 같은 문자열 안에 :나 '를 두지 마세요. 줄 분리기가 이스케이프를 몰라서 문자열이 거기서 끝났다고 생각합니다.

label$ = "a\"b: c"
Not a BASIC statement: c"

이런 문자열에는 Chr(34)를 쓰세요. {holes}가 있는 문자열은 $"…"로 씁니다. 단축 표기를 참고하세요.

리터럴#

종류예
정수42, -7
소수3.5, .5, 5.
지수1.25e2, 1.5E-3
16진수0x1F, 0XFF
8진수0c17
2진수%1010
문자열"text"
참, 거짓, 없음TRUE, FALSE, NULL
πPI
d = 1.25e2
e = 0x1F
f = 0c17
g = %1010
Console(Str(d) + " " + Str(e) + " " + Str(f) + " " + Str(g))   ' 125 31 15 10

형식이 잘못된 리터럴은 그 줄에서 거부됩니다. Malformed BASIC numeric literal: 0x1G.

⚠️ $FF(PureBasic)와 &HFF(QBasic, Visual Basic)는 여기서 16진수가 아닙니다. 0xFF라고 쓰세요.

각 타입이 이 값을 저장하는 방식은 변수와 타입에 있습니다.

괄호 규칙#

명령어 호출에는 항상 괄호가 붙습니다. 인자가 없어도 마찬가지입니다.

<Command>([<argument> [, <argument> ...]])
elapsed# = Timer()
width = DeviceWidth()
Sync()

AGK, DarkBASIC, PureBasic의 괄호 없는 형태는 거부됩니다.

PRINT "hello"
Sync
x = DeviceWidth
BASIC commands require parentheses: Print(...)
BASIC commands require parentheses: Sync(...)
BASIC commands require parentheses: DeviceWidth(...)

이 규칙 덕분에 컴파일러가 명령어와 변수를 구분할 수 있습니다. 프로그램이 값을 대입하는 이름(left = 10)은 변수이고, 뒤에 (가 오는 이름은 호출입니다.

⚠️ GLOBAL, LOCAL, CATCH로만 사용되고 name = … 형태로 대입된 적이 없는 변수는, 여전히 같은 이름의 명령어로 읽힙니다. 함수 안의 LOCAL left = 3은 BASIC commands require parentheses: Left(...)로 거부됩니다. 다른 이름을 고르세요.

두 가지 검사#

모든 줄에서 두 가지 검사가 실행됩니다.

알 수 없는 명령어#

이름이 카탈로그 명령어, 컴파일러 내장 함수, 사용자 FUNCTION, 배열, 리스트, 맵 어느 것도 아닌 호출은 거부됩니다. 철자가 비슷한 카탈로그 명령어가 있으면 컴파일러가 그 이름을 알려 줍니다.

Prnt("hello")
Unknown BASIC command: Prnt() — did you mean Print()?
Blorp(1, 2)
Unknown BASIC command: Blorp()

제안은 이름이 한 글자만 다를 때(짧은 이름, 네 글자까지) 또는 두 글자만 다를 때(더 긴 이름) 나옵니다.

문장이 아님#

문장은 대입이거나, 호출이거나, 키워드로 시작해야 합니다. 그 밖의 것은 거부되며, 메시지에 줄의 앞부분이 인용됩니다.

go to the shop
VAR n = 5
Not a BASIC statement: go to the shop
Not a BASIC statement: VAR n = 5

검사가 잡지 못하는 것#

  • 점 뒤의 호출(obj.method(...))은 카탈로그와 대조하지 않습니다. 이 덕분에 JavaScript 오브젝트에 접근할 수 있습니다.
  • 끝나지 않은 식, 예를 들어 x = 1 +나 x =는 두 검사를 모두 통과합니다. 그러면 프로그램이 시작되지 않습니다.
  • 읽기만 하고 대입하지 않은 이름은 컴파일되고, 실행될 때 프로그램을 멈춥니다(… is not defined). 변수와 타입을 참고하세요.

Print는 그리고, Console은 기록합니다#

명령어하는 일
Print(...)게임 화면에 텍스트를 그립니다. 게임은 매 프레임 호출합니다
Console(...)에디터 콘솔에 한 줄을 씁니다
Debug(...)Console과 같으며, PureBasic의 이름입니다
ConsoleWarning(...), ConsoleError(...)콘솔에 경고 또는 오류 줄을 씁니다
ClearConsole()콘솔을 비웁니다

작업 중에 값을 확인하려면 Console을 쓰세요. 이 매뉴얼의 모든 예제가 그렇게 합니다.

최소한의 프로그램#

순차형: 한 번 실행#

프레임 루프가 없으면 프로그램은 위에서 아래로 한 번 실행되고 멈춥니다. 테스트, 도구, 콘솔에 쓰기만 하는 프로그램에 알맞은 형태입니다.

name$ = "aukimi"
Console("Hello, " + name$)   ' Hello, aukimi

프레임 루프형: 매 프레임 실행#

게임은 설정을 DO 위에 두고, 프레임 본문을 DO와 LOOP 사이에 둡니다. Sync()가 각 프레임을 끝냅니다.

frames = 0
DO
  frames = frames + 1
  Print("Frame " + Str(frames))
  Sync()
LOOP

Sync()가 없는 루프는 화면이 그려질 틈을 주지 않으므로 거부됩니다.

DO
  x = x + 1
LOOP
DO/LOOP requires SYNC() so the loop can yield a frame

⚠️ DO … LOOP가 있는 프로그램에서 FUNCTION은 DO 위에서 설정한 일반 변수를 보지 못합니다. 공유할 값은 GLOBAL로 선언하세요. 이유와 해결책은 변수와 타입에 있습니다.

프로그램당 최상위 DO … LOOP는 하나입니다. 프레임, Wait, Sleep, 태스크에 관한 나머지는 게임 루프와 태스크에 있습니다.

다른 BASIC에서 오셨다면#

쓰던 방식aukimi에서는
PRINT "x", Sync, Debug "x"Print("x"), Sync(), Debug("x")
값을 보려고 쓰던 PRINTConsole(...): Print는 게임 화면에 그립니다
10 GOTO 20줄 번호 없음. 레이블을 쓰세요
줄을 잇는 _한 줄에 문장 하나
문자열 안의 ""\" 또는 Chr(34)
&HFF, $FF0xFF
piPI
; comment' comment