프로그램 구조
컴파일러가 받아들이는 프로그램을 쓰는 법을 다룹니다. 줄과 콜론, 여섯 가지 주석 형태, 이름과 대소문자, 문자열, 괄호 규칙, 줄을 거부하는 검사를 설명합니다.
한 줄 요약#
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은 안전하지 않습니다.
⚠️ 블록 주석에는 세 가지 규칙이 있습니다#
-
REMSTART,REMEND,/*는 줄의 시작에 와야 합니다.x = 1 REMSTART는 블록 주석이 아닙니다. -
/*가 있는 줄의 모든 것이 주석이고,*/뒤의 나머지도 주석입니다. 거기에 쓴 코드는 실행되지 않습니다./* setup */ Console("never shown") Console("shown") ' shown -
블록 안의 줄은 한 단어 뒤에
:가 오는 형태로 시작하면 안 됩니다. 컴파일러가TODO:나Note:를 레이블로 읽고 프로그램을 거부합니다.REMSTART TODO: tidy this up REMENDBASIC label TODO requires RETURNTODO - 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") |
값을 보려고 쓰던 PRINT | Console(...): Print는 게임 화면에 그립니다 |
10 GOTO 20 | 줄 번호 없음. 레이블을 쓰세요 |
줄을 잇는 _ | 한 줄에 문장 하나 |
문자열 안의 "" | \" 또는 Chr(34) |
&HFF, $FF | 0xFF |
pi | PI |
; comment | ' comment |