as_DBMAddFieldToTableSchema

Description
테이블 스키마에 새로운 필드를 추가한다.

Syntax
DBMErr as_DBMAddFieldToTableSchema(TableId tableId, FieldInfo *newFieldInfo);

Parameters
tableId테이블 ID
newFieldInfo새로 추가되는 필드에 관한 정보. 필드 이름, 필드 ID, 타입을 저장하고 있다

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_TABLE_ID주어진 테이블 id가 유효하지 않은 경우
DBM_INVALID_FIELD_INFO 새 필드 id가 적절하지 않은 경우
(1 < = 새 필드 id<NUM_FIELDS이어야 함)
새 필드이름의 길이가 적절하지 않은 경우
(0 < 필드이름 길이 < = FIELD_NAME_LEN)
새 필드의 타입이 적절하지 않은 경우
주어진 새 필드 id가 이미 존재하는 경우
주어진 새 필드 이름이 이미 존재하는 경우
DBM_TOO_MANY_FIELDS이미 테이블에 정의된 필드수가 NUM_FIELDS인 경우
DBM_MEM_ALLOC_ERR필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED 데이타베이스가 초기화되어 있지 않은 경우

Comments
이미 생성된 테이블의 스키마에 새로운 필드를 추가하고자 할 경우에 사용한다.
필드 이름은 테이블 내에서 유일해야 한다.

매개변수에서 사용되는 newFieldInfo의 자료구조는 다음과 같다.
typedef struct {
  S8 name[FIELD_NAME_LEN+1];
  FieldId id;
  FieldDataType type;
} FieldInfo;


필드의 ID는 응용 프로그램이 설정하는데, 이때 다음 사항을 지켜야 한다.
0 : primary key field
0부터 29 : BLOB 이외의 필드
30부터 31 : BLOB 필드


Example
#include "dbm.h"
#include <string.h>

void main(void)
{
   DBMErr ret;
   FieldInfo fieldInfo;
   TableId tableId = 0;
  
   fieldInfo.id = 1;
   strcpy(fieldInfo.name, "age");
   fieldInfo.type = DBM_INT2;
  
   ret = as_DBMAddFieldToTableSchema(tableId, &fieldInfo);
   if (ret == DBM_OK)
     // Success!
   else
     // Fail!
}