Loading...
Searching...
No Matches
KeyValue store management
Functions » KeyValue store

## Functions

NATS_EXTERN natsStatus | kvConfig_Init (kvConfig *cfg)
| Initializes a KeyValue configuration structure.
NATS_EXTERN natsStatus | js_CreateKeyValue (kvStore **new_kv, jsCtx *js, kvConfig *cfg)
| Creates a KeyValue store with a given configuration.
NATS_EXTERN natsStatus | js_KeyValue (kvStore **new_kv, jsCtx *js, const char *bucket)
| Looks-up and binds to an existing KeyValue store.
NATS_EXTERN natsStatus | js_DeleteKeyValue (jsCtx *js, const char *bucket)
| Deletes a KeyValue store.
NATS_EXTERN void | kvStore_Destroy (kvStore *kv)
| Destroys a KeyValue store object.

## Detailed Description

These functions allow to create, get or delete a KeyValue store.

Warning
  EXPERIMENTAL FEATURE! We reserve the right to change the API without necessarily bumping the major version of the library.

## Function Documentation

## kvConfig_Init()

NATS_EXTERN natsStatus kvConfig_Init | ( | kvConfig * | cfg | ) |

Use this before setting specific kvConfig options and passing it to js_CreateKeyValue.

See also
  js_CreateKeyValue

Parameters

  cfg | the pointer to the stack variable kvConfig to initialize.

## js_CreateKeyValue()

NATS_EXTERN natsStatus js_CreateKeyValue | ( | kvStore ** | new_kv,
|  | jsCtx * | js,
|  | kvConfig * | cfg
| ) |  |

Creates a KeyValue store with a given configuration.

Bucket names are restricted to this set of characters: `A-Z`, `a-z`, `0-9`, `_` and `-`.

Note
  The return kvStore object needs to be destroyed using kvStore_Destroy when no longer needed to free allocated memory. This is different from deleting a KeyValue store from the server using the js_DeleteKeyValue API.

Parameters

  new_kv | the location where to store the newly created kvStore object.
  js | the pointer to the jsCtx object.
  cfg | the pointer to the kvConfig configuration information used to create the kvStore object.

## js_KeyValue()

NATS_EXTERN natsStatus js_KeyValue | ( | kvStore ** | new_kv,
|  | jsCtx * | js,
|  | const char * | bucket
| ) |  |

This call is when the user wants to use an existing KeyValue store. If the store does not already exists, an error is returned.

Bucket names are restricted to this set of characters: `A-Z`, `a-z`, `0-9`, `_` and `-`.

Note
  The return kvStore object needs to be destroyed using kvStore_Destroy when no longer needed to free allocated memory. This is different from deleting a KeyValue store from the server using the js_DeleteKeyValue API.

Parameters

  new_kv | the location where to store the newly created kvStore object.
  js | the pointer to the jsCtx object.
  bucket | the name of the bucket of the existing KeyValue store.

## js_DeleteKeyValue()

NATS_EXTERN natsStatus js_DeleteKeyValue | ( | jsCtx * | js,
|  | const char * | bucket
| ) |  |

This will delete the KeyValue store with the `bucket` name.

Bucket names are restricted to this set of characters: `A-Z`, `a-z`, `0-9`, `_` and `-`.

Parameters

  js | the pointer to the jsCtx object.
  bucket | the name of the bucket of the existing KeyValue store.

## kvStore_Destroy()

NATS_EXTERN void kvStore_Destroy | ( | kvStore * | kv | ) |

This will simply free memory resources in the library for this kvStore, but does not delete the KeyValue store in the server.

Parameters

  kv | the pointer to the kvStore object.