Contents

원래는 C/C++ 프로그램에 내장되어서 실행되는 "기생적인" 스크립트 엔진입니다만, 현재 pixels 팀에서 개발중인 PAGE(Pixelz Accessible Game Engine) 엔진에서는 마치 디렉터의 링고언어와 같이 게임 내부 로직 및 흐름을 기술하는 스크립트 언어로서 사용되고 있습니다. 특징은 다음과 같습니다.

• C/C++의 코드를 이식하기 쉽다. 이것은 엔진작업/스크립트(게임제작)작업의 분업화를 가능하게 해줍니다. (물론, 반대로 루아 코드를 C/C++상에서 실행하는 것도 가능하다.)
• 동종 스크립트 언어 중에서는 최강의 속도와 효율을 자랑한다.
• table이라는 강력한 연관배열을 지원합니다. 이것은 스크립트 제작시 자료의 정리를 상당히 용이하게 해줍니다.
• 문법이 간단합니다. 데이타 타입이 존재하지만 사용시에는 숫자, 문자열 정도만 구분하면 되며 왠만한 경우는 자동으로 변환을 수행한다.

반면에 다음과 같은 단점도 존재합니다.

• 스크립트 언어라면 모두가 가지고 있는 개비지 콜렉션이 존재합니다. 즉, 사용되지 않는 메모리는 일정정도 차게 되면 자동으로 해제해버립니다. (이것은 성능저하, 직접적인 메모리 관리의 어려움등의 단점을 만듭니다) 다행히, 루아 5.0이후버젼에서는 이 개비지 컬렉션 처리의 한도를 조정할 수 있어 이 현상을 일어나지 않도록 만들 수 있습니다.
  • PAGE에서는 가급적 대용량의 메모리를 사용하는 경우(예를 들면, 비트맵 데이타 로딩)는 모두 C/C++ 쪽으로 빼버렸습니다. 즉, 메모리 사용한도는 루아상에서 선언한 변수들만 고려하면 됩니다. (메모리 관리 참조)
• 간단하고 심플한 대신, 지원되는 함수가 정말로 기본적인 것밖에 없습니다.
  
  

• 루아는 다음과 같은 6가지 데이타 타입이 있습니다.
  1. nil : 아무것도 아닌 텅빈 값을 의미합니다. 일반적으로 변수를 초기화할때 사용합니다.
  2. number : 0, 3.1415927 과 같은 사칙연산이 가능한 모든 숫자값을 의미합니다.
  3. string : 말그대로 문자열입니다. 루아의 기본타입이며, 스크립트상에서는 " 문자로 둘러싸 지정합니다. (예: "1234", "redpixel1111")
  4. userdata : C/C++과의 교류를 위해 존재하는 타입입니다. PAGE내에서는 핸들이라고 지정하는 것들이 바로 이 타입입니다. 스크립트를 작성할때 직접 값을 제어할 경우는 드물고 보통 엔진에서 제공되는 함수를 통해서 설정하고 변경, 해제하게 됩니다.
  5. function : 루아에서는 함수도 하나의 값으로 취급합니다. 즉, function으로 선언되면 실행도 되지만 function 타입의 변수에 대입도 가능합니다. (table과 연합하여 사용하면 매우 강력해집니다)
  6. table : 루아에서 제공하는 최강의 범용 자료구조 타입입니다. 다른 타입으로 변환이 불가능하며, 조금 사용법이 복잡합니다. (차후 설명)
     
     

• 루아에서 변수란 "어떤 값을 담고 있는 것의 명칭"으로 정의합니다. 즉, 앞서 설명한 데이타 타입의 값은 모두 변수에 저장됩니다.
• 루아에서는 다중 대입이 가능합니다.

x = y = 10 -- x와 y에 동시에 10을 대입
z = 20
x, z = z, x -- x와 z의 값을 교환. 즉, x는 20, z는 10이 담기게 됨.
y, z = 5, 7 -- y = 5; z = 7과 동일

• 다음 예제와 같은 연산이 가능합니다.

a = 10 + 4 -- 덧셈
b = 5 * 5 -- 곱셈
c = 10 - 40.4 -- 뺄셈
d = 55 / 5.3 -- 나눗셈
e = 10 ^ 3 -- 거듭제곱. 결과는 1000.

• 참고 : 나머지는 math 객체의 mod() 함수를 사용해서 구할 수 있습니다. (math 라이브러리 참조)
  
  

• 루아에서의 문자열내에서 글자에 대한 인덱싱은 1부터 시작합니다. (C언어와 같이 0이 아니다. 헛갈리지 말 것.)
• 음수 인덱싱도 허용하는데, 이때에는 문자열의 맨 끝에서부터 역으로 인덱싱을 하게 됩니다. (예를 들면, -1은 문자열의 맨 마지막 문자를 나타냅니다.)
• 두개의 문자열의 병합은 ".." 연산자를 사용합니다. 다음은 두개의 문자열을 합쳐 출력하는 예입니다.

