4 Key/Value Pair Management Functions

This chapter describes the functions used to manage keys and values. Both are used to describe a single entry (or record) in the KV Store. In addition, this chapter describes functions used to manage versions; that is, data structures that identify the key-value pair's specific version.

Key Functions

Key Functions	Description
kv_create_key()	Allocate and initialize a key structure using major and minor path components
kv_create_key_copy()	Allocate and initialize a key structure using major and minor path components
kv_create_key_from_uri()	Allocate and initialize a key structure using a URI string
kv_create_key_from_uri_copy()	Allocate and initialize a key structure using a URI string
kv_get_key_major()	Return the major path components for the key
kv_get_key_minor()	Return the minor path components for the key
kv_get_key_uri()	Return the key's major and minor path components as a URI
kv_release_key()	Release the key structure, freeing all associated memory

Value Functions

Value Functions	Description
kv_create_value()	Allocate and initialize a value structure
kv_create_value_copy()	Allocate and initialize a value structure
kv_get_value()	Returns the value as a string
kv_get_value_size()	Returns the value's size
kv_release_value()	Release a value structure

Version Functions

Version Functions	Description
kv_copy_version()	Copies a version structure
kv_get_version()	Returns a value's version
kv_release_version()	Release a version structure