4.3.31 ctdbClearRecord

---

Clear the record buffer.

Declaration

CTDBRET ctdbClearRecord(CTHANDLE Handle)

Description

ctdbClearRecord clears the record buffer. Before clearing a record, the record should be active. After a call to ctdbClearRecord, functions that depend on the current record will return an error (CTDBRET_NOTACTIVE). It is very important to clear the record buffer BEFORE adding a new record to a table. If the user tries to add a new record, and the buffer is not cleared, the new record will replace (rewrite) the active record, or return an error ICUR_ERR (100), in the event the record handle has been instantiated, but not cleared.

Handle [in] the record handle.

Returns

ctdbClearRecord returns CTDBRET_OK on success, or c-treeDB C API error code on failure.

See also

ctdbAllocRecord, ctdbResetRecord