BASIC 언어
BASIC 언어, 단어 하나씩
aukimi BASIC 방언의 모든 문, 지시문, 연산자와 컴파일러가 직접 제공하는 52개의 명령어: 리스트, 맵, 태스크, 핸들. 각 페이지에 구문, 각 부분의 의미, 컴파일되는 프로그램, 함정을 담았습니다.
카탈로그의 2,000개 이상 명령어(스프라이트, 사운드, 3D 등)는 다음에 있습니다: 명령어 레퍼런스.
제어 흐름 · 11
- IF문조건이 참일 때만 문장 블록을 실행합니다. ELSEIF와 ELSE 분기를 둘 수 있으며, 처음으로 참인 분기만 실행하고 나머지는 건너뜁니다.
- SELECT문값 하나를 CASE 값들과 비교하여 처음 일치한 분기를 실행합니다. 일치하는 것이 없으면 CASE DEFAULT가 실행됩니다.
- FOR문카운터가 시작 값에서 끝 값까지 가는 동안 블록을 반복하며, 한 번 돌 때마다 증가량을 더합니다.
- WHILE문조건이 참인 동안 블록을 반복합니다. 조건은 매번 반복 전에 검사하므로 본문이 한 번도 실행되지 않을 수 있습니다.
- REPEAT문조건이 참이 될 때까지 블록을 반복합니다. 조건은 매번 반복 후에 검사하므로 본문이 적어도 한 번은 실행됩니다.
- DO … LOOP문본문을 프레임마다 한 번 실행합니다. 고전 게임의 프레임 루프입니다. DO 앞의 코드는 먼저 한 번 실행되고, LOOP 뒤의 코드는 EXIT로 루프를 나왔을 때 한 번 실행됩니다.
- EXIT문가장 안쪽 반복문을 즉시 빠져나옵니다. 프로그램은 그 NEXT, ENDWHILE, UNTIL, LOOP 뒤에서 이어집니다.
- CONTINUE문현재 반복의 나머지를 건너뛰고 가장 안쪽 반복문의 다음 반복을 시작합니다.
- GOTO문레이블로 점프합니다. 뒤로 점프하면 코드를 반복하고, 앞으로 점프하면 코드를 건너뛰며 반복문을 빠져나올 수도 있습니다.
- GOSUB문레이블에서 시작하는 서브루틴을 RETURN까지 실행한 뒤 GOSUB 다음부터 이어 갑니다.
- END문프로그램을 즉시 멈춥니다. LOOP 뒤의 코드까지 포함해 그 뒤의 것은 아무것도 실행되지 않습니다.
프로그램 · 2
선언 · 13
- DIM문하나 이상의 차원을 가진 배열을 선언하며 경계값을 포함합니다. UNDIM은 배열을 비웁니다.
- GLOBAL문FUNCTION을 포함해 프로그램 전체가 공유하는 변수를 선언합니다. FUNCTION 안을 포함해 어디서나 동작합니다.
- LOCAL문FUNCTION을 한 번 호출하는 동안에만 속하는 변수를 선언합니다. 같은 이름의 프로그램 변수를 가립니다.
- AS문변수나 배열에 타입을 부여합니다. 이후 저장되는 모든 값은 그 타입으로 변환됩니다.
- OPTION EXPLICIT지시문선언을 필수로 만듭니다. 프로그램이 값을 쓰는 모든 이름은 먼저 선언되어야 하며, 그렇지 않으면 프로그램이 컴파일되지 않습니다.
- #CONSTANT지시문고정된 값에 이름을 붙입니다. 상수는 이름 앞에 #를 붙여 프로그램 어디서나 읽습니다.
- ENUMERATION문번호가 매겨진 상수를 줄마다 하나씩 선언합니다. ENUMERATIONBINARY는 줄마다 값을 두 배로 늘려 플래그에 씁니다.
- DATA문DATASECTION 안에 상수 값을 적습니다. READ는 그 값을 순서대로 하나씩 가져오고, RESTORE는 읽기 위치를 옮깁니다.
- INC / DEC문변수에 1 또는 지정한 값을 더하거나(INC) 뺍니다(DEC).
- FOREACH문리스트나 맵을 첫 요소부터 마지막 요소까지 순회합니다. 반복문 안에서는 이번 차례의 요소가 현재 요소입니다.
- Array members문점 뒤에 쓰는 멤버로 배열의 크기를 읽고, 크기를 바꾸고, 칸을 삽입, 삭제, 검색, 정렬합니다.
- NewList문리스트를 선언합니다. 순서가 있는 값들을 보관하며 현재 요소가 하나 있습니다. <name>()은 그 요소를 읽거나 씁니다.
- NewMap문맵을 선언합니다. 텍스트 키로 값을 저장합니다. <name>(<key>)는 항목 하나를 읽거나 쓰고, <name>()은 현재 항목을 읽거나 씁니다.
구조체와 함수 · 13
- FUNCTION문매개변수를 받고 값을 돌려줄 수 있는, 이름 붙은 코드 블록을 선언합니다. 현재 프레임 안에서 끝까지 한 번에 실행됩니다.
- Lifecycle functions문FUNCTION에 예약된 이름을 주어 엔진이 스스로 호출하게 합니다. 시작할 때 한 번, 매 프레임, 고정된 주기로, 또는 충돌, 트리거, 메시지, 애니메이션 이벤트가 일어날 때 호출됩니다.
- REF문복사본이 아니라 호출자의 변수 자체를 받는 FUNCTION 매개변수를 표시하여 함수가 그것을 바꿀 수 있게 합니다.
- @ handles문핸들을 만듭니다. 변수를 가리키는 값으로, 저장하고 전달하고 반환할 수 있으며 그것을 통해 변수를 읽고 쓸 수 있습니다.
- TYPE문레코드 타입을 선언합니다. 각자 타입을 가진, 이름 붙은 필드의 묶음입니다. 레코드는 값이며 선언된 변수에 대입하면 깊은 복사가 됩니다.
- METHOD문TYPE에 속하는 함수를 선언합니다. 안에서 SELF는 메서드가 호출된 레코드입니다.
- NEW문TYPE의 새 레코드를 만들고, New 메서드(생성자)가 있으면 그 메서드에 인수를 전달합니다.
- DELETE문레코드를 끝냅니다. Delete 메서드가 있으면 실행한 다음 레코드를 삭제된 것으로 표시합니다.
- WITH문블록 안에서 \field가 줄 어디에서나 <record>.field를 뜻하는 블록을 엽니다. 한 레코드를 다루는 줄이 많을 때 덜 쓰게 해 줍니다.
- WITH <family>문블록 안에서 \property가 한 객체에 대해 카탈로그 명령 <Family><Property>를 호출하는 블록을 엽니다. 그래서 id와 계열 이름을 한 번만 씁니다.
- Dot notation문명령 계열을 변수에 붙여, 프로그램 어디서나 s.position(100, 200)이 SpritePosition(s, 100, 200)을 호출하고 s.x가 SpriteX(s)를 읽게 합니다.
- $"…"연산자텍스트와 빈 칸으로 문자열을 만듭니다. 각 {expression}은 Str(expression)으로 바뀌고 문자열 전체가 이어붙이기가 됩니다.
- @expose지시문다음 줄의 최상위 대입을 인스펙터에 표시되는 설정으로 바꿉니다. 프로그램이 시작될 때 인스펙터에서 정한 값이 코드에 적힌 값을 대체합니다.
전처리기 · 5
- #INCLUDE지시문프로젝트의 BASIC 모듈의 줄들을 디렉티브 자리에 넣으며 프로그램당 한 번만 합니다. 같은 모듈을 다시 요청하면 건너뜁니다.
- #INSERT지시문프로젝트의 BASIC 모듈의 줄들을 디렉티브 자리에, 나타날 때마다 넣습니다.
- IncludeFile함수프로젝트의 BASIC 모듈의 줄들을 해당 줄 자리에, 나타날 때마다 넣습니다. #INSERT의 PureBasic식 이름입니다.
- #IF지시문프로그램이 컴파일되기 전에, 조건이 참인 첫 분기의 줄들만 남기고 나머지는 버립니다. 조건은 대상 프로필 같은 심볼을 검사합니다.
- #DEFINE지시문#DEFINE으로 #IF용 심볼을 추가하거나 #UNDEF로 제거합니다. 심볼에는 값이 없으며 정의되어 있거나 아니거나 둘 중 하나입니다.
연산자 · 4
- AND, OR, NOT연산자조건을 결합합니다. AND는 양쪽이 모두 참일 때, OR는 하나 이상이 참일 때 참이고, NOT은 하나를 뒤집습니다. 비트 연산이 아니라 논리 연산입니다.
- Bitwise operators연산자정수의 비트를 계산합니다. &&는 and, ||는 or, ~~는 배타적 or, !는 모든 비트를 뒤집고, <<와 >>는 시프트합니다.
- DIV연산자두 수를 나눕니다. /는 소수를 유지하고 DIV는 0 방향으로 잘라낸 정수 부분만 유지합니다.
- Comparison연산자두 값을 비교합니다: 같다, 다르다, 작다, 크다, 작거나 같다, 크거나 같다. 숫자는 값으로, 텍스트는 문자 코드로 비교합니다.
리스트 · 25
- AddElement리스트 명령어현재 요소 뒤에 새 요소를 추가하고 그것을 현재 요소로 만듭니다. 새 요소는 리스트 타입의 기본값을 가집니다.
- InsertElement리스트 명령어현재 요소 앞에 새 요소를 추가하고 그것을 현재 요소로 만듭니다. 새 요소는 리스트 타입의 기본값을 가집니다.
- DeleteElement리스트 명령어현재 요소를 삭제합니다. 그 앞의 요소가 현재 요소가 됩니다.
- ClearList리스트 명령어리스트의 모든 요소를 제거합니다. 리스트는 계속 쓸 수 있으며 현재 요소는 없습니다.
- FreeList리스트 명령어리스트의 모든 요소를 제거하고 리스트를 해제합니다. 새 NewList로 다시 선언하기 전에는 쓸 수 없습니다.
- ListSize리스트 명령어리스트의 요소 개수를 반환합니다.
- ListIndex리스트 명령어현재 요소의 위치를 0부터 센 값으로 반환합니다.
- ResetList리스트 명령어커서를 첫 요소 앞으로 옮겨, 다음 NextElement()가 첫 요소에 가도록 합니다.
- NextElement리스트 명령어커서를 다음 요소로 옮기고 그것을 현재 요소로 만듭니다.
- PreviousElement리스트 명령어커서를 이전 요소로 옮기고 그것을 현재 요소로 만듭니다.
- FirstElement리스트 명령어리스트의 첫 요소를 현재 요소로 만듭니다.
- LastElement리스트 명령어리스트의 마지막 요소를 현재 요소로 만듭니다.
- SelectElement리스트 명령어주어진 위치의 요소를 현재 요소로 만듭니다.
- CopyList리스트 명령어한 리스트의 내용을 다른 리스트의 복사본으로 바꿉니다. 이후 한쪽을 바꿔도 다른 쪽에는 반영되지 않습니다.
- CompareList리스트 명령어두 리스트를 요소별로 순서대로 비교합니다.
- MergeLists리스트 명령어한 리스트의 모든 요소를 다른 리스트로 옮깁니다. 원본 리스트는 비게 됩니다.
- SortList리스트 명령어숫자나 문자열 리스트를 제자리에서 정렬합니다.
- SortStructuredList리스트 명령어레코드 리스트를 레코드의 한 필드를 기준으로 제자리에서 정렬합니다.
- RandomizeList리스트 명령어리스트 전체 또는 그 일부 범위의 요소를 무작위 순서로 섞습니다.
- PushListPosition리스트 명령어현재 요소를 스택에 기억해 두어, 나중에 PopListPosition()으로 그 요소로 돌아올 수 있게 합니다.
- PopListPosition리스트 명령어마지막 PushListPosition()으로 저장한 요소를 다시 현재 요소로 만들고 스택에서 제거합니다.
- MoveElement리스트 명령어현재 요소를 같은 리스트의 다른 자리로 옮깁니다. 현재 요소는 그대로 유지됩니다.
- SwapElements리스트 명령어위치로 지정한 리스트의 두 요소를 맞바꿉니다.
- SplitList리스트 명령어현재 요소와 그 뒤의 모든 요소를 다른 리스트로 옮깁니다.
- ChangeCurrentElement리스트 명령어주어진 위치의 요소를 현재 요소로 만듭니다. SelectElement()의 다른 이름입니다.
맵 · 13
- AddMapElement맵 명령어키에 해당하는 항목을 만들고 그것을 현재 항목으로 만듭니다. 이미 있는 항목은 기본값으로 초기화됩니다.
- FindMapElement맵 명령어키를 만들지 않고 찾습니다. 키가 있으면 그 항목이 현재 항목이 됩니다.
- DeleteMapElement맵 명령어키의 항목을 삭제하며, 키를 주지 않으면 현재 항목을 삭제합니다.
- ClearMap맵 명령어맵의 모든 항목을 제거합니다. 맵은 계속 쓸 수 있습니다.
- FreeMap맵 명령어맵의 모든 항목을 제거하고 맵을 해제합니다. 해제된 맵은 NewMap으로 다시 선언하기 전에는 쓸 수 없습니다.
- MapSize맵 명령어맵의 항목 개수를 반환합니다.
- MapKey맵 명령어맵의 현재 항목의 키를 반환합니다.
- ResetMap맵 명령어맵의 커서를 첫 항목 앞으로 옮겨, 다음 NextMapElement()가 첫 항목으로 가도록 합니다.
- NextMapElement맵 명령어맵의 다음 항목으로 이동하여 그것을 현재 항목으로 만듭니다. 항목은 만들어진 순서대로 나옵니다.
- CopyMap맵 명령어대상 맵의 모든 항목을 원본 맵 항목의 복사본으로 바꿉니다.
- CompareMap맵 명령어두 맵이 같은 키에 같은 값을 갖는지 알려 줍니다. 항목이 만들어진 순서는 상관없습니다.
- PushMapPosition맵 명령어맵의 현재 항목을 스택에 기억해 두어, PopMapPosition()으로 그 항목으로 돌아올 수 있게 합니다.
- PopMapPosition맵 명령어마지막 PushMapPosition()으로 기억한 항목으로 돌아가 다시 현재 항목으로 만듭니다.
숫자 · 3
핸들 · 4
오류 · 3
태스크 · 11
- STARTTASK문레이블을 메인 프로그램과 나란히 실행되는 협력형 태스크로 시작하고, 그 핸들을 변수에 저장합니다.
- AWAITTASK문태스크가 끝날 때까지 현재 코드를 멈춥니다. 그동안 엔진은 프레임을 계속 그립니다.
- AWAITALL문나열한 모든 태스크가 끝날 때까지 현재 코드를 멈춥니다.
- AWAITANY문나열한 태스크 중 첫 번째가 끝나거나, 실패하거나, 취소될 때까지 현재 코드를 멈춥니다.
- CANCELTASK문태스크에게 멈추라고 요청합니다. 태스크는 다음 양보 지점에서 멈추며 그 양보 뒤의 코드는 실행되지 않습니다.
- YieldTask함수현재 프레임을 끝내고 다음 프레임에서 재개합니다. Sync()와 같습니다. 이름이 태스크 안에서 읽기 좋습니다.
- Wait함수현재 코드를 게임 시간으로 몇 초 동안 멈춥니다. 대기하는 동안 엔진은 프레임을 계속 그립니다.
- TaskDone함수태스크가 정상적으로 반환했는지 알려 줍니다. 메인 루프에서 확인하면 태스크가 일하는 동안 게임이 계속 그려집니다.
- TaskFailed함수태스크가 오류로 멈췄는지 알려 줍니다.
- TaskCancelled함수아직 실행 중이던 태스크에 CANCELTASK가 호출되었는지 알려 줍니다.
- TaskResult함수끝난 태스크가 RETURN으로 반환한 값을 줍니다.