a = "whitepixel"
b = "바보"
c = a..b
print(c) -- "whitepixel바보"가 출력된다

• 이 라이브러리는 문자열관리를 위한 검색, 부분 문자열의 추출, 패턴 대입등등을 지원하는 일반 함수들을 제공한다.
• 문자열 라이브러리의 모든 함수는 테이블 string내에 모두 담겨있다.
  
  

• 문자열 s의 i번째 문자의 내부 숫자로 표현된(예를 들면, 아스키 코드) 코드를 반환한다. 만일 i를 지정하지 않으면 1로 간주된다. i는 물론 음수로 지정될 수 있다.
  
  

• 0 이상의 정수만을 인자로 받는다. 각각의 숫자가 나타내는 코드에 해당되는 문자를 반환한다.
  
  

• 문자열 s내에서 pattern에 가장 첫번째로 맞는 부분을 찾아 반환한다. 만약 한개를 찾았다면 find()함수는 일치점의 시작과 끝을 나타내는 s의 인덱스들를 반환한다. 찾지 못하면 nil을 반환한다.
• 만약 pattern 문자열내에 "캡쳐"옵션이 지정되어 있다면(string.gsub 참조), 캡쳐된 문자열들도 반환값에 포함되어 반환된다.
• init 인자는 어디서부터 검색을 시작할 것인지에 대한 s 문자열내의 인덱스를 지정한다. 지정하지 않으면 1로 간주되며, 음수지정도 가능하다.
• plain 인자의 값을 true로 놓으면 패턴 매칭 기능을 끄는 효과가 있다. 이것은 아주 평범한(plain) 부분 문자열을 검색하는 명령이 되며, pattern 인자내에 들어있는 값들은 무시된다. 만일 plain 인자를 true로 지정하면 init도 반드시 지정해야 한다는 점에 주의해라. plain은 지정하지 않으면 당연히 false로 간주된다.
  
  

• 문자열의 길이를 반환한다. ""(빈 문자열)은 0을 반환한다. 첨부된 0값도 갯수에 포함된다. 그러므로 예를 들면 "a\000b\000c"의 길이는 5가 된다.
  
  

• 주어진 문자열을 모두 소문자로 바꾸고 그 결과 문자열의 복사본을 반환한다. (원본은 바뀌지 않는다.) 대소문자에 대한 구분은 현재 로케일 설정을 따른다.
  
  

• 문자열 s를 n번 반복하여 모두 병합한 값을 반환한다.
  
  

• 문자열 s내에서 i에서 시작하고 j에서 끝나는 부분에 대한 부분 문자열을 반환한다. i와 j는 음수 지정이 가능하다. j를 지정하지 않으면, -1로 간주된다. (즉, i에서 끝까지의 영역을 나타내게 된다.) 여러가지 지정을 예를 들면, 만일 문자열 s의 길이 j 만큼의 접두어를 때어내려면, string.sub(s, 1, j)라고 지정하면 되며, string.sub(s, -i)는 문자열 s에서 i길이 만큼의 접미어를 때내는 효과가 있다.
  
  

• 문자열 내의 모든 소문자들을 대문자로 바꾼 결과를 반환한다. 대소문자에 대한 구분은 현재 로케일 설정을 따른다.
  
  

• 첫번째 인자(반드시 문자열이어야 함)로 주어지는 정의를 따라서 다양한 수의 인자들을 잘 포맷한 결과물을 반환한다. C 언어에서 printf() 함수를 생각하면 된다. 내부 포맷룰도 같지만, 다음과 같은 차이가 있다.
  • *, l, L, n, p, h는 지원되지 않는다.
  • q 옵션이 제공된다. the q option formats a string in a form suitable to be safety read back by the Lua interpreter : The string is written between double quotes, and all double quotes, returns, and backslashs in the string are correctly escaped when written. For instance, the call

    string.format('%q', 'a string with "quotes" and \n new line')
    

    will produce the string:

  "a string with \"quotes\" and \
  newline"
  

  • c, d, E, e, f, g, G, i, o, u, X, x와 같은 모든 옵션은 숫자를 적용하여 사용하며, q와 s만 문자열을 적용하여 사용된다. the * modifier can be simulated by building th appropriate format string. For example, "%*g" can be simulated with "%"..width.."g".
    
    주의 : %s로 포맷되는 문자열 값은 '내장된 0' 값을 포함할 수 없다.
    
    

repl에 의해서

다음의 예문은 "temp" 라는 table에 차례로 "a","b","c"라는 값을 설정하는 것입니다.

temp = {"a","b","c"}

