as_DBMDeleteFieldContent

as_DBMDeleteFieldContent

Description
특정 레코드의 특정 필드값을 삭제한다.

Syntax
DBMErr as_DBMDeleteFieldContent(ScanId scanId, RecId recId, FieldId fieldId);

Parameters

scanId	스캔 ID
recId	레코드의 ID
fieldId	삭제하려는 필드의 ID

Returns

value	설명
DBM_OK	필드값이 성공적으로 삭제된 경우, 혹은 원래 레코드에 해당 필드 값이 없는 경우
DBM_INVALID_SCAN_ID	주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우

DBM_INVALID_REC_ID	주어진 레코드 id를 갖는 레코드가 존재하지 않는 경우
DBM_INVALID_FIELD_ID	주어진 필드 id가 테이블 스키마에 존재하지 않는 경우
DBM_MEM_ALLOC_ERR	필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED	데이타베이스가 초기화되어 있지 않은 경우

Comments
레코드의 modify 플래그가 DBM_ON으로 설정된다.
(단, 이미 add flag가 DBM_ON인 경우는 제외한다. )

Example
#include "dbm.h"
void main(void)
{
   DBMErr ret;
   FieldId fieldId;

/* Get scanId by opening a scan with some scan functions. For example
   ScanId scanId;
   TableId tableId = 100;
   as_DBMOpenSeqScanTable(tableId, DBM_PRIM, 0, DBM_INCR, &scanId);
   See the example of as_DBMOpenSeqScanTable function.
   as_DBMDeleteFieldContent
*/
/* Get RecordId. For example
   RecordId recId;
   S32 numExistFields;
   S32 numFields;
   FieldDataInfo * fieldDataInfos;
   as_DBMNumFieldsInTable(tableId, &numFields);
   fieldDataInfos = (FieldDataInfo )malloc(sizeof(FieldDataInfo)*numFields);
   ret = as_DBMGetNextRecordId(scanId, &recId, &numExistFields, fieldDataInfos);
   if (ret == DBM_OK) //Success!
   else // error handling
*/

   ret = as_DBMDeleteFieldContent(scanId, tableId, fieldId);
   if (ret == DBM_OK) //Success!
   else // error handling
}