# groonga - An open-source fulltext search engine and column store.

- 日本語

# 7.25.4. `grn_cache`

## 7.25.4.1. Summary

Note

This API is experimental.

`grn_cache` is a data store that keeps responses of select command. It is not general use cache object. It is only for select command.

You can just change the current cache object by `grn_cache_current_set()`. select command response cache is done internally.

select command uses one global cache object. If you open multiple databases, the one cache is shared. It is an important problem.

If you open multiple databases and use select command, you need to use `grn_cache` object. It is groonga-httpd case. If you open only one database or don’t use select command, you don’t need to use `grn_cache` object. It is rroonga case.

## 7.25.4.2. Example

Here is an example that change the current cache object.

    grn_cache *cache;
    grn_cache *cache_previous;
    cache = grn_cache_open(ctx);
    cache_previous = grn_cache_current_get(ctx);
    grn_cache_current_set(ctx, cache);
    /* grn_ctx_send(ctx, ...); */
    grn_cache_current_set(ctx, cache_previous);

## 7.25.4.3. Reference

type `grn_cache`

  It is an opaque cache object. You can create a `grn_cache` by `grn_cache_open()` and free the created object by `grn_cache_close()`.

grn_cache *`grn_cache_open`(grn_ctx *ctx)

  Creates a new cache object.

  If memory allocation for the new cache object is failed, `NULL` is returned. Error information is stored into the `ctx`.

  Parameters

    - ctx – The context.

  Returns

    A newly allocated cache object on success, `NULL` otherwise. The returned cache object must be freed by `grn_cache_close()`.

grn_rc `grn_cache_close`(grn_ctx *ctx, grn_cache *cache)

  Frees resourses of the `cache`.

  Parameters

    - ctx – The context.

    - cache – The cache object to be freed.

  Returns

    `GRN_SUCCESS` on success, not `GRN_SUCCESS` otherwise.

grn_rc `grn_cache_current_set`(grn_ctx *ctx, grn_cache *cache)

  Sets the cache object that is used in select command.

  Parameters

    - ctx – The context.

    - cache – The cache object that is used in select command.

  Returns

    `GRN_SUCCESS` on success, not `GRN_SUCCESS` otherwise.

grn_cache *`grn_cache_current_get`(grn_ctx *ctx)

  Gets the cache object that is used in select command.

  Parameters

    - ctx – The context.

  Returns

    The cache object that is used in select command. It may be `NULL`.

grn_rc `grn_cache_set_max_n_entries`(grn_ctx *ctx, grn_cache *cache, unsigned int n)

  Sets the max number of entries of the cache object.

  Parameters

    - ctx – The context.

    - cache – The cache object to be changed.

    - n – The new max number of entries of the cache object.

  Returns

    `GRN_SUCCESS` on success, not `GRN_SUCCESS` otherwise.

unsigned int `grn_cache_get_max_n_entries`(grn_ctx *ctx, grn_cache *cache)

  Gets the max number of entries of the cache object.

  Parameters

    - ctx – The context.

    - cache – The target cache object.

  Returns

    The max number of entries of the cache object.