2.4. 데이터베이스

데이터를 레코드 단위로 저장하고, 찾으며 관리하기 위한 API들이다. 레코드는 문자 어레이의 형태로 저장된다. 저장되는 데이터의 의미는 무시된다. 저장 된 데이터의 논리적인 의미를 파악하는 것은 사용자의 몫이다. 레코드 크기는 처음 데이터베이스를 생성할 때 지정한 크기를 초과할 수 없다. 각 레코드는 데이터베이스 상에서 레코드 식별자라는 정수 값으로 표현된다. 레코드 가 중간에 삭제되면 다음 레코드를 저장할 때 삭제된 레코드 식별자를 재사용한다. 레코드 식별자는 음수가 될 수 없다. 레코드의 빈번한 추가/삭제로 데이터베이스에 저장된 레코드의 개수와 데이터베이스 가 실제 플랫폼의 물리적인 영역에 저장된 용량이 차이가 날 수 있다. 하나의 응용 프로그램은 여러 개의 데이터베이스를 생성할 수 있으며 자신이 생성한 데이터베이스 모두에 접근이 가능하다. 하지만 대부분의 경우 다른 응용프로그램이 생성한 데이터베이스에 접근할 수 없다. 데이터베이스를 공유디렉토리에 생성시키는 방법으로 여러 응용프로그램이 공유할 수도 있으며, 해당 응용프로그램이 권한이 있 다면 시스템 프로그램이 사용하는 데이터베이스에 접근할 수 있다. 이는 데이터베이 스를 열 때 플래그를 지정해서 이루어진다. 모든 데이터베이스 함수는 함수의 수행이 끝난 후에 반환된다. 예를 들어 MC_dbInsertRecord 함수의 경우 데이터가 물리적인 저장영역에 쓰여진 후에 반환된 다. 따라서 이 함수가 반환된 즉시 MC_dbSelectRecord로 바로 이전에 저장한 레코 드를 가져 올 수 있다. 응용프로그램이 종료되더라도 데이터베이스는 수행이 종료된 시점의 상태대로 보존 되어 다음 수행 시에 이용할 수 있다. 하지만 응용프로그램이 플랫폼 상에서 지워지 면 해당 응용프로그램이 생성한 데이터베이스는 삭제된다.

MC_dbOpenDataBase

프로토타입

M_Int32 MC_dbOpenDataBase(M_Char* dataBaseName, M_Int32 recordSize,
M_Boolean create, M_Int32 mode)

설명

데이터베이스를 연다. 데이터베이스의 공유 모드는 플래그로 지정할 수 있다. 고정크기의 레코드만 지원한 다. 레코드는 연속된 문자 어레이로 표현되며 레코드의 논리적인 의미는 데이터베이 스 사용자가 파악하고 있어야 한다.

매개 변수

• dataBaseName - 데이터베이스 이름, 이름으로 쓸 수 있는 문자는 파일 시스템의 제한사항을 따른다.
• recordSize - 생성할 데이터베이스의 레코드 하나의 크기(byte 단위). 데이터베이스가 이미 존재하는 경우 지정된 recordSize는 무시되고 기존의 레코드 크기가 적용됨
• create - 만약 데이터베이스가 존재하지 않으면 새로 만들 것인지 여부
• mode - 데이터베이스의 공유 방법을 지정, MC_DIR_PRIVATE_ACCESS, MC_DIR_SHARED_ACCESS, MC_DIR_SYSTEM_ACCESS 중 하나가 가능

반환 값

성공

데이터베이스 식별자(0보다 큰 정수) 실패

• M_E_NOENT - create가 거짓인데 데이터베이스가 존재하지 않는 경우
• M_E_INVALID - create가 참인데 recordSize가 0이거나 음수인 경우, dataBaseName이 NULL인 경우, mode가 위에서 기술한 셋 중 하나가 아닌 경우
• M_E_ERROR - 기타 데이터베이스를 열 수 없는 경우

부작용

없음

참고 항목

MC_dbCloseDataBase, MC_fsOpen

MC_dbCloseDataBase

프로토타입

M_Int32 MC_dbCloseDataBase(M_Int32 dbId)

설명

데이터베이스를 닫는다.

매개 변수

• dbId - 데이터베이스 식별자

반환 값

성공

실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_ERROR - 기타 이유로 실패할 경우

부작용

없음

참고 항목

MC_dbOpenDataBase

MC_dbDeleteDataBase

