단축 표기

더 적게 쓰는 법을 다룹니다. 명령어 이름 짓는 방식, 엔진 오브젝트에 쓰는 WITH 블록, 점 표기법, $"…" 보간, 컴파일러가 받아들이는 PureBasic 철자를 설명합니다.

한 줄 요약#

스프라이트의 id는 모든 스프라이트 명령어의 첫 번째 인자이고, 스프라이트의 이름은 모든 명령어 이름 안에 들어 있습니다. 이 페이지의 단축 표기는 그 반복을 없앱니다. 어느 것도 새 API가 아닙니다. 컴파일러는 프로그램을 컴파일하기 전에 각각을 평범한 BASIC(카탈로그 호출, Str() 연결, FUNCTION, TYPE)으로 다시 씁니다.

단축 표기쓰는 것컴파일러가 보는 것
WITH <family>\position 100, 200SpritePosition(s, 100, 200)
점 표기법s.position(100, 200)SpritePosition(s, 100, 200)
보간$"score: {points}"("score: " + Str(points))
PureBasic 단어Procedure … EndProcedureFUNCTION … 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입니다. 가장 많이 쓰게 될 것들:

계열일부 속성변수가 얻는 방법
SPRITEposition, x, y, size, angle, depth, visible, colorCreateSprite, LoadSprite, CloneSprite
TEXT읽기: x, string, size. 쓰기: positionSet, stringSet, sizeSetCreateText
OBJECT (3D)position, positionY, rotationLoadObject, 또는 AS Object
CAMERAposition, rotation, xAS Camera
PARTICLESposition, frequency, life, sizeCreateParticles
IMAGEwidth, heightLoadImage
MUSICvolumeLoadMusic
EDITBOXposition, textCreateEditBox
MEMBLOCKsize, byte, int, floatCreateMemblock
DICTIONARYsize, hasCreateDictionary
VIRTUALBUTTON, VIRTUALJOYSTICKposition, sizeAS VirtualButton, AS VirtualJoystick
COMPUTEBUFFER, COMPUTESHADERsize, type, bufferCreateComputeBuffer, 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(…) … EndProcedureFUNCTION … ENDFUNCTION반환 타입은 괄호 뒤의 AS <type>
ProcedureReturn [value]EXITFUNCTION [value]
Structure Name … EndStructureTYPE … ENDTYPE한 줄도 가능: Structure Vec x y EndStructure
WendENDWHILE
Define, ProtectedLOCALProcedure 안에서 쓰세요
Debug(value)Console(value)괄호와 함께
x.f = 1.5x 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>가 그 타입으로 변수를 선언합니다. 그 뒤에는 이름만 쓰세요. 타입 자체는 변수와 타입에 설명되어 있습니다.

접미사타입접미사타입
.bint8.auint8
.wint16.u, .cuint16
.l, .iint32.qint64
.ffloat32.dfloat64
.sstring

⚠️ 여기서 .i는 32비트입니다. 64비트 PureBasic에서는 64비트입니다. 64비트에는 .q를 쓰세요.

PureBasic과 다른 점#

PureBasicaukimi에서는
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라고 쓰세요
EnableExplicitOPTION EXPLICIT
Repeat … ForEverDO … LOOP, 또는 REPEAT … UNTIL
Select의 DefaultCASE 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비트입니다.