변수와 타입
변수를 만들고, 원하는 방식으로 값이 감기는 숫자 타입을 고르고, OPTION EXPLICIT를 켜고, GLOBAL로 상태를 공유하고, 설정을 인스펙터에 노출하는 법을 다룹니다.
한 줄 요약#
변수는 값을 대입하는 순간 생깁니다. AS로 타입을 주기 전까지는 어떤 값이든 담을 수 있고, 타입을 준 뒤에는 저장되는 모든 값이 그 타입으로 변환됩니다. OPTION EXPLICIT는 선언을 의무로 만들고, GLOBAL은 변수를 함수와 공유합니다.
암시적 변수#
<name> = <value>
Console(Str(count)) ' 0: 첫 대입 전에 읽은 값
count = 5
Console(Str(count)) ' 5
x = 1
x = "now text"
Console(x) ' now text
- 첫 번째 대입이 변수를 만듭니다. 일반 값에는
DIM이나VAR가 없습니다. - 첫 대입 전에 읽은 변수는 0에서 시작합니다.
- 타입이 없는 변수는 무엇이든 담습니다. 숫자, 그다음 문자열, 다시 숫자도 됩니다. 숫자는 JavaScript 숫자(64비트 부동소수점)입니다.
⚠️ 프로그램이 한 번도 대입하지 않은 이름은 변수가 아닙니다. total = lives + 1에서 lives가 어디에도 대입되지 않았다면 컴파일은 됩니다. 그러면 프로그램이 그 줄에서 lives is not defined로 멈춥니다. 철자를 틀린 이름은 이렇게 드러납니다.
⚠️ 첫 대입 전에 읽은 $ 변수도 0에서 시작합니다. 빈 문자열이 아닙니다. 먼저 값을 주세요.
Console("[" + title$ + "]") ' [0], []가 아님
title$ = "Hero"시길#
변수 이름은 시길 하나로 끝날 수 있습니다.
| 시길 | 클래식에서의 의미 |
|---|---|
$ | 텍스트 |
# | 소수 |
% | 정수 |
& | 긴 정수 |
시길이 하는 일#
- 시작 값을 정합니다. 값 없이 선언한 변수에 적용됩니다.
GLOBAL a, b$는0과""를 줍니다. READ가DATA줄에서 기대하는 것을 정합니다.$는 텍스트,#는 소수, 그 외는 정수입니다.- 레코드 필드의 타입을 정합니다.
TYPE안에서 시길도AS도 없는 필드는 정수입니다. 레코드와 메서드를 참고하세요. - 노출된 설정의 종류를 정합니다. 아래의
@expose를 참고하세요. - 명령어 호출에서는 결과와 맞아야 합니다.
Str$(12)는 받아들여지지만, 숫자를 반환하는 명령어에 붙인$는 거부됩니다.
v$ = Val$("12")
Val does not return text: drop the $ sigil
시길이 하지 않는 일#
시길은 아무것도 변환하지 않습니다. 변환하려면
AS로 변수에 타입을 주세요.
n% = 2.7
Console(Str(n%)) ' 2.7: %는 반올림하지 않음
t$ = 5
Console(Str(t$ + 1)) ' 6: $가 텍스트로 만들지 않음
시길만 다른 두 이름#
obj와 obj$는 서로 다른 두 변수입니다. 클래식 프로그램이 기대하는 바로 그 동작입니다.
obj = 1
obj$ = "mesh" + Str(obj) + ".obj"
Console(Str(obj) + " " + obj$) ' 1 mesh1.obj
⚠️ 시길이 붙은 레코드 필드는, 프로그램 어디에서든 같은 이름이 시길 없이 나타나면 타입을 잃습니다. 변수 speed, 또는 speed#로 선언한 필드에 대한 s.speed가 그 예입니다. 그러면 필드가 정수가 됩니다. 2.5는 2로 저장되고, 텍스트를 넣으면 프로그램이 멈춥니다. 이런 필드에는 고유한 이름을 주거나, 잃을 시길이 없는 AS로 선언하세요(speed AS float).
TYPE Ship
hp
speed#
name$
ENDTYPE
s AS Ship
s.hp = 2.7
s.speed# = 2.5
s.name$ = "Ada"
Console(Str(s.hp) + " " + Str(s.speed#) + " " + s.name$) ' 2 2.5 Ada타입이 있는 변수: AS#
[GLOBAL | LOCAL] <name> AS <type> [= <value>]
[GLOBAL | LOCAL] <name> AS <type>[<size>[, <size> ...]] [= [<value>, ...]]
lives AS integer = 3
speed AS float = 2.5
title AS string = "Hero"
hits AS ubyte
hits = 250
hits = hits + 10
Console(Str(hits)) ' 4: 260이 255를 넘어 감김
= <value>가 없으면 숫자는 0, 문자열은"", 핸들은NULL에서 시작합니다. 일부 타입 이름은 값이 필요합니다. 아래 표의 ⚠️를 참고하세요.- 타입은 값이 저장될 때마다 작용합니다.
=,+=,-=,*=,/=, 그리고INC와DEC에서 모두 그렇습니다. - 중간 계산에는 타입이 적용되지 않습니다.
h / 2는 전체 정밀도로 계산되고, 저장할 때만 변환됩니다. - 타입이 있는 변수의 이름에는 시길을 붙이지 않습니다.
name$ AS string은 컴파일되지만 프로그램이 시작되지 않습니다.name AS string이라고 쓰세요. - 배열 형태
AS <type>[<size>]는 컬렉션에서,AS <record type>은 레코드와 메서드에서 다룹니다.
h AS integer = 7
h = h / 2
Console(Str(h)) ' 3: 3.5가 3으로 저장됨
q = h / 2
Console(Str(q)) ' 1.5: q에는 타입이 없음
모든 타입#
| 타입 | 다른 표기 | 범위 | 비고 |
|---|---|---|---|
int8 | byte ⚠️, b | −128 … 127 | |
uint8 | ubyte, ascii, a ⚠️ | 0 … 255 | |
int16 | word, short, w | −32,768 … 32,767 | |
uint16 | uword, ushort, unicode, u ⚠️, c ⚠️ | 0 … 65,535 | |
int32 | integer, int ⚠️, long, i, l ⚠️ | −2,147,483,648 … 2,147,483,647 | long은 32비트 |
uint32 | uint, uinteger, dword | 0 … 4,294,967,295 | |
int64 | quad, q | −2⁶³ … 2⁶³ − 1 | 아래 64비트 참고 |
uint64 | uquad | 0 … 2⁶⁴ − 1 | 아래 64비트 참고 |
float32 | float, single, f ⚠️ | 유효숫자 약 7자리 | float은 32비트 |
float64 | double, d | 유효숫자 약 15자리 | 타입 없는 숫자의 정밀도 |
string ⚠️ | s | 텍스트 | 모든 값이 텍스트로 바뀝니다 |
handle | pointer ⚠️ | 참조 (@variable) | 기본값은 NULL |
taskhandle | job | 실행 중인 태스크 | 기본값은 NULL |
타입 이름은 대소문자를 구분하지 않습니다. 한 글자 이름은 PureBasic의 접미사입니다.
⚠️ ⚠️ 표시가 있는 이름은 값이 필요합니다. 단독으로 쓰면(x AS byte, x AS string) 타입을 잃습니다. 컴파일러가 카탈로그 명령어 이름의 앞부분(ByteLen, StringToBase64…)으로 읽기 때문입니다. 그러면 변수는 0에서 시작하는 타입 없는 변수처럼 동작합니다. x AS byte = 0, x AS string = ""이라고 쓰거나, ⚠️가 없는 이름을 쓰세요.
a AS byte
a = 300
Console(Str(a)) ' 300: 타입이 적용되지 않음
b AS int8
b = 300
Console(Str(b)) ' 44
값이 변환되는 방식#
| 저장 대상 | 규칙 | 예 |
|---|---|---|
| 정수 타입 | 소수부는 버려집니다 (0 방향으로) | 7.9 → 7, -7.9 → -7 |
| 정수 타입 | 범위를 벗어나면 감깁니다 | int8: 127 + 1 → -128, uint16: -1 → 65535 |
| 정수 타입 | 숫자로 된 텍스트는 읽힙니다 | "12" → 12 |
| 정수 타입 | 그 밖의 텍스트는 프로그램을 멈춥니다 | "abc", "1.5" → BASIC integer requires an integral value |
| 정수 타입 | 무한대는 프로그램을 멈춥니다 | 1 / 0 → BASIC integer requires a finite value |
float32 | 가장 가까운 32비트 float로 반올림 | 0.1 → 0.10000000149011612 |
string | 모든 값이 텍스트가 됩니다 | 42 → "42" |
n AS integer = 7.9
m AS integer = -7.9
k AS integer = "12"
w AS word = 40000
Console(Str(n) + " " + Str(m) + " " + Str(k + 1) + " " + Str(w)) ' 7 -7 13 -25536
⚠️ 타입이 있는 FOR 카운터는 감기지 않습니다. b AS uint8일 때 FOR b = 250 TO 260은 260까지 세고 261에서 끝납니다. 타입은 그다음 일반 대입에서 다시 작용합니다.
⚠️ float는 32비트입니다#
aukimi에서 float와 single은 AGK처럼 float32입니다. 0.1 같은 값은 정확히 저장할 수 없고, Str은 저장된 값의 모든 자릿수를 보여 줍니다.
price AS float = 0.1
Console(Str(price)) ' 0.10000000149011612
exact AS double = 0.1
Console(Str(exact)) ' 0.1
Console(Str(price, 2)) ' 0.10
소수를 깔끔하게 출력해야 한다면 double을 쓰거나, Str에 소수 자릿수를 주세요. 타입 없는 변수는 이미 double 정밀도입니다.
⚠️ long은 32비트입니다#
long은 PureBasic의 .l처럼 int32입니다. Visual Basic의 64비트 Long은 여기서 quad(int64)입니다.
big AS long = 3000000000
Console(Str(big)) ' -1294967296
64비트 정수#
int64와 uint64는 정확한 64비트 값을 담습니다. 이들은 별도의 숫자 종류이며, 서로끼리만 섞을 수 있습니다.
동작하는 것:
counter AS int64 = 5
counter = counter + 1
counter += 10
INC counter
Console(Str(counter)) ' 17
huge AS int64 = "9223372036854775807"
Console(Str(huge)) ' 9223372036854775807
five AS int64 = 5
IF counter > five THEN Console("greater")
| 형태 | 동작? |
|---|---|
big = big + n, big += n, -=, *=, /=, INC, DEC | 예 |
big2 = big + other64 (64비트 값끼리만) | 예 |
big = 5, big = "123" | 예 |
big > 4, big < 10 | 예 |
⚠️ y = big + 1 (결과가 64비트 변수가 아님) | 멈춤: Cannot mix BigInt and other types |
⚠️ other AS int64 = big * 3 | 멈춤: 같은 메시지 |
⚠️ IF big = 5 | 절대 참이 되지 않음: 다른 64비트 변수와 비교하세요 |
⚠️ big = big * 2 + 1 | 잘못된 결과: big * (2 + 1)로 계산됩니다. big *= 2 다음 big += 1로 쓰세요 |
| ⚠️ 9 007 199 254 740 991을 넘는 리터럴 | 마지막 자릿수를 잃음: 텍스트 "9223372036854775807"로 쓰세요 |
64비트 값의 정수 나눗셈은 소수부를 버립니다. big /= 4는 정수부만 남깁니다. 32비트로 정말 모자랄 때만 64비트 타입을 쓰세요.
타입별 리터럴#
| 타입 | 쓰는 방법 | 비고 |
|---|---|---|
| 정수 타입 | 42, -7, 0x1F, 0c17, %1010 | 소수는 잘립니다: 7.9 → 7 |
| 64비트 | 42, 또는 "9223372036854775807" | 2⁵³을 넘는 값은 텍스트로 |
float, double | 2.5, .5, 1.25e2 | |
string | "text" | 숫자는 텍스트로 바뀝니다 |
handle | @variable, NULL |
TRUE와 FALSE는 숫자가 아닙니다. 상수와 연산자를 참고하세요.
PureBasic 타입 접미사: .f, .i, .s…#
<name>.<suffix> = <value>
speed.f = 1.5
speed = speed * 2
count.i = 7.9
label.s = "x"
Console(Str(speed) + " " + Str(count) + " " + label) ' 3 7 x
- 처음 나오는
name.suffix가name AS <type>을 쓴 것처럼 그 타입으로 변수를 선언합니다. 이후 줄에서는 접미사를 생략할 수 있습니다. - 접미사는 위 표의 한 글자 이름입니다.
b a w u c l i q f d s. - 이미 레코드이거나 스프라이트 같은 카탈로그 오브젝트인 변수는 자기 필드를 유지합니다. 스프라이트의
s.x는 접미사가 아닙니다.
⚠️ c는 변수와 리스트에서는 uint16이지만, 레코드 필드에서는 int32입니다.
OPTION EXPLICIT#
OPTION EXPLICIT [' comment]
OPTION EXPLICIT
GLOBAL lives AS integer = 3
GLOBAL score = 0
GLOBAL name$ = "Ada"
DIM grid(2)
FUNCTION Hit(damage)
LOCAL rest = lives - damage
lives = rest
ENDFUNCTION lives
Hit(1)
score = score + 10
grid(1) = score
Console(name$ + " " + Str(lives) + " " + Str(grid(1))) ' Ada 2 10
OPTION EXPLICIT는 기본적으로 꺼져 있어서, 가져온 프로그램도 계속 컴파일됩니다. 켜면 값을 쓰는 모든 이름을 먼저 선언해야 합니다.
OPTION EXPLICIT
score = 1
OPTION EXPLICIT requires a declaration for variable: score
- 줄에 단독으로 있어야 합니다.
'주석만 뒤따를 수 있고,OPTION EXPLICIT // note는 거부됩니다. - 줄이 어디에 있든 프로그램 전체에 적용되며, 포함된 파일도 마찬가지입니다.
- aukimi의 모든 데모가 이것을 사용합니다.
선언해야 하는 것#
| 쓰는 주체 | 예 |
|---|---|
| 대입 | score = 1, grid(1) = 4, hero.hp = 3 (첫 번째 이름) |
| FOR 카운터 | FOR i = 1 TO 10 |
INC / DEC | INC score |
READ | READ level |
선언으로 인정되는 것#
| 선언 | 예 |
|---|---|
GLOBAL | GLOBAL score, GLOBAL score = 0, GLOBAL a, b$ |
FUNCTION 안의 LOCAL | LOCAL rest = 0 |
AS | lives AS integer, hero AS Player |
| PureBasic 접미사 | speed.f = 1.5 |
DIM | DIM grid(10) |
NewList, NewMap | NewList names.s() |
| FUNCTION 매개변수 | FUNCTION Hit(damage) |
CATCH 변수 | CATCH problem$ |
⚠️ OPTION EXPLICIT는 값을 쓰는 이름을 검사하고, 읽는 이름은 검사하지 않습니다. = 오른쪽에 있는 철자 틀린 이름은 여전히 컴파일되고, 실행될 때 프로그램을 멈춥니다.
OPTION EXPLICIT
GLOBAL total = 0
total = totl + 1 ' 컴파일은 되지만 실행하면 멈춤: totl is not definedGLOBAL과 LOCAL#
GLOBAL <name> [= <value>]
GLOBAL <name> AS <type> [= <value>]
GLOBAL <name>, <name> [, <name> ...]
LOCAL <name> [= <value>]
LOCAL <name> AS <type> [= <value>]
LOCAL <name>, <name> [, <name> ...]
GLOBAL DIM, LOCAL DIM, GLOBAL NewList, GLOBAL NewMap도 컬렉션을 같은 방식으로 선언합니다. PureBasic의 Define과 Protected는 LOCAL로 받아들여집니다.
| 키워드 | 위치 | 효과 |
|---|---|---|
GLOBAL | 어디서나, FUNCTION 안에서도 | 프로그램 전체에서 하나의 변수이며 모든 함수가 봅니다 |
LOCAL | FUNCTION 안 | 그 호출에만 속한 변수. 같은 이름의 프로그램 변수를 가립니다 |
FUNCTION Setup()
GLOBAL best = 100
ENDFUNCTION
Setup()
Console(Str(best)) ' 100
⚠️ 단독 GLOBAL에는 값을 주세요. GLOBAL hits만 쓰면 0이 아니라 빈 상태로 시작하고, hits + 1은 NaN이 됩니다. 목록 형태는 0(또는 "")에서 시작합니다.
GLOBAL hits
Console(Str(hits)) ' undefined, 0이 아님
GLOBAL misses = 0
Console(Str(misses)) ' 0
GLOBAL a, b$
Console(Str(a) + "[" + b$ + "]") ' 0[]
⚠️ LOCAL은 FUNCTION 안에 두세요. 프로그램 최상위에서 나중에 다시 대입되는 LOCAL 변수는 프로그램을 망가뜨려 시작되지 않게 합니다. 거기서는 GLOBAL이나 AS를 쓰세요. Define도 마찬가지입니다.
LOCAL lives = 3
lives = 2스코프#
블록은 스코프가 아닙니다#
IF, FOR, WHILE, SELECT 안에서 처음 대입된 변수는 프로그램에 속합니다. 블록이 끝난 뒤에도 남아 있습니다. FOR 카운터도 마찬가지이며, 끝값에서 한 단계 더 간 값입니다.
IF 1 = 1
found = 42
ENDIF
Console(Str(found)) ' 42
FOR i = 1 TO 3
NEXT
Console(Str(i)) ' 4
함수#
FUNCTION 안에서는 다음과 같습니다.
- 매개변수와
LOCAL이름은 그 호출에 속합니다. GLOBAL이름, 또는 프로그램이 함수 위에서 대입한 이름은 프로그램의 변수입니다. 함수가 읽고 쓸 수 있습니다.- 그 밖에 함수 안에서 대입한 이름은 새 지역 변수입니다.
score = 0
FUNCTION AddPoint()
score = score + 1
ENDFUNCTION
AddPoint()
AddPoint()
Console(Str(score)) ' 2
FUNCTION Bump()
LOCAL score = 99
score = score + 1
ENDFUNCTION score
score = 1
Console(Str(Bump()) + " " + Str(score)) ' 100 1
⚠️ 줄의 순서가 중요합니다. 프로그램이 score를 함수 아래에서만 대입하면, 함수는 자기만의 score를 만들고, 그것을 먼저 읽으면 프로그램이 멈춥니다.
FUNCTION AddPoint()
score = score + 1 ' 새 지역 변수: score는 아래에서만 대입됨
ENDFUNCTION
score = 0
AddPoint() ' 멈춤: Cannot access 'score' before initialization
⚠️ DO … LOOP가 있으면 함수는 일반 변수를 보지 못합니다#
프레임 루프가 있는 프로그램에서는 DO 위의 설정 줄이 루프 자체의 함수 안에서 실행됩니다. FUNCTION은 읽기만 하더라도 거기서 만들어진 변수를 볼 수 없습니다.
score = 10
FUNCTION Show()
Console(Str(score))
ENDFUNCTION
DO
Show() ' 멈춤: score is not defined
Sync()
LOOP
해결책은 GLOBAL입니다. GLOBAL 변수는 프로그램의 형태와 상관없이 프로그램 전체에 선언됩니다.
GLOBAL score = 10
FUNCTION Show()
Console(Str(score))
ENDFUNCTION
DO
Show() ' 10, 그다음 11, 12…
score = score + 1
Sync()
LOOP
상수에도 같은 제한이 있습니다. 상수와 연산자를 참고하세요.
함수가 프로그램과 공유하는 모든 값은
GLOBAL로 선언하세요. 어떤 프로그램 형태에서도 동작하고, 줄의 순서가 더 이상 중요하지 않게 됩니다.
@expose: 인스펙터의 설정#
' @expose [range(<min>, <max>)]
[GLOBAL] <name>[<sigil>] [AS <type>] = <value>
최상위 대입 바로 윗줄의 @expose 주석은 그 변수를 설정으로 만듭니다. 인스펙터가 그것을 보여 주고, 프로그램이 시작될 때 거기 있는 값이 코드에 쓴 값을 대체합니다.
' @expose range(0, 20)
speed# = 5.5
' @expose
title$ = "Hero"
' @expose
lives = 3
' @expose
godMode = FALSE
Console(title$ + " " + Str(speed#) + " " + Str(lives) + " " + Str(godMode)) ' Hero 5.5 3 0
| 선언 | 설정 | 읽는 명령어 |
|---|---|---|
$ 이름, 또는 AS string | 텍스트 | PropString |
# 이름, 또는 AS float | 소수 | Prop |
TRUE 또는 FALSE | 켜기/끄기, 1 또는 0으로 저장 | PropInteger |
| 그 밖의 것 | 정수 | PropInteger |
- 설정의 이름은 시길을 뺀 변수 이름입니다.
speed#는speed입니다. range(a, b), 또는 그냥(a, b)로 인스펙터에 표시되는 한계를 정합니다.- 마커는
',REM,//, 백틱으로 쓸 수 있습니다. OPTION EXPLICIT아래에서는 선언을 노출하세요.GLOBAL lives = 3, 또는speed AS float = 2.5.
⚠️ 소수 설정에는 # 또는 AS float가 필요합니다. zoom AS double = 1.5와 ratio = 0.75는 정수 설정이 되어 1과 0에서 시작합니다.
⚠️ 대입은 최상위에 있어야 합니다. FUNCTION이나 TYPE 안에서는 마커가 거부됩니다. @expose must be followed by a top-level assignment (name = value).
다른 BASIC에서 오셨다면#
| 기대하는 동작 | aukimi에서는 |
|---|---|
x% = 2.7이 2를 저장 | 2.7을 저장합니다. x AS integer를 쓰세요 |
float는 64비트 | float는 32비트입니다. double을 쓰세요 |
Long은 64비트 (Visual Basic) | long은 32비트입니다. quad를 쓰세요 |
DIM x AS INTEGER | x AS integer. 크기 없는 DIM은 컴파일되지만 프로그램이 시작되지 않습니다 |
x.f (PureBasic) | 받아들여집니다 |
맨 위의 Define x = 1 (PureBasic) | GLOBAL x = 1을 쓰세요 |
사용 전에 읽은 $ 변수는 "" | 0입니다. 먼저 대입하세요 |
OPTION EXPLICIT가 모든 이름을 검사 | 값을 쓰는 이름을 검사합니다 |