오류

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.codeTHROW에 준 코드, 또는 ""
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$
ENDTRY

THROW#

THROW <value>

THROW는 CATCH가 받을 수 있는 오류를 일으킵니다. 던지는 값이 필드를 결정합니다.

던지는 것messagecode
문자열: 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_STOP2, 기본값프로그램을 멈추거나, 둘러싼 TRY의 CATCH로 이동
#AK_ERROR_REPORT1오류를 콘솔에 쓰고, 중립 값을 반환하고, 프로그램은 계속됨
#AK_ERROR_IGNORE0조용히 중립 값을 반환하고, 프로그램은 계속됨

중립 값은 숫자를 반환하는 명령어에는 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 0BASIC integer division by zero
1 / 0을 AS integer 변수에 저장BASIC integer requires a finite value
FOR i = 1 TO 5 STEP 0BASIC FOR STEP cannot be zero
해제된 핸들에 GetRef 또는 SetRefBASIC reference handle has been released
받아들이지 않는 개수의 인자로 호출한 명령어BASIC classique command <name> received <n> argument(s); expected …

타입 없는 변수에서 1 / 0은 오류를 일으키지 않습니다. Infinity를 줍니다.

잡히지 않은 오류가 가는 곳#

프로그램잡히지 않은 런타임 오류가 하는 일
순차형 프로그램, 또는 DO … LOOP그 줄에서 프로그램을 멈춤
수명 주기 함수 (update, onCollisionEnter…)오류를 보고함. 엔진이 다음 프레임이나 이벤트에 함수를 다시 호출하므로 오류가 반복됨

수명 주기 함수는 함수를, 태스크 안의 오류는 게임 루프와 태스크를 참고하세요.

클래식 방언과의 비교#

방언가진 것aukimi에서는
AGK0, 1, 2를 쓰는 SetErrorMode, GetLastError, GetErrorOccurred같은 모드와 값이며 동사가 없습니다. ErrorMode(...), LastError(), ErrorOccurred()
DarkBASIC Pro구조화된 오류 없음TRY / CATCH / FINALLY
PureBasicOnErrorCall, OnErrorGotoTRY / CATCH. 프로그램당 하나가 아니라 블록당 하나의 핸들러
Visual BasicOn Error Resume Next, On Error GoTo명령어에는 ErrorMode(#AK_ERROR_IGNORE), 나머지에는 TRY