AerospikeC客戶端手冊———錯誤處理



錯誤處理

每個數據庫操作均接受一個as_error對象做為參數。當在操作期間發生錯誤，參數as_error會被填入狀態碼和錯誤信息。通常，參數as_error是數據庫操作的第二個參數。
as_error提供的信息包括：
code — 操作的狀態，類型是as_status。
message — 錯誤碼相應的信息。若操作成功完成，此信息可能為空(NULL)。
func — 錯誤發生的函數名。若未能正確捕獲，可能為空(NULL)。
file — 錯誤發生的文件名。若未能正確捕獲，可能為空(NULL)。
line — 錯誤發生的文件行號。若未能正確捕獲，可能為0。

當操作完成，返回一個as_status類型的值，此值對應於as_error.code。若操作返回失敗狀態，一般是非AEROSPIKE_OK， 應用應檢查as_error變量以取得更多信息。請參見as_status.h獲取完成列表。

一個as_error變量可重用於多個操作，每個操作會重置as_error並在出錯時設值。

下面是一個錯誤處理的簡單示例:

if (aerospike_key_put(&as, &err, NULL, &key, &rec) != AEROSPIKE_OK) {
    fprintf(stderr, "err(%d) %s at [%s:%d]\n", err.code, err.message, err.file, err.line);
}