프로토타입

M_Int32 MC_dbDeleteDataBase(M_Char* dataBaseName, M_Int32 mode)

설명

데이터베이스를 삭제한다. 해당 응용프로그램이 접근 가능한 데이터베이스만 삭제가 가능하다. 열려있는 데이 터베이스는 삭제할 수 없다.

매개 변수

• dataBaseName - 삭제할 데이터베이스 이름
• mode - 어떤 접근권한에 있는 데이터베이스를 지울 것인지를 나타냄, MC_DIR_PRIVATE_ACCESS, MC_DIR_SHARED_ACCESS,
• MC_DIR_SYSTEM_ACCESS - 중 하나가 가능

반환 값

성공

실패

• M_E_NOENT - 데이터베이스가 존재하지 않는 경우
• M_E_INUSE - 데이터베이스가 닫혀 있지 않은 경우
• M_E_INVALID - dataBaseName이 NULL이거나, mode가 위에서 기술한 셋 중 하나가 아닌 경우
• M_E_ACCESS - 접근 권한이 없는 데이터베이스를 지우려 하는 경우
• M_E_ERROR - 기타 이유로 실패할 경우

부작용

없음

참고 항목

MC_dbCloseDataBase, MC_fsOpen

MC_dbInsertRecord

프로토타입

M_Int32 MC_dbInsertRecord(M_Int32 dbId, M_Byte* buf, M_Int32 len)

설명

새로운 레코드를 데이터베이스에 추가한다. 버퍼에 저장된 데이터를 하나의 레코드로 데이터베이스에 저장한다. 저장할 버퍼의 크기가 데이터베이스를 생성할 때 지정한 레코드 크기보다 작으면, 남는 영역에 쓰 레기값(garbage)이 저장되어 있을 수 있다. MC_dbSelectRecord는 레코드 크기 단위로 데이터를 읽어오기 때문에 레코드 크기 보다 작은 데이터를 저장했다면, 이후 다시 읽어 들인 문자 어레이에서 실제 데이터 뒤에 쓰레기값(garbage)이 들어 있을 수 있다.

매개 변수

• dbId - 레코드를 추가할 데이터베이스 식별자
• buf - 데이터가 저장되어 있는 버퍼
• len - 저장할 데이터의 크기

반환 값

성공

레코드 식별자(0보다 큰 정수) 실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_DATABIG - 데이터베이스의 레코드 크기보다 더 큰 데이터를 저장하려 하는 경우
• M_E_INVALID - len이 0이거나 음수인 경우, buf가 NULL인 경우
• M_E_ERROR - 기타 데이터를 저장할 수 없는 경우

부작용

없음

참고 항목

MC_dbSelectRecord, MC_dbUpdateRecord, MC_dbDeleteRecord

MC_dbSelectRecord

프로토타입

M_ Int32 MC_dbSelectRecord(M_Int32 dbId, M_Int32 recId, M_Byte* buf,
M_Int32 len)

설명

특정 레코드 식별자에 저장된 데이터를 돌려준다. 읽어 들인 데이터는 버퍼에 복사되어 돌려진다. 이 함수를 호출한 이후에 버퍼의 내 용을 바꾸더라도 데이터베이스에 저장된 레코드는 변하지 않는다. 버퍼의 크기는 해 당 데이터베이스의 레코드 크기보다 크거나 같아야 한다. 데이터베이스의 하나의 레 코드의 크기는 MC_dbGetRecordSize 함수로 알아올 수 있다.

매개 변수

• dbId - 데이터베이스 식별자
• recId - 레코드 식별자
• buf - 데이터를 받을 버퍼
• len - 버퍼의 길이

반환 값

성공

실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_BADRECID - 해당 레코드 식별자가 존재하지 않는 경우
• M_E_INVALID - len이 0이거나 음수인 경우, buf가 NULL인 경우
• M_E_SHORTBUF - 주어진 버퍼가 레코드 크기보다 작은 경우
• M_E_ERROR - 기타 이유로 레코드를 읽어올 수 없는 경우

부작용

없음

참고 항목

MC_dbInsertRecord, MC_dbUpdateRecord, MC_dbDeleteRecord

MC_dbUpdateRecord

프로토타입

M_ Int32 MC_dbUpdateRecord(M_Int32 dbId, M_Int32 recId, M_Byte* buf,
M_Int32 len)

설명

