DBMCreateCategory

Description
테이블에 새로운 Category를 추가한다.

Syntax
DBMErr DBMCreateCategory(TableId tableId, CatId catId, P_S8 catName);

Parameters
tableId테이블 ID
catId Category ID
catName추가되는 Category의 이름
이름의 최대 길이는 CAT_NAME_LEN이다.
이름의 끝은 '\0'으로 식별한다.

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_TABLE_ID주어진 테이블 id를 갖는 테이블이 존재하지 않는 경우
DBM_TOO_MANY_CATS테이블에 정의된 Category의 개수가 이미 NUM_CATS인 경우
DBM_INVALID_CAT_NAME(catName의 길이) <= 0이거나 (catName의 길이) > CAT_NAME_LEN인 경우
DBM_INVALID_CAT_ID동일한 id의 Category가 이미 존재하는 경우
DBM_CAT_NAME_EXIST동일한 이름의 Category가 이미 존재하는 경우
DBM_MEM_ALLOC_ERR 필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우

Comments
Category ID와 이름은 테이블 내에서 유일해야 하며, 응용 프로그램에서 설정하여 매개변수로 넘겨준다.

Example
// get tableId
CatId catId = 1; S8 catName[CAT_NAME_LEN+1];
strcpy(catName, "Category1");
ret = DBMCreateCategory(tableId, catId, catName);
if (ret < DBM_OK) // error handling