오류
TRY, CATCH, FINALLY로 오류를 잡고, 던지고, 정리하고, ErrorMode로 실패한 명령어의 동작을 정하고, 에디터가 보고하는 오류를 읽는 법을 다룹니다.
한 줄 요약#
프로그램은 두 종류의 오류를 만납니다. 첫 번째 종류는 아무것도 실행되기 전에 컴파일러가 찾습니다. 두 번째 종류는 게임이 실행되는 동안 일어나며, TRY … CATCH로 잡지 않으면 프로그램을 멈춥니다. 카탈로그 명령어에는 옵션이 하나 더 있습니다. ErrorMode가 명령어의 실패를 멈출지, 보고할지, 조용히 넘길지 정합니다.
두 종류의 오류#
| 컴파일 오류 | 런타임 오류 | |
|---|---|---|
| 시점 | 프로그램이 시작되기 전 | 실행되는 동안 |
| 예 | 철자를 틀린 명령어, IF 없는 ENDIF, CATCH 밖의 RETHROW | 실패한 명령어, THROW, a DIV 0, 해제된 핸들 |
| 일어나는 일 | 모든 오류가 나열되고 아무것도 실행되지 않음 | TRY가 잡지 않으면 프로그램이 그 줄에서 멈춤 |
| 잡을 수 있나 | 아니요, 소스를 고치세요 | 예, TRY / CATCH로 |
콘솔에 나오는 것#
두 종류 모두 에디터의 콘솔에 최대 세 줄로 나옵니다.
BASIC · Compilation · <file> · Line <n>, column 1
SyntaxError: <message>
BASIC · Execution · <file> · Line <n>, column <c>
<name>: <message>
Command: <the failing call>
- 파일은 스크립트이거나,
#INCLUDE로 프로그램을 나눈 경우 그 줄이 있는 모듈입니다. 전처리기를 참고하세요. Command:줄은 카탈로그 명령어가 실패했을 때 나타납니다. 받은 값과 함께 호출을 보여 줍니다. 예:MemblockByte(999, 0).- 오류 줄을 더블클릭하면 스크립트가 그 줄에서 열립니다.
명령어 실패는 다음과 같이 보입니다.
RangeError: BASIC MemblockByte(999, 0) failed: Classic BASIC memory block 999 does not exist. Create or load the referenced resource before running this command.
Command: MemblockByte(999, 0)
⚠️ 컴파일 단계에 나오는 JavaScript 메시지는 컴파일러의 빈틈을 뜻합니다. "Unexpected identifier", "missing ) after argument list", "await is only valid in async functions", "Identifier … has already been declared"는 컴파일러가 거부했어야 할 형태를 받아들였을 때 나옵니다. 각 장은 그런 형태를 ⚠️로 표시하고 제대로 동작하는 철자를 알려 줍니다.
TRY, CATCH, FINALLY#
TRY
<statements>
[CATCH [<name>[$]]
<statements>]
[FINALLY
<statements>]
ENDTRY
TRY
THROW "out of ammo"
CATCH problem$
Console("caught: " + problem$)
FINALLY
Console("cleanup")
ENDTRY
Console("after: " + problem$)
프로그램은 caught: out of ammo, 그다음 cleanup, 그다음 after: out of ammo를 출력합니다.
CATCH는TRY부분에서 무언가 실패했을 때만 실행됩니다.FINALLY는 항상 실행됩니다. 정상 종료 후, 오류 후,EXITFUNCTION이나RETURN후,END후, 블록 밖으로GOTO한 후에도 실행됩니다.CATCH와FINALLY는 각각 선택 사항이지만TRY에는 둘 중 하나는 필요합니다. "TRY requires CATCH or FINALLY".- 순서는 고정입니다.
TRY, 그다음CATCH, 그다음FINALLY.CATCH는 많아야 하나입니다. 오류 종류별CATCH는 없습니다. 대신CATCH안에서 오류의name이나code를 검사하세요. ENDTRY와END TRY는 같습니다.TRY는 어디서나 동작합니다. 메인 프로그램, 프레임 루프,FUNCTION,update같은 수명 주기 함수 안에서도 됩니다.
이 블록의 컴파일 오류:
| 메시지 | 원인 |
|---|---|
CATCH without TRY, FINALLY without TRY, ENDTRY without TRY | 여는 TRY가 없음 |
Duplicate CATCH in TRY, Duplicate FINALLY in TRY | 같은 종류의 절이 두 번째로 나옴 |
CATCH cannot follow FINALLY | 순서가 틀림 |
TRY requires ENDTRY | 블록이 닫히지 않음 |
catch 변수#
CATCH 뒤의 이름이 오류를 받습니다. 시길이 무엇을 받을지 정합니다.
| 쓰는 것 | 변수가 담는 것 |
|---|---|
CATCH problem$ | 문자열로 된 메시지 |
CATCH problem | 필드 네 개를 가진 읽기 전용 레코드 |
CATCH | 없음. 오류를 잡아서 버림 |
| 필드 | 내용 |
|---|---|
problem.name | 오류의 종류. THROW는 Error, 그 밖의 것은 RangeError, TypeError… |
problem.message | 메시지 |
problem.code | THROW에 준 코드, 또는 "" |
problem.command | 실패한 명령어 호출. 예: MemblockByte(999, 0), 또는 "" |
TRY
value = MemblockByte(999, 0)
CATCH failure
Console(failure.name) ' RangeError
Console(failure.command) ' MemblockByte(999, 0)
Console(failure.message) ' BASIC MemblockByte(999, 0) failed: Classic BASIC memory block 999 does not exist. …
ENDTRY
첫 번째 예제에서 보듯, 변수는 ENDTRY 뒤에도 읽을 수 있습니다. FUNCTION 안에서는 그 함수에 속합니다.
⚠️ catch 변수에는 고유한 이름을 주세요. 같은 이름이 같은 스코프의 다른 곳에서 TRY 앞이든 뒤든 선언되거나 대입되면, 컴파일러는 받아들이지만 프로그램이 시작될 수 없습니다("Identifier … has already been declared"). 메시지를 보관하려면 다른 변수에 복사하세요. report$ = "last error: " + problem$.
OPTION EXPLICIT
GLOBAL message$ = ""
TRY
THROW "x"
CATCH message$
ENDTRYTHROW#
THROW <value>
THROW는 CATCH가 받을 수 있는 오류를 일으킵니다. 던지는 값이 필드를 결정합니다.
| 던지는 것 | message | code |
|---|---|---|
문자열: THROW "save failed" | 그 문자열 | "" |
숫자: THROW 404 | 텍스트로 바뀐 숫자, 404 | "" |
message 필드와 선택적으로 code 필드가 있는 레코드 | message 필드 | code 필드 |
TYPE Failure
message AS string
code AS integer
ENDTYPE
f AS Failure
f.message = "save failed"
f.code = 7
TRY
THROW f
CATCH err
Console(err.message + " / " + Str(err.code)) ' save failed / 7
ENDTRY
- 값 없는
THROW는 컴파일 오류입니다. "THROW requires a value". - 던져진 오류는
CATCH가 받을 때까지 도중의 모든 함수를 벗어나므로, 함수가 던지고 호출한 쪽이 잡을 수 있습니다. THROW의name은 항상Error입니다.
OPTION EXPLICIT
GLOBAL attempts AS integer = 0
GLOBAL connected AS integer = 0
FUNCTION Connect()
attempts = attempts + 1
IF attempts < 3 THEN THROW "timeout"
ENDFUNCTION
WHILE connected = 0
TRY
Connect()
connected = 1
CATCH problem$
Console("attempt " + Str(attempts) + ": " + problem$)
ENDTRY
ENDWHILE
Console("connected after " + Str(attempts)) ' connected after 3
⚠️ 잡은 오류를 THROW하지 마세요. THROW failure는 그 메시지와 코드로 새 오류를 만듭니다. name이 Error가 되고 command는 사라집니다. 같은 오류를 그대로 넘기려면 RETHROW를 쓰세요.
RETHROW와 중첩된 블록#
RETHROW
RETHROW는 처리 중인 오류를 바깥의 다음 TRY로 그대로 보냅니다.
TRY
TRY
THROW "disk full"
CATCH inner$
Console("inner: " + inner$)
RETHROW
FINALLY
Console("inner finally")
ENDTRY
CATCH outer
Console("outer: " + outer.message)
ENDTRY
프로그램은 inner: disk full, 그다음 inner finally, 그다음 outer: disk full을 출력합니다. 안쪽 FINALLY가 바깥 CATCH보다 먼저 실행됩니다.
RETHROW는CATCH안(또는CATCH안에 중첩된 블록 안)에서만 허용됩니다. 그 밖에서는 "RETHROW requires an active CATCH block".- 값을 받지 않습니다. "RETHROW does not accept a value".
TRY블록은 깊이에 제한 없이 중첩됩니다. 오류는 가장 가까운 바깥CATCH로 갑니다.
END와 GOTO는 통과합니다#
END와 GOTO는 오류가 아니므로 CATCH가 보지 못합니다. 빠져나가는 길에도 FINALLY는 실행됩니다.
TRY
Console("before")
END
CATCH e
Console("caught END")
FINALLY
Console("finally runs")
ENDTRY
Console("never")
프로그램은 before, 그다음 finally runs를 출력하고 멈춥니다. 블록 밖의 레이블로 가는 GOTO도 같습니다. FINALLY가 실행된 다음 점프가 일어납니다.
명령어가 실패할 때: ErrorMode#
카탈로그 명령어는 실패할 수 있습니다. 없는 파일, 존재하지 않는 id, 범위를 벗어난 값 같은 경우입니다. 그때 어떻게 할지는 ErrorMode가 정합니다.
ErrorMode(<mode>)
ErrorMode()
| 모드 | 값 | 실패한 명령어가 하는 일 |
|---|---|---|
#AK_ERROR_STOP | 2, 기본값 | 프로그램을 멈추거나, 둘러싼 TRY의 CATCH로 이동 |
#AK_ERROR_REPORT | 1 | 오류를 콘솔에 쓰고, 중립 값을 반환하고, 프로그램은 계속됨 |
#AK_ERROR_IGNORE | 0 | 조용히 중립 값을 반환하고, 프로그램은 계속됨 |
중립 값은 숫자를 반환하는 명령어에는 0, 문자열을 반환하는 명령어에는 "", 그 밖에는 없음입니다.
ErrorMode(#AK_ERROR_IGNORE)
value = MemblockByte(999, 0)
Console(Str(value)) ' 0
IF ErrorOccurred() THEN Console("failed: " + LastError()) ' failed: Classic BASIC memory block 999 does not exist
Console(Str(ErrorMode())) ' 0
- 인자 없는
ErrorMode()는 현재 모드를 반환합니다. - 모드는 다음
ErrorMode(...)까지 유지됩니다. - 다른 값은 오류입니다. "Classic BASIC error mode must be #AK_ERROR_IGNORE, #AK_ERROR_REPORT, or #AK_ERROR_STOP".
ErrorMode는 카탈로그 명령어에만 적용되며, 그 밖의 것에는 적용되지 않습니다.THROW,DIV로 0 나누기, 해제된 핸들, 잘못된 개수의 인자로 호출한 명령어는 모든 모드에서 여전히 오류를 일으킵니다.
ErrorMode(#AK_ERROR_IGNORE)
a = 1
b = 0
TRY
c = a DIV b
CATCH e$
Console("caught: " + e$) ' caught: BASIC integer division by zero
ENDTRY
일부 명령어는 반환된 뒤에 작업을 마칩니다. 공유 시트, 파일 선택기, 탭 열기가 그렇습니다. 이들이 실패하면 프로그램을 멈추기에는 너무 늦습니다. 이들은 LastError와 ErrorOccurred를 설정하고, 모드가 #AK_ERROR_IGNORE가 아니면 콘솔에 씁니다.
LastError와 ErrorOccurred#
| 명령어 | 반환값 |
|---|---|
LastError() | 마지막 명령어 실패의 메시지. BASIC …() failed: 접두사와 힌트는 제외됩니다. 다음 실패까지 유지됩니다. |
ErrorOccurred() | 지난 호출 이후 명령어가 실패했으면 1, 그다음 0으로 초기화됨 |
둘 다 #AK_ERROR_STOP을 포함한 모든 모드에서 설정됩니다. CATCH 안에서도 읽을 수 있습니다.
TRY
value = MemblockByte(999, 0)
CATCH
ENDTRY
Console(Str(ErrorOccurred())) ' 1
Console(Str(ErrorOccurred())) ' 0
Console(LastError()) ' Classic BASIC memory block 999 does not exist
⚠️ ErrorOccurred()는 한 번만 읽으세요. 두 번째 호출은 이미 0으로 답합니다. 두 번 필요하면 결과를 저장하세요.
언어가 일으키는 런타임 오류#
명령어와 THROW 외에도, 몇몇 연산은 스스로 오류를 일으킵니다.
| 연산 | 메시지 |
|---|---|
a DIV 0 | BASIC integer division by zero |
1 / 0을 AS integer 변수에 저장 | BASIC integer requires a finite value |
FOR i = 1 TO 5 STEP 0 | BASIC FOR STEP cannot be zero |
해제된 핸들에 GetRef 또는 SetRef | BASIC reference handle has been released |
| 받아들이지 않는 개수의 인자로 호출한 명령어 | BASIC classique command <name> received <n> argument(s); expected … |
타입 없는 변수에서 1 / 0은 오류를 일으키지 않습니다. Infinity를 줍니다.
잡히지 않은 오류가 가는 곳#
| 프로그램 | 잡히지 않은 런타임 오류가 하는 일 |
|---|---|
순차형 프로그램, 또는 DO … LOOP | 그 줄에서 프로그램을 멈춤 |
수명 주기 함수 (update, onCollisionEnter…) | 오류를 보고함. 엔진이 다음 프레임이나 이벤트에 함수를 다시 호출하므로 오류가 반복됨 |
수명 주기 함수는 함수를, 태스크 안의 오류는 게임 루프와 태스크를 참고하세요.
클래식 방언과의 비교#
| 방언 | 가진 것 | aukimi에서는 |
|---|---|---|
| AGK | 0, 1, 2를 쓰는 SetErrorMode, GetLastError, GetErrorOccurred | 같은 모드와 값이며 동사가 없습니다. ErrorMode(...), LastError(), ErrorOccurred() |
| DarkBASIC Pro | 구조화된 오류 없음 | TRY / CATCH / FINALLY |
| PureBasic | OnErrorCall, OnErrorGoto | TRY / CATCH. 프로그램당 하나가 아니라 블록당 하나의 핸들러 |
| Visual Basic | On Error Resume Next, On Error GoTo | 명령어에는 ErrorMode(#AK_ERROR_IGNORE), 나머지에는 TRY |