DBMSetFieldContent

Description
특정 레코드의 특정 필드값을 지정, 또는 변경한다.

Syntax
DBMErr DBMSetFieldContent(ScanId scanId, RecId recId, FieldData *fieldData);

Parameters
scanId스캔 ID
recId레코드의 ID
*fieldData특정 필드의 값에 대한 정보
ID, 데이타 타입, 길이, 실제 데이타로 이루어져 있다.

Returns
value설명
DBM_OK성공적으로 수행된 경우
DBM_INVALID_SCAN_ID주어진 스캔 id를 갖는 스캔이 존재하지 않는 경우
DBM_INVALID_REC_ID주어진 레코드 id를 갖는 레코드가 존재하지 않는 경우
DBM_INVALID_FIELD_ID주어진 필드 id가 테이블 스키마에 존재하지 않는 경우
DBM_INVALID_FIELD_TYPE주어진 필드 데이타 타입이 테이블 스키마와 일치하지 않을 때
DBM_INVALID_FIELD_LEN len이 0보다 작거나 같은 경우
DBM_MEM_ALLOC_ERR 필요한 메모리를 할당받지 못한 경우
DBM_DB_NOT_INITED데이타베이스가 초기화되어 있지 않은 경우

Comments
BLOB 필드도 문자열 필드와 마찬가지로 처리한다.

레코드의 modify 플래그가 DBM_ON로 설정된다
(단, 이미 add 플래그가 DBM_ON인 경우는 제외한다. 즉, add된 후 update된 레코드는 그냥 add된 것으로 간주한다. )
modify 플래그가 새로 DBM_ON이 된 경우에는 테이블의 modified count를 증가시킨다.

매개변수에서 사용되는 fieldData의 자료구조는 다음과 같다.

typedef struct {
  FieldId id;
  FieldDataType type;
  int len;
  /* 문자열 필드나 BLOB 필드의 경우에만 사용 */
  union {
     S16 int2val;
     int int4val;
     S8* str;
  }content;
} FieldData;

Example
  /* Get scanId and recId. See the example of DBMDeleteFieldContent */
  FieldData fieldData[NUM_FIELDS];
  int numFieldData;

  numFieldData = 2;
  fieldData[0].id = 0;
  fieldData[0].type = INT2;
  fieldData[0].len = 2;
  fieldData[0].content.int2val = 10;
  fieldData[1].id = 2;
  fieldData[1].type = STRING;
  fieldData[1].len = 5;
  strcpy(filedData[1].content.str, "name");

  ret = DBMSetFieldContent(scanId, recId, numFields, fieldData);
  if (ret < DBM_OK) // error handling