변수와 타입

변수를 만들고, 원하는 방식으로 값이 감기는 숫자 타입을 고르고, 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에는 타입이 없음

모든 타입#

타입다른 표기범위비고
int8byte ⚠️, b−128 … 127
uint8ubyte, ascii, a ⚠️0 … 255
int16word, short, w−32,768 … 32,767
uint16uword, ushort, unicode, u ⚠️, c ⚠️0 … 65,535
int32integer, int ⚠️, long, i, l ⚠️−2,147,483,648 … 2,147,483,647long은 32비트
uint32uint, uinteger, dword0 … 4,294,967,295
int64quad, q−2⁶³ … 2⁶³ − 1아래 64비트 참고
uint64uquad0 … 2⁶⁴ − 1아래 64비트 참고
float32float, single, f ⚠️유효숫자 약 7자리float은 32비트
float64double, d유효숫자 약 15자리타입 없는 숫자의 정밀도
string ⚠️s텍스트모든 값이 텍스트로 바뀝니다
handlepointer ⚠️참조 (@variable)기본값은 NULL
taskhandlejob실행 중인 태스크기본값은 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, double2.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 / DECINC score
READREAD level

선언으로 인정되는 것#

선언예
GLOBALGLOBAL score, GLOBAL score = 0, GLOBAL a, b$
FUNCTION 안의 LOCALLOCAL rest = 0
ASlives AS integer, hero AS Player
PureBasic 접미사speed.f = 1.5
DIMDIM grid(10)
NewList, NewMapNewList names.s()
FUNCTION 매개변수FUNCTION Hit(damage)
CATCH 변수CATCH problem$

⚠️ OPTION EXPLICIT는 값을 쓰는 이름을 검사하고, 읽는 이름은 검사하지 않습니다. = 오른쪽에 있는 철자 틀린 이름은 여전히 컴파일되고, 실행될 때 프로그램을 멈춥니다.

OPTION EXPLICIT
GLOBAL total = 0
total = totl + 1   ' 컴파일은 되지만 실행하면 멈춤: totl is not defined

GLOBAL과 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 안에서도프로그램 전체에서 하나의 변수이며 모든 함수가 봅니다
LOCALFUNCTION 안그 호출에만 속한 변수. 같은 이름의 프로그램 변수를 가립니다
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 INTEGERx AS integer. 크기 없는 DIM은 컴파일되지만 프로그램이 시작되지 않습니다
x.f (PureBasic)받아들여집니다
맨 위의 Define x = 1 (PureBasic)GLOBAL x = 1을 쓰세요
사용 전에 읽은 $ 변수는 ""0입니다. 먼저 대입하세요
OPTION EXPLICIT가 모든 이름을 검사값을 쓰는 이름을 검사합니다