stdlib5.kdb [win & linux] : 간단한 설정 파일을 저장용 키-값 구조체 DB.

class toolbox func read(str raw) # 문자열을 받아 내부 저장소에 파싱 결과를 저장. func write() -> str # 내부 저장소 데이터를 포매팅해 문자열로 출력. func get(str name) -> [int index, int type, int ptr, any data] # 키 문자열을 받아 파라미터와 값으로 이루어진 파이썬 리스트 반환. func fix(str name, any data) # 키 문자열과 새 값을 받아 기존 값을 교체. func imp([str name, any data, str end][] arr) # 분해된 kdb 리스트를 받아 내부 저장소에 추가. func exp() -> [str name, any data, str end][] # 내부 저장소를 분해 kdb 리스트로 반환, 표준 형식임.

.name (int index)[str name] # 키 문자열 -> 인덱스 정수의 딕셔너리.
.type int[] # 타입 정보를 저장하는 리스트.
.ptr int[] # 데이터 포인터를 저장하는 리스트.
.fmem float[] # 실수 값을 저장하는 리스트.
.cmem complex[] # 복소수 값을 저장하는 리스트.
.bmem bytes[] # 바이트 값을 저장하는 리스트.

func Set(interface v) -> kdbvar # 7type을 받고 그 값을 가지는 kdbvar 반환. struct kdbvar .Dat0 str # 타입 문자열. (None, bool, int, float, complex, bytes, str) .Dat1 bool # 불 타입 저장소. .Dat2 int # 정수 타입 저장소. .Dat3 float # 실수 타입 저장소. (float64) .Dat4 complex # 복소수 타입 저장소. (complex128) .Dat5 byte[] # 바이트 배열 저장소. .Dat6 string # 문자열 값 저장소.

func Initkdb() -> toolbox

내부 map을 초기화, toolbox 구조체를 반환.

struct toolbox func Read(str raw) -> error # 문자열을 받아 내부 저장소에 파싱 결과를 저장. func Write() -> (str, error) # 내부 저장소 데이터를 포매팅해 문자열로 출력. func Get(str name) -> (kdbvar, int[]) # 키 문자열을 받아 값과 파라미터 정수 배열 반환. # 파라미터 배열은 다음 형태이며, 오류 시 빈 배열이 반환됨. [int index, int type, int ptr] func Fix(str name, interface v) -> error # 키 문자열과 새 값을 받아 기존 값을 교체. func Imp(str[] names, kdbvar[] datas, str[] ends) -> error # 분해된 kdb 배열을 받아 내부 저장소에 추가. func Exp() -> str[] names, kdbvar[] datas, str[] ends # 내부 저장소를 분해 kdb 배열로 반환, 표준 형식임. 오류 시 빈 배열이 반환됨.

.Name (int index)[str name] # 키 문자열 -> 정수 인덱스로의 해시맵.
.Tp byte[] # 타입 정보를 저장하는 바이트 배열.
.Ptr int[] # 데이터 포인터를 저장하는 정수 배열.
.Fmem float[] # 실수 값을 저장하는 배열.
.Cmem complex[] # 복소수 값을 저장하는 배열.
.Bmem byte[][] # 바이트 배열 값을 저장하는 배열.

!!입출력 형태 경고!! 읽기/쓰기 함수는 모두 원래 키의 순서를 보장한다. imp 함수 사용 시 키 리스트에는 표준 형식이 들어가야 한다. 후술할 설명의 허용 형식(.과 /를 사용한 압축 형식)은 오류가 날 수 있다.

효율적인 저장공간 사용과 이식성을 위해 kdb는 내부적으로 키 -> 인덱스 -> 타입, 포인터 -> 값 구조를 가진다. 타입은 0255 정수이며, 16으로 나눈 몫이 0이면 end가 줄바꿈, 1이면 end가 세미콜론이다. 16으로 나눈 나머지가 06이면 각각 None, bool, int, float, complex, bytes, str이다. 타입과 포인터 배열은 항상 전체 데이터 개수와 동일하며, 인덱스를 통해 접근할 수 있다. 타입 배열의 순서가 실제 데이터의 입력 순서이다. 포인터 정수는 값을 직접 나타내거나, 타입에 따라 다른 값 저장 배열을 가리킬 수 있다. 포인터 정수의 특징 : None이면 항상 0이다, bool이면 참이면 1 거짓이면 0이다. int면 값 그 자체다, float면 fmem 인덱스다, complex면 cmem 인덱스다. bytes면 bmem 인덱스다, str이면 utf-8인코딩한 바이트열이 위치한 bmem의 인덱스다.

기본적으로 문자열 키 - 다양한 타입의 값 구조이며, 가능한 값 종류와 문자열 표기 규칙은 다음과 같다. NULL - None 으로 표기한다. BOOL - True 와 False 로 표기한다. INT - 부호와 09 숫자. ex) 0, -3, 006 FLOAT - 부호와 09 숫자에 소수점이 있는 경우. ex) 0.0, -3.05, 7.0 COMPLEX - 두 숫자형과 부호에 끝이 i인 경우. ex) 0.0+0i, -4-6i, 0.04+4.06i BYTES - 단일따옴표 안에 16진법 숫자로 표시. ex) '', '00414f', '8A91' (16진 표기에 소문자가 원칙이나 대문자도 허용한다.) STRING - 쌍따옴표 안에 #을 이스케이프 코드로 표시. ex) "", "안녕abc01", "31.07" (#은 ##, "은 #", 줄바꿈은 #n, 공백은 #s가 원칙이나 그냥 사용하는 것도 허용한다.) ("\n"과 "#n"은 길이가 2와 1로 다르다.) ex) "st ri#sng", "#n#####"", "#"#"", "#s\n#n##"

데이터는 다음 구조가 반복된다. -> 글자 제한이 있는 식별자, 등호 할당자, 문자열로 포메팅된 값, 종결자 식별자엔 공백과 등호를 사용할 수 없다. ex) 가나, wow65, 01 등호 전후로 식별자와 값이 구분된다. 포메팅 방식은 위에서 설명한 방식 그대로다. 종결자는 줄바꿈 혹은 세미콜론으로 구문을 끝낸다. 다음은 데이터 구조 예시이다. 01=01; 가나abc3 = 3 !!= " var = 0 " ; a=6.5;b=6.6 *hey? = ";";:=True

식별자는 마침점을 통해 구조화될 수 있다. abc.def.ghi와 같은 이름은 이 식별자가 상위 2개의 구조체 안에 있음을 나타낸다. 원칙적으로는 상위 식별자가 모두 텍스트 안에 있을 필요는 없으며, 상위 식별자를 생략하지 않고 모두 명시해야 한다. 다음은 데이터 텍스트 예시이다. f0.g0.h0 = 0 f0.g1 = 1 f1.g0 = 2 f1 = 3 f0 = 4

가장 앞 부분에서 연속하는 마침점을 사용해서 상위 구조를 생략하는 것도 허용된다. 또한 마침점을 사용하는 것이 원칙이나, 슬래시를 사용하는 것도 허용된다. 등호로 할당되지 않은 식별자는 주석 처리되어 무시된다. 다음은 텍스트 예시이다. f0 = 0 .g0 = 1 ..h0 = 2 .g1 = 3 ..h0 = 4 축약을 사용했으므로 상위 구조가 앞서서 모두 등장해야 한다. com?"# f1 = 5 f2 = 6;/g0=7;//h0=8;///k=9