위의 예문의 테이블에서 값을 가져오려면. []를 사용하시면 됩니다.

다음의 예문은 위에서 작성한 "temp"에서 첫번째 값을 가져오는겁니다.

print(temp[1])

결과: a

• 지정한 '테이블'의 각 값에 대해 각각 '함수'를 실행합니다. (상당히 유용한 함수!)
• 순서는 인덱스값의 순서대로 실행됩니다.
• '함수'가 매번 실행될때마다 "인덱스, 값"으로 한번에 2개씩 인자를 넘깁니다.
• 다음은 t1 테이블의 각 요소를 화면에 출력하는 예제입니다. (print 다음에 ()가 없다는 것에 주목!)

table.foreach(t1, print)

• 다음을 콘솔에서의 실행 예제입니다.

> t1 = {}
> t1.redpixel = 10
> t1.whitepixel = 30
> t1.raktavisa = 20
> t1.hong = 40
> table.foreach(t1, print)
raktavisa       20
hong    40
redpixel        10
whitepixel      30

• 지정한 '테이블'의 각 값에 대해 인덱스의 순서대로 각각 '함수'를 실행합니다.
• 즉, 테이블의 인덱스는 반드시 숫자로 지정되어있어야하고 1에서 n까지 숫자의 건너뜀없이 지정되어 있어야 합니다!
• foreach()를 숫자 인덱스에 의해 마치 for문처럼 실행하고자 할 때 사용합니다.
• 다음은 foreach(), foreachi()의 비교를 위해 콘솔에서의 실행을 캡쳐한 것입니다.

> t1 = {}
> t1[1] = 10
> t1[3] = 30
> t1[2] = 20
> t1[4] = 40
> t1[9] = 90
> t1[6] = 60
> table.foreach(t1, print)
1       10
2       20
3       30
4       40
6       60
9       90
> table.foreachi(t1, print)
1       10
2       20
3       30
4       40

• 함수는 일정한 실행단위를 어느 순간에 한꺼번에 실행하기 위해 하나의 값으로 선언해놓은 것입니다. 즉, 함수값을 가지는 변수는 그 자체로 실행이 가능합니다.
• 루아는 값을 여러개 return할 수 있습니다. (예를 들면, a, b, c = func(d) 이런 것이 가능합니다.)
• 기본 문법은 다음과 같습니다. ([] 표시는 안적어도 문법에 맞다는 의미입니다. 즉, 인자1, 인자2...는 함수성격에 따라 적어도되고 안적어도 됩니다.)

function 함수명 ([인자1, 인자2, ...])
...
end

• 다음은 인자로 넘겨받은 문자열을 "바보"를 끝에 붙여서 출력하는 함수입니다.

function foolprint (i)
  local tmp = i.."바보"
  print(tmp)
end

• 함수를 사용하는 것은 다음과 같이 합니다.

foolprint("redpixel") -- "redpixel바보"라고 출력됩니다

• 함수는 반환값을 가질 수도 있습니다. 이때에는 함수내에 return이라고 하는 키워드를 사용합니다. 물론, 루아 특성상 여러개의 값을 반환할 수 있습니다.
• 다음은 두개의 인자를 받아서 더한 결과와 곱한 결과를 각각 반환하는 함수의 예입니다.

function calc1(x, y)
  local a = x + y
  local m = x * y
  return a, m
end

• 위 함수는 다음과 같이 사용될 수 있겠죠.

a, b = calc1(10, 10)
print(a, b) -- "20   100"이라고 출력됩니다.

조건문은 문장의 결과로서 참/거짓중 하나의 값만을 의미하는 문장을 의미합니다. 여기에는 몇가지 연산자가 비교수단으로 사용됩니다.

• == : 동일비교.
• ~= : 다름비교. (위와 반대)
• >=, <=, >, < : 크기비교.
• not : 부정. true는 false로, false는 true로.
• and : "그리고"의 의미. 두개의 조건문이 모두 true여야 true로 처리.
• or : "또는"의 의미. 두개의 조건문이 모두 false여야 false로 처리.
• true : 항상 참.
• false : 항상 거짓.

• 기본 if문은 다음과 같다.

if i ~= 0 then
  print("0이 아니자나!")
end

