# 系统相关函数 - 全局缓存函数

文档类型：函数事实页
是否可直接用于生成代码：是；本页函数条目均包含参数表
遇到不确定时：回到 [../system.md](../system.md)、[../../index.md](../../index.md)

## 全局缓存函数

### `setGlobalCache(name, value)`

用途：写入全局缓存。

参数个数：2
返回值：成功标记；成功时返回 `1`

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明         |
| -------- | ------- | ---- | -------- | ------------ |
| 1        | `name`  | 是   | 字符串   | 缓存键       |
| 2        | `value` | 是   | 任意值   | 写入缓存的值 |

### `getGlobalCache(name, out_value)`

用途：按键读取全局缓存。

参数个数：2
返回值：成功标记；成功时返回 `1`

| 参数位置 | 参数名      | 必填 | 接收类型 | 说明                 |
| -------- | ----------- | ---- | -------- | -------------------- |
| 1        | `name`      | 是   | 字符串   | 缓存键               |
| 2        | `out_value` | 是   | 变量     | 输出变量，接收缓存值 |

### `ifCache(value)`

用途：判断值是否仍是全局缓存引用。

参数个数：1
返回值：布尔值

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明       |
| -------- | ------- | ---- | -------- | ---------- |
| 1        | `value` | 是   | 任意值   | 待判断的值 |

### `checkGlobalCacheExpired(value)`

用途：判断全局缓存引用是否已经过期。

参数个数：1
返回值：布尔值；未过期返回 `0`，过期返回 `1`

| 参数位置 | 参数名  | 必填 | 接收类型 | 说明                                 |
| -------- | ------- | ---- | -------- | ------------------------------------ |
| 1        | `value` | 是   | 缓存引用 | `getGlobalCache(...)` 取出的缓存引用 |