특정 레코드의 데이터의 내용을 바꾼다. 해당 레코드 식별자에 저장되어 있던 내용 을 새로운 내용으로 바꾼다.

매개 변수

• dbId - 데이터베이스 식별자
• recId - 데이터 내용을 변경시킬 레코드 식별자
• buf - 새로이 저장할 데이터가 들어있는 버퍼
• len - 버퍼의 크기

반환 값

성공

실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_BADRECID - 해당 레코드 식별자가 존재하지 않는 경우
• M_E_DATABIG - 갱신하려는 데이터가 데이터베이스 생성시에 지정한 레코드 크기보다 큰 경우
• M_E_INVALID - len이 0이거나 음수인 경우, buf가 NULL인 경우
• M_E_ERROR - 기타 이유로 레코드를 갱신할 수 없는 경우

부작용

없음

참고 항목

MC_dbInsertRecord, MC_dbSelectRecord, MC_dbDeleteRecord

MC_dbDeleteRecord

프로토타입

M_Int32 MC_dbDeleteRecord(M_Int32 dbId, M_Int32 recId)

설명

레코드를 데이터베이스에서 삭제한다. 매개변수로 받은 레코드 식별자에 해당하는 레코드를 지운다.

매개 변수

• dbId - 데이터베이스 식별자
• recId - 지울 레코드의 식별자

반환 값

성공

실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_BADRECID - 해당 레코드 식별자가 존재하지 않는 경우
• M_E_ERROR - 기타 이유로 레코드를 지울 수 없는 경우

부작용

없음

참고 항목

MC_dbInsertRecord, MC_dbSelectRecord, MC_dbUpdateRecord

MC_dbListRecords

프로토타입

M_Int32 MC_dbListRecords(M_Int32 dbID, M_Int32* buf, M_Int32 len)

설명

데이터베이스에 저장된 레코드들의 레코드 식별자를 돌려준다. 매개변수로 받은 정수형 배열에 데이터베이스에 저장된 레코드들의 레코드 식별자를 저장해서 돌려준다. 돌려지는 레코드 식별자의 순서는 실제 레코드를 저장한 순서와 다를 수 있다.

매개 변수

• dbId - 데이터베이스 식별자
• buf - 받아온 레코드 식별자를 저장할 버퍼
• len - 버퍼의 크기

반환 값

성공

레코드 개수 실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_INVALID - len이 0이거나 음수인 경우, buf가 NULL인 경우
• M_E_SHORTBUF - 레코드 식별자를 받아올 버퍼가 너무 작은 경우
• M_E_ERROR - 기타 이유로 실패한 경우

부작용

없음

참고 항목

MC_dbSortRecords

MC_dbSortRecords

프로토타입

M_Int32 MC_dbSortRecords(M_Int32 dbID, M_Int32* buf, M_Int32 len,
M_Int32 (*compare)(const void *, const void *), M_Int32 (*filer)(const void *))

설명

데이터베이스에 저장된 레코드들의 정렬된 레코드 식별자를 돌려준다. 각 레코드를 바이트 별로 비교해 정렬한다. 예를 들어 어떤 데이터베이스의 레코드 크기가 2이고 아래와 같이 4개의 레코드가 저장되어 있다면, ============================ | 레코드식별자 | 데이터 | ============================ | 0 | 0x33 0x22 | | 1 | 0x11 0x22 | | 2 | 0x22 0xff | | 3 | 0x11 0xff | ============================ * 이 함수를 호출하면 매개변수로 받은 정수형 버퍼에 1, 3, 2, 0 순서로 레코드 식별자 가 저장되어 돌려지며 4(레코드 개수)가 반환된다(매개 변수인 compare와 filter를 모 두 NULL로 넣은 경우). 응용 프로그램 작성자가 정렬 방법을 지정하거나 정렬에 사용할 레코드를 제한하는 기능은 이 함수의 매개 변수를 사용해 구현할 수 있다. 정렬할 때 두 개의 레코드의 순서를 정하는 방법을 compare를 구현해 지정할 수 있 다. compare가 받는 매개 변수는 데이터베이스에 저장한 레코드이다. 이 함수는 두 개의 레코드를 비교해서 첫 번째 매개변수로 받은 레코드가 두 번째 매개변수로 받 은 레코드보다 앞에 오면 0보다 큰 정수를, 뒤에 오면 0보다 작은 정수를, 두 개의 순서가 동일하면 0을 반환해야 한다. filter는 특정 레코드를 정렬에 포함시킬 것인지 결정하는 함수이다. 레코드를 정렬에 포함시키려면 0보다 큰 정수를, 정렬에서 제외하려면 0을 반환해야 한다. filter가 받 는 매개 변수도 레코드이다. 함수를 호출한다 하더라도 저장된 데이터베이스의 구조는 변하지 않는다.