• 물론, 아닐 경우도 첨부할 수 있다. 이때에는 else를 사용한다. (else위에 end를 쓰지 않는 것에 주의한다. end는 맨 마지막에 한번만 적으면 된다.

if i == 0 then   -- i가 0과 같으면
  print("0이군.")
else
  print("0아님.")
end

• 아닐경우 한번더 검사를 하고 싶으면 elseif를 사용한다. 역시 가장 마지막에만 end를 쓴다는 것에 주의.

if i == 1 then   -- i가 1과 같으면
  print("1이군.")
elseif i == 0 then  -- 그렇지 않고 i가 0과 같으면
  print("0이네~")
else
  print("0도 1도 아니네~")
end

• 기본 문법은 다음과 같다. 이 명령의 의미는 "지정한 조건이 true값을 반환할 동안 반복적으로 실행한다"는 뜻이다.

while 조건문 do
....
end

• 예를 들면, 다음의 문장은 "!"를 100회 출력한다.

i = 0
while i ~= 100 do  -- i가 100이 아닐동안 반복한다
  print("!")
  i = i + 1
end

• 기본 문법은 다음과 같다. 이 명령의 의미는 "지정한 조건이 true가 될때까지 반복적으로 실행한다"는 뜻이다. (즉, 위 while문과는 반대의 의미이다!)

repeat
....
until 조건문

• 예를 들면, 다음의 문장은 "redpixel"을 50회 출력한다.

i = 50
repeat
  print("redpixel")
  i = i - 1
until i == 0    -- i가 0이 될때까지 반복한다

• 다른 언어와의 마찬가지로 지정된 범위를 지정함으로서 반복명령을 수행하는 것이 for명령이다. 기본 문법은 다음과 같다.

• 현재 루아내의 전체 메모리 사용상태를 반환합니다. 첫번째 값은 점유용량이고, 두번째 값은 루아내에 할당된 종 허용용량입니다. 단위는 KByte입니다.
• 인자는 없습니다.
• print(gcinfo())를 해보면 쉽게 결과를 볼 수 있습니다.
  
  

• 루아가 메모리 정리를 하는 한계메모리 사용량을 정의합니다. (gcinfo()에서 두번째 값을 말합니다)
• 이것이 넓을수록 자동으로 메모리 관리가 실행되는 확률이 줄어듭니다.
  
  

화일을 열고 그 화일에 해당하는 화일 핸들을 반환한다. 에러일 경우에는 nil을 반환한다. mode는 string 형으로 지정하며 옵션은 다음과 같다.

"r"	읽기모드
"w"	쓰기모드
"a"	첨부모드
"r+"	갱신모드. 읽기모드지만 이전 화일은 삭제.
"w+"	갱신모드. 쓰기모드지만 이전 화일은 삭제.
"a+"	첨부모드지만 화일의 끝에서부터만 쓰기가 허용.

b문자를 mode 문자열의 끝에 첨가하면 이진화일형태로 열게 된다.

임시화일을 생성하고 그 화일에 대한 핸들을 반환한다. 임시화일은 차후 프로그램이 종료하면 자동으로 삭제된다.

fh는 위의 핸들 획득 함수들의 반환값인 화일 핸들을 의미한다.

해당 화일을 닫는다.

현재 버퍼에 담겨있는 기록중인 데이타를 모두 화일에 적용한다.

화일 핸들 fh로부터 주어진 포맷에 따라 데이타를 읽어들여 그 값을 반환한다. 포맷문자열안에 들어가는 명령은 다음과 같다.

"*n"	숫자를 읽어들여 반환한다. 이것은 number 타입으로 반환하는 유일한 포맷이다.
"*a"	현재 위치에서 나머지 전체 내용을 읽어들여 그 내용을 반환. 화일의 끝에서 명령을 실행한거라면 nil반환.
"*l"	다음 줄을 읽어들인다.(EOF는 건너뛴다) 화일의 끝에서 명령을 실행한거라면 nil반환. 이것이 기본 포맷임.
숫자	주어진 숫자만큼의 문자를 읽어들여 그 내용을 반환한다. 0을 지정하면 아무것도 읽지않고 텅빈 문자열을 반환한다. 화일의 끝에서 명령을 실행한거라면 nil반환.

예제:

myfile = open("test.txt","r")
t1 = myfile:read(3) -- t1에 3글자만큼 문자열을 읽어서 기록(문자열)
n2 = myfile:read("*n") -- n1에 숫자를 읽어 그 값을 기록(숫자)
t3 = myfile:read() -- 한줄을 모두 읽어 t3에 기록(문자열)

Sets and gets the file position, measured in bytes from the beginning of the file, to the position given by offset plus a base specified by the string whence, as follows:

“set” base is position 0 (beginning of the file);
“cur” base is current position;
“end” base is end of file;

In case of success, function seek returns the final file position, measured in bytes from the beginning of the file. If this function fails, it returns nil, plus a string describing the error. The default value for whence is "cur", and for offset is 0. Therefore, the call file:seek() returns the current file position, without changing it; the call file:seek("set") sets the position to the beginning of the file (and returns 0); and the call file:seek("end") sets the position to the end of the file, and returns its size.

Writes the value of each of its arguments to the filehandle fh. The arguments must be strings or numbers. To write other values, use tostring or format before write. If this function fails, it returns nil, plus a string describing the error.