xmake-docs/docs/api/scripts/extension-modules/core/cache/globalcache.md

core.cache.globalcache

This module provides global file-based cache functionality for persistent data storage across different build sessions.

::: tip TIP To use this module, you need to import it first: import("core.cache.globalcache") :::

globalcache.set

• Set a cache value with single key

Function Prototype

::: tip API

globalcache.set(cachename: <string>, key: <string>, value: <any>)

:::

Parameter Description

Parameter	Description
cachename	Required. Cache name string
key	Required. Cache key string
value	Required. Cache value (can be any Lua value)

Return Value

No return value

Usage

import("core.cache.globalcache")

-- Store a value with single key
globalcache.set("mycache", "key1", {1, 2, 3})

globalcache.get

• Get a cache value with single key

Function Prototype

::: tip API

globalcache.get(cachename: <string>, key: <string>)

:::

Parameter Description

Parameter	Description
cachename	Required. Cache name string
key	Required. Cache key string

Return Value

Type	Description
any	Returns the cached value if found, nil otherwise

Usage

import("core.cache.globalcache")

-- Get a value with single key
local value = globalcache.get("mycache", "key1")

globalcache.set2

• Set a cache value with two-level keys

Function Prototype

::: tip API

globalcache.set2(cachename: <string>, key1: <string>, key2: <string>, value: <any>)

:::

Parameter Description

Parameter	Description
cachename	Required. Cache name string
key1	Required. First-level cache key string
key2	Required. Second-level cache key string
value	Required. Cache value (can be any Lua value)

Return Value

No return value

Usage

import("core.cache.globalcache")

-- Store a value with two-level keys
globalcache.set2("mycache", "user", "name", "tboox")

globalcache.get2

• Get a cache value with two-level keys

Function Prototype

::: tip API

globalcache.get2(cachename: <string>, key1: <string>, key2: <string>)

:::

Parameter Description

Parameter	Description
cachename	Required. Cache name string
key1	Required. First-level cache key string
key2	Required. Second-level cache key string

Return Value

Type	Description
any	Returns the cached value if found, nil otherwise

Usage

import("core.cache.globalcache")

-- Get a value with two-level keys
local name = globalcache.get2("mycache", "user", "name")

globalcache.clear

• Clear cache entries

Function Prototype

::: tip API

globalcache.clear(cachename?: <string>)

:::

Parameter Description

Parameter	Description
cachename	Optional. Cache name string. If omitted, clears all caches

Return Value

No return value

Usage

import("core.cache.globalcache")

-- Clear a specific cache
globalcache.clear("mycache")

-- Clear all caches
globalcache.clear()