매개 변수

• dbId - 데이터베이스 식별자
• buf - 받아온 레코드 식별자들을 저장할 버퍼
• len - 버퍼의 크기
• compare - 두 레코드를 비교하기 위한 함수 포인터, NULL 이면 앞의 예제처럼 각 byte 별로 올림차순으로 정렬됨
• filter - 정렬에 사용할 레코드를 제한하는 함수 포인터, NULL이면 모든 레코드를 정렬에 사용함 반환 값

반환 값

성공

레코드 개수 실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_INVALID - len이 0이거나 음수인 경우, buf가 NULL인 경우
• M_E_SHORTBUF - 레코드 식별자를 받아올 버퍼가 너무 작은 경우
• M_E_ERROR - 기타 이유로 실패한 경우

부작용

없음

참고 항목

MC_dbListRecords

MC_dbGetAccessMode

프로토타입

M_Int32 MC_dbGetAccessMode(M_Char* dataBaseName)

설명

데이터베이스의 접근 권한을 돌려 준다. 해당 응용프로그램이 생성한 데이터베이스와, 서로 공유할 수 있는 데이터베이스, 시 스템에서 사용하는 데이터베이스의 접근권한을 알아 볼 수 있다. 단 해당 응용프로 그램이 접근할 수 있는 데이터베이스만 접근 권한을 알아 볼 수 있다.

매개 변수

• dataBaseName - 접근 권한을 알아볼 데이터베이스 이름

반환 값

성공

DIR_PRIVATE_ACCESS, DIR_SHARED_ACCESS,DIR_SYSTEM_ACCESS 중 한가지 값 실패

• M_E_NOENT - 데이터베이스가 존재하지 않는 경우
• M_E_INVALID - dataBaseName이 NULL인 경우
• M_E_ERROR - 기타 이유로 실패한 경우

부작용

없음

참고 항목

MC_dbOpenDataBase, MC_fsOpen

MC_dbGetNumberOfRecords

프로토타입

M_Int32 MC_dbGetNumberOfRecords(M_Int32 dbId)

설명

데이터베이스에 저장된 레코드 개수를 돌려준다.

매개 변수

• dbId - 데이터베이스 식별자

반환 값

성공

레코드 개수 실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_ERROR - 기타 이유로 실패한 경우

부작용

없음

참고 항목

없음

MC_dbGetRecordSize

프로토타입

M_Int32 MC_dbGetRecordSize(M_Int32 dbId)

설명

데이터베이스의 하나의 레코드 크기를 돌려준다.

매개 변수

• dbId - 데이터베이스 식별자

반환 값

성공

레코드의 크기(byte) 실패

• M_E_BADFD - 데이터베이스 식별자가 잘못된 경우
• M_E_ERROR - 기타 이유로 실패한 경우

부작용

없음

참고 항목

MC_dbOpenDataBase

MC_dbListDataBases

프로토타입

M_Int32 MC_dbListDataBases(M_Byte* buf, M_Int32 len)

설명

데이터베이스의 이름의 어레이를 돌려준다. MC_DIR_PRIVATE_ACCESS 로 생성한 데이터베이스와 MC_DIR_SHARED_ACCESS, MC_DIR_SYSTEM_ACCESS 로 생성한 데이터베이스 중 응용프로그램이 접근 가능한 데이터베이스의 이름을 돌려준다. 버퍼를 통해 돌려 지는 각각의 데이터베이스는 NULL(₩0)로 구분이 되며 리스트의 끝은 두 개의 연속 된 NULL로 표현된다.

매개 변수

• buf - 데이터베이스 이름을 저장할 버퍼
• len - 버퍼의 크기

반환 값

성공

데이터베이스의 개수(데이터베이스가 하나도 없는 경우도 성공한 것으로 간주함) 실패

• M_E_SHORTBUF - 어레이를 받아오기에 버퍼가 너무 작은 경우
• M_E_INVALID - len이 0이거나 음수인 경우, buf가 NULL인 경우
• M_E_ERROR - 기타 이유로 실패한 경우

부작용

없음

참고 항목

MC_dbOpenDataBase, MC_fsOpen