단축 표기
더 적게 쓰는 법을 다룹니다. 명령어 이름 짓는 방식, 엔진 오브젝트에 쓰는 WITH 블록, 점 표기법, $"…" 보간, 컴파일러가 받아들이는 PureBasic 철자를 설명합니다.
한 줄 요약#
스프라이트의 id는 모든 스프라이트 명령어의 첫 번째 인자이고, 스프라이트의 이름은 모든 명령어 이름 안에 들어 있습니다. 이 페이지의 단축 표기는 그 반복을 없앱니다. 어느 것도 새 API가 아닙니다. 컴파일러는 프로그램을 컴파일하기 전에 각각을 평범한 BASIC(카탈로그 호출, Str() 연결, FUNCTION, TYPE)으로 다시 씁니다.
| 단축 표기 | 쓰는 것 | 컴파일러가 보는 것 |
|---|---|---|
WITH <family> | \position 100, 200 | SpritePosition(s, 100, 200) |
| 점 표기법 | s.position(100, 200) | SpritePosition(s, 100, 200) |
| 보간 | $"score: {points}" | ("score: " + Str(points)) |
| PureBasic 단어 | Procedure … EndProcedure | FUNCTION … ENDFUNCTION |
명령어 이름 짓는 방식#
두 가지 블록 단축 표기는 명령어 이름을 다시 조립하므로, 하나의 규칙에 의존합니다.
오브젝트가 먼저, 속성이 그다음,
Set이나Get은 없습니다.SpritePosition,SpriteX,MusicVolume,CameraPosition.
| 명령어 종류 | 철자 | 예 |
|---|---|---|
| 쓰는 속성 | <Object><Property>(id, value…) | SpritePosition(s, 10, 20) |
| 읽는 속성 | <Object><Property>(id) | SpriteWidth(s) |
| 한 이름으로 둘 다 | 인자 개수가 결정 | SpriteX(s)는 읽고, SpriteX(s, 10)은 씀 |
| 무언가 생기거나 끝남 | 동사가 앞에 남음 | CreateSprite, LoadImage, CloneSprite, DeleteSprite |
이것은 AGK가 아니라 PureBasic의 규칙입니다. AGK는 SetSpritePosition과 GetSpriteX를 쓰지만, 여기서 둘 다 알 수 없는 명령어이며 컴파일 오류입니다. Set이나 Get을 빼세요.
예외, 카탈로그에서 센 것:
Get으로 시작하는 명령어는 없습니다.Set으로 시작하는 명령어는 4개입니다. 이름만 쓴 형태가 이미 같은 인자 수의 다른 명령어이므로 개수로 구분할 수 없기 때문입니다.SetRandomSeed(RandomSeed옆),SetMemblockString(읽는MemblockString옆),SetCloudDataVariable,SetTerrainBiome입니다.Set으로 끝나는 명령어는 29개입니다(문자열을 채우는LSet과RSet은 제외). 18개는 Text 쓰기입니다.TextPositionSet,TextStringSet,TextXSet,TextSizeSet,TextVisibleSet과 열세 개가 더 있으며,TextX,TextString,TextSize는 읽습니다. 나머지 열한 개는SoundInstanceVolumeSet,SoundInstanceRateSet,MusicOggLoopCountSet,FilePositionSet,HttpHostSet,XmlNodeNameSet,XmlNodeTextSet,XmlAttributeSet,AtmosphereSet,WeatherSet,DayNightSet입니다.
확실하지 않으면 명령어 레퍼런스를 보세요. 카탈로그에서 생성되며 검색이 있습니다.
WITH <family> 블록#
WITH <FAMILY> <expression>
\<property> [<arguments>] ' 문장의 맨 앞: 씀
… \<property> … ' 그 밖의 곳: 읽음
ENDWITH ' 또는 END WITH
img = LoadImage("hero.png")
s = CreateSprite(img)
WITH SPRITE s
\position 100, 200 ' SpritePosition(s, 100, 200)
\size 64, 64 ' SpriteSize(s, 64, 64)
\x 50 ' SpriteX(s, 50)
x# = \x ' SpriteX(s)
\depth 5 ' SpriteDepth(s, 5)
ENDWITH
Console(Str(x#)) ' 50
위치가 의미를 정합니다. 문장의 맨 앞에서 \prop는 쓰기이고, 같은 줄에서 그 뒤에 오는 것이 괄호 없는 인자입니다. 다른 곳에서 \prop는 읽기입니다. 따로 배울 두 번째 표기법은 없습니다.
- 이름을 다시 조립한 다음 찾습니다.
WITH SPRITE에\position을 더하면SpritePosition이 됩니다. 카탈로그에 없는 속성은 그 자리에서 컴파일 오류가 됩니다.Unknown property in WITH SPRITE: \positon. - 식은 무엇이든 될 수 있습니다.
WITH SPRITE ships[3],WITH CAMERA 1. - 단어 하나인
WITH hero는 여전히 레코드 블록이며 레코드와 메서드에서 설명합니다. 두 단어이고 첫 번째가 계열이면 카탈로그를 선택합니다. \로 시작하지 않는 줄은 일반 문장입니다.- 중첩은 안 됩니다.
WITH안의WITH는 레코드든 계열이든 거부됩니다.
⚠️ 쓰기에는 =가 없습니다. \x 50이라고 쓰세요. \x = 50 줄은 거부되지 않지만, 만들어진 프로그램이 시작되지 못합니다.
⚠️ 쓰기는 문장의 맨 앞에서 시작해야 합니다. IF … THEN \visible 1에서 \visible은 맨 앞이 아니므로 읽기로 해석되어 프로그램이 시작되지 못합니다. 블록 IF를 쓰세요.
s = CreateSprite(0)
WITH SPRITE s
IF \visible = 0
\visible 1 ' SpriteVisible(s, 1)
ENDIF
ENDWITH
s = CreateSprite(0)
WITH SPRITE s
\positon 100, 200 ' 거부됨: 그 계열에는 그런 속성이 없음
ENDWITH
어떤 계열이 있는가#
계열은 고정된 목록이 아닙니다. 카탈로그 명령어 이름의 앞부분이 되는 모든 단어가 계열입니다. SpriteX 때문에 Sprite, CameraPosition 때문에 Camera입니다. 가장 많이 쓰게 될 것들:
| 계열 | 일부 속성 | 변수가 얻는 방법 |
|---|---|---|
SPRITE | position, x, y, size, angle, depth, visible, color | CreateSprite, LoadSprite, CloneSprite |
TEXT | 읽기: x, string, size. 쓰기: positionSet, stringSet, sizeSet | CreateText |
OBJECT (3D) | position, positionY, rotation | LoadObject, 또는 AS Object |
CAMERA | position, rotation, x | AS Camera |
PARTICLES | position, frequency, life, size | CreateParticles |
IMAGE | width, height | LoadImage |
MUSIC | volume | LoadMusic |
EDITBOX | position, text | CreateEditBox |
MEMBLOCK | size, byte, int, float | CreateMemblock |
DICTIONARY | size, has | CreateDictionary |
VIRTUALBUTTON, VIRTUALJOYSTICK | position, size | AS VirtualButton, AS VirtualJoystick |
COMPUTEBUFFER, COMPUTESHADER | size, type, buffer | CreateComputeBuffer, CreateComputeShader |
⚠️ 일부 계열은 오브젝트별이 아니라 전역입니다. VideoPlaying()과 VideoWidth()는 id를 받지 않으므로, 비디오 변수는 점 앞에 둘 것이 없습니다.
에디터에서는 WITH <family> 블록 안에서 \를 입력하면 그 계열의 속성이 자동 완성됩니다.
점 표기법#
WITH는 블록 안의 반복을 없앱니다. 점 표기법은 모든 곳에서 없앱니다. 계열이 변수에 붙기 때문입니다.
<var> = Create<Family>(…) ' 또는 Load<Family>(…), Clone<Family>(…)
<var> AS <Family> ' id가 다른 곳에서 올 때
<var>.<property>(<arguments>) ' 호출: 쓰기, 또는 인자가 있는 읽기
<var>.<property> = <value> ' 쓰기, 문장 전체로
… <var>.<property> … ' 읽기
img = LoadImage("hero.png")
s = CreateSprite(img) ' 이제 s는 Sprite 계열에 속함
s.position(100, 200) ' SpritePosition(s, 100, 200)
s.visible = 1 ' SpriteVisible(s, 1)
s.x(s.x + 10) ' SpriteX(s, SpriteX(s) + 10)
Console(Str(s.x)) ' 110
- 계열은 추론됩니다. 대입의 오른쪽 전체가
Create<Family>(,Load<Family>(,Clone<Family>(일 때, 또는AS <Family>선언에서 가져옵니다. - 호출 인자 안의 읽기도 다시 쓰입니다.
s.position(s.x + 1, s.y)는SpritePosition(s, SpriteX(s) + 1, SpriteY(s))가 됩니다. - 계열은 변수 이름을 따라 프로그램 전체,
FUNCTION본문을 포함해 적용됩니다. - 알 수 없는 속성은 컴파일 오류입니다.
Unknown property on sprite: .positon. - 속성만 됩니다.
s.delete()는 거부됩니다.DeleteSprite(s)라고 쓰세요.
| 다시 쓰이는 것 | 그대로 두는 것 |
|---|---|
| 계열이 알려진 변수 | 계열이 없는 변수 |
s.x, s.x(10), s.visible = 1 | 레코드 필드: hero.health |
| 호출 인자 안에 중첩된 읽기 | 리스트나 맵의 메서드: scores.insert(1) |
METHOD 안의 SELF.field | |
문자열 안: "sprite.png" |
⚠️ = 쓰기는 오른쪽을 쓴 그대로 복사합니다. s.angle = s.angle + 5에서 오른쪽의 s.angle은 다시 쓰이지 않으며, 스프라이트는 숫자가 아닌 것을 받습니다. 오류는 표시되지 않습니다. 인자를 다시 써 주는 호출 형태를 쓰세요.
s = CreateSprite(0)
s.angle(s.angle + 5) ' SpriteAngle(s, SpriteAngle(s) + 5)
IF s.visible = 0 THEN s.visible(1) ' 호출 형태는 한 줄에서도 동작함
⚠️ = 쓰기는 문장 전체여야 합니다. 한 줄 IF의 THEN 뒤에서는 위처럼 호출 형태를 쓰세요.
계열이 추론되지 않을 때#
일부 생성 명령어는 이름에 계열 외의 것도 담고 있습니다. CreateObjectBox, CreatePointLight가 그렇습니다. 이들은 변수에 계열을 주지 않습니다. 먼저 선언하세요.
box AS Object
box = CreateObjectBox(1, 1, 1)
box.position(0, 2, 0) ' ObjectPosition(box, 0, 2, 0)
Console(Str(box.positionY)) ' ObjectPositionY(box)
⚠️ CreateObjectSphere는 더 나쁩니다. 변수에 잘못된 계열(objectsphere)을 주며, 그것이 AS Object보다 우선합니다. id를 받는 형태를 쓰세요.
ball AS Object
ball = 1
CreateObjectSphere(ball, 1, 16, 16)
ball.position(0, 1, 0) ' ObjectPosition(ball, 0, 1, 0)
타입 지정 매개변수는 인식되지 않습니다#
' 거부됨: Unknown BASIC parameter type: Sprite
FUNCTION Nudge(s AS Sprite)
s.x(s.x + 1)
ENDFUNCTION
계열은 매개변수 타입이 아닙니다. 매개변수는 타입 없이 받고, 본문 첫 줄에서 계열을 선언하세요.
FUNCTION Nudge(spr)
spr AS Sprite
spr.x(spr.x + 1) ' SpriteX(spr, SpriteX(spr) + 1)
ENDFUNCTION
hero = CreateSprite(0)
Nudge(hero)$"…" 보간#
$"<text>{<expression>}<text>…"
{{ and }} ' 문자 그대로의 { 와 }
points = 1250
name$ = "Ada"
lives = 3
Console($"{name$} has {lives} lives") ' Ada has 3 lives
Console($"next life at {points + 750}") ' next life at 2000
Console($"{{braces}} and {Len(name$)}") ' {braces} and 3
각 홀은 Str(expression)이 되고, 문자열은 연결이 됩니다. Str은 문자열을 그대로 돌려주므로 홀에는 숫자든 문자열이든 넣을 수 있습니다.
$는 필수이며 장식이 아닙니다. 많은 월드 명령어는 직접 쓴 JSON을 받는데, 거기서 중괄호는 데이터입니다.
CreateTerrain("island", "{\"preset\":\"island\",\"size\":256}")
$가 없는 문자열은 무엇이 들어 있든 건드리지 않습니다. $는 여는 따옴표에 붙어 있어야 합니다.
- 홀은 처음 만나는
}에서 끝납니다. 문자열 리터럴을 담을 수 없습니다. 홀 안의"는 문자열 전체를 끝내며, 컴파일러가 닫히지 않은{를 보고합니다. 텍스트를 먼저 변수에 담으세요. - 홀에는 호출이 들어갈 수 있습니다.
{Upper(name$)},{Str(speed#, 2)}. - 빈 홀
{}나 닫히지 않은{는 컴파일 오류입니다. 홀 밖의 혼자 있는}는 그대로 유지됩니다. - ⚠️
AS float변수는 32비트 값의 모든 자릿수를 보여 줍니다.0.1은0.10000000149011612로 출력됩니다. 홀 안에서 반올림하세요.{Str(f, 2)}.
n = 1
Console($"oops {n") ' 거부됨: Unclosed { in interpolated string
AGK, DarkBASIC, PureBasic에는 보간이 없습니다. +와 Str()로 이어 붙입니다. $"…" 철자는 C#의 것입니다.
PureBasic 철자#
키워드는 대소문자를 구분하지 않으므로, 많은 PureBasic 줄이 이미 BASIC으로 읽힙니다. Global, If … ElseIf … EndIf, Repeat … Until, Select … EndSelect, With … EndWith, ForEach, NewList v.i()(배열, 리스트, 맵 참고), \field 단축 표기가 그렇습니다.
아래 단어들도 받아들여집니다. 각각 별칭입니다. 컴파일러가 이미 아는 구문으로 다시 쓰이므로 두 철자는 항상 같게 동작합니다.
| PureBasic | 같은 것 | 비고 |
|---|---|---|
Procedure name(…) … EndProcedure | FUNCTION … ENDFUNCTION | 반환 타입은 괄호 뒤의 AS <type> |
ProcedureReturn [value] | EXITFUNCTION [value] | |
Structure Name … EndStructure | TYPE … ENDTYPE | 한 줄도 가능: Structure Vec x y EndStructure |
Wend | ENDWHILE | |
Define, Protected | LOCAL | Procedure 안에서 쓰세요 |
Debug(value) | Console(value) | 괄호와 함께 |
x.f = 1.5 | x AS float 다음 x = 1.5 | 변수의 타입 접미사, 아래 참고 |
Structure Vec
x AS float
y AS float
EndStructure
Procedure Twice(n AS integer) AS integer
Protected result = n * 2
ProcedureReturn result
EndProcedure
v AS Vec
v.x = 1.5
count.i = 0
While count < 3
count = count + 1
Wend
Debug(Str(Twice(count))) ' 6
별칭은 문장의 맨 앞에서만 동작합니다. structure = 3은 여전히 structure라는 이름의 변수이고, Print("Procedure")는 그 단어를 출력합니다.
타입 접미사#
처음 나오는 name.<suffix>가 그 타입으로 변수를 선언합니다. 그 뒤에는 이름만 쓰세요. 타입 자체는 변수와 타입에 설명되어 있습니다.
| 접미사 | 타입 | 접미사 | 타입 |
|---|---|---|---|
.b | int8 | .a | uint8 |
.w | int16 | .u, .c | uint16 |
.l, .i | int32 | .q | int64 |
.f | float32 | .d | float64 |
.s | string |
⚠️ 여기서 .i는 32비트입니다. 64비트 PureBasic에서는 64비트입니다. 64비트에는 .q를 쓰세요.
PureBasic과 다른 점#
| PureBasic | aukimi에서는 |
|---|---|
Procedure.i Twice(n) | 거부됨: Procedure Twice(n) AS integer라고 쓰세요 |
EndProcedure value | 거부됨: ProcedureReturn value, 그다음 EndProcedure |
Structure 필드로서의 x.f | 거부됨: x AS float라고 쓰세요 |
레코드를 선언하는 p.Point | 거부됨: p AS Point라고 쓰세요 |
Define.i a, b | 거부됨: a.i = 0과 b.i = 0을 쓰세요 |
매개변수의 n.i | 타입이 지정되지 않음: n AS integer라고 쓰세요 |
EnableExplicit | OPTION EXPLICIT |
Repeat … ForEver | DO … LOOP, 또는 REPEAT … UNTIL |
Select의 Default | CASE DEFAULT. 단독 Default는 인식되지 않으며, 거부도 되지 않고 Select가 실행 시 잘못 동작합니다. |
Shared, Static | 거부됨 |
; comment | 여기서는 주석이 아님: '를 쓰세요 |
⚠️ 프로그램 최상위에서는 Define보다 GLOBAL을 쓰세요. 어떤 Procedure 밖에서 Define(또는 LOCAL)으로 선언하고 나중에 다시 대입한 변수는 현재 프로그램이 시작되지 못하게 만듭니다. Procedure 안의 Define과 Protected는 괜찮습니다.
의도적으로 채택하지 않은 것#
DarkBASIC의 습관 두 가지와 PureBasic의 기능 하나는 일부러 뺐습니다.
괄호 없는 명령어. PRINT "hello", SYNC, Debug x. 괄호가 명령어와 변수를 구분하고, 컴파일러가 철자를 틀린 명령어를 잡게 해 줍니다.
PRINT "hello" ' 거부됨: BASIC commands require parentheses
여러 단어로 된 명령어. DarkBASIC의 MAKE OBJECT CUBE 1, 10이나 SYNC ON은 여기서 문장이 아닙니다. 카탈로그는 각 명령어를 한 단어로 씁니다. CreateObjectBox(1, 10, 10, 10).
MAKE OBJECT CUBE 1, 10 ' 거부됨: Not a BASIC statement
Macro … EndMacro. PureBasic의 매크로는 호출 위치에 텍스트를 붙여 넣습니다. 키워드 별칭이 아니라 전처리기이며, 절반만 진짜처럼 보이고 진짜처럼 동작하지 않을 것입니다. FUNCTION을 쓰거나, 조건부 코드에는 전처리기를 쓰세요.
Macro Square(x) ' 거부됨
x * x
EndMacro제한과 흔한 걸림돌#
SetSpritePosition과GetSpriteX는 존재하지 않습니다.Set과Get을 빼세요.WITH쓰기에는=가 없고, 문장의 맨 앞에서 시작합니다.=를 쓰는 점 쓰기는 오른쪽을 다시 쓰지 않습니다.s.x(s.x + 1)을 쓰세요.CreateObjectBox같은 명령어는 계열을 주지 않습니다. 먼저AS Object를 선언하세요.- 계열은 매개변수 타입이 아닙니다. 함수 안에서 선언하세요.
- 따옴표 앞에
$가 있어야 하며, 없으면 보간이 전혀 없습니다. 홀 안에 문자열 리터럴은 안 됩니다. .i는 32비트입니다.