lv_cache_acquire() function

Acquire a cache entry with the given key. If entry not in cache, it will return `NULL` (not found). If the entry is found, it's priority will be changed by the cache's policy. And the `lv_cache_entry_t::ref_cnt` will be incremented.

Syntax

Show:

Summary

Declaration

Definition

from lv_cache.h:67

lv_cache_entry_t * lv_cache_acquire(lv_cache_t * cache, const void * key, void * user_data);

Implemented in lv_cache.c:79

Arguments

Argument

Description

cache

The cache object pointer to acquire the entry.

key

The key of the entry to acquire.

user_data

A user data pointer that will be passed to the create callback.

Return value

Returns a pointer to the acquired cache entry on success with `lv_cache_entry_t::ref_cnt` incremented, `NULL` on error.

Examples

References

from examples

lv_cache_acquire() function

Syntax

Arguments

Return value

Examples

References

Call Tree

Data Use

Class Tree

Override Tree

Implementations

Instances

Lifecycle