kv_create_put_op()

#include <kvstore.h>

kv_error_t 
kv_create_put_op(kv_operations_t *list,
                 const kv_key_t *key,
                 const kv_value_t *value,
                 kv_int_t abort_on_failure) 

Creates a simple put operation suitable for use as part of a multi-step operation to be run using kv_execute(). The semantics of the returned operation when executed are identical to that of kv_put().

Parameters

  • list

    The list parameter operation sequence to which this put operation is appended. The sequence is allocated using kv_create_operations().

  • key

    The key parameter is the Key portion of the Key/Value pair that you want to write to the store.

    Note that all of the operations performed under a single call to kv_execute() must share the same major key path, and that major key path must be complete.

  • value

    The value parameter is the Value portion of the Key/Value pair that you want to write to the store.

  • abort_on_failure

    The abort_on_failure parameter indicates whether the entire operation should abort if this put operation fails. Specify 1 if you want the operation to abort upon put failure.