ctyun.dict.DICT.set

函数信息详见下表：

项目	描述
语法	success, err, forcible = DICT:set(key_name, value, ttl?, flags?)
作用	在全局字典ctyun.dict.DICT 中设置一个键值对。 其中value可以是Lua布尔值、数字、字符串，或nil类型的，不可以是table类型的。
入参	key_name：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。
返回值	success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local succ, err, forcible = cats:set("Marry", "it is a nice cat!")

ctyun.dict.DICT.safe_set

函数信息详见下表：

项目	描述
语法	success, err, forcible = DICT:safe_set(key_name, value, ttl?, flags?)
作用	与set类似，但在内存不足的情况下，它不会覆盖已经存在且没有过期的数据，而会报“no memory”错误并返回nil。
入参	key_name：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。
返回值	success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local succ, err, forcible = cats:safe_set("Marry", "it is a nice cat!")

ctyun.dict.DICT.get

函数信息详见下表：

项目	描述
语法	value, flags = DICT:get(key_name)
作用	在全局字典ctyun.dict.DICT中设置一个键值对。获取指定key对应的value，value的数据类型与存储时的原始数据类型一致，但如果key不存在或过期就返回nil。
入参	key_name：要获取内容的键值。
返回值	value: key对应的value。 flags: 用来获取是否对用户做了标识，一般在set时都会加入标识，如果没有，则默认为0。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local value, _ = cats:get("Marry")

ctyun.dict.DICT.get_stale

函数信息详见下表：

项目	描述
语法	value, flags, stale = DICT:get_stale(key_name)
作用	与get类似，但返回的是过期的值，过期的值无法保证一直存在，如当内存不够时会被自动清理。
入参	key_name：要获取内容的键值。
返回值	value: key对应的value。 flags: 用来获取是否对用户做了标识，一般在set时都会加入标识，如果没有，则默认为0。 stale: 代表获取的value是否已经过期，如果是，则返回true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local value, _ = cats:get_stale("Marry")

ctyun.dict.DICT.add

函数信息详见下表：

项目	描述
语法	success, err, forcible = DICT:add(key_name, value, ttl?, flags?)
作用	与set类似，但如果key在缓存里存在且没有过期就不会执行add指令，此时err会返回“exist”；如果key不存在或已过期，则会执行add指令并把key/value的值存入共享内存中。
入参	key_name：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。
返回值	success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local succ, err, forcible = cats:add("Marry", "it is a nice cat!")

ctyun.dict.DICT.safe_add

函数信息详见下表：

项目	描述
语法	success, err, forcible = DICT:safe_add(key_name, value, ttl?, flags?)
作用	与set类似，但在内存不足的情况下，它不会覆盖已经存在且没有过期的数据，而会报“no memory”错误并返回nil。
入参	key_name：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。
返回值	success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local succ, err, forcible = cats:safe_add("Marry", "it is a nice cat!")

ctyun.dict.DICT.replace

函数信息详见下表：

项目	描述
语法	success, err, forcible = DICT:replace(key_name, value, ttl?, flags?)
作用	和set类似，但只有当key存在时，才会把key/value的值存入共享内存中（key过期属于不存在的情况）。
入参	key_name：设置内容的键。 value：设置内容的值。 ttl：设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。 flags: 用来做用户标识，可以标识set操作的执行者，默认是0。只能设置number类型; 为可选参数。
返回值	success：布尔值，用来表示是否成功set。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local succ, err, forcible = cats:replace("Marry", "it is a nice cat!")

ctyun.dict.DICT.delete

函数信息详见下表：

项目	描述
语法	DICT:delete(key_name)
作用	删除指定的key。
入参	key_name：设置内容的键。
返回值	无。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
cats:delete("Marry")

ctyun.dict.DICT.incr

函数信息详见下表：

项目	描述
语法	newval, err, forcible = DICT:incr(key_name, value, init?, ttl?)
作用	让指定key的值递增，步长是value。适合用来在请求时做计数操作。newval是数字累加后的值。如果key不存在，并且init参数为空，则请求会返回“not found”并赋值给err；如果key不存在，并且init是number类型，那么会创建1个init+value的新key。 **注意：**这里的key、value、init，在正常情况下都应该是number类型。
入参	key_name：设置内容的键。 value：设置内容的值。 init：设置初始计数值。 ttl: 设置key/value的有效期（单位是秒），为可选参数，默认是不过期的。如果为0（默认）则表示永远不失效。
返回值	newval：数字累加后的值。 err：如果success的值是false，就会将错误信息存放在err中。 forcible：布尔值，用来表示是否有数据被强制删除。在存储数据的过程中，如果内存空间不够就会使用LRU算法清除数据，此时，forcible为true。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local newval, err, forcible = cats:incr("count", 1, 0, 3)
-- newval got 1
ctyun.sleep(3)
local val, err = cats:get("count")
-- val got nil

ctyun.dict.DICT.lpush

函数信息详见下表：

项目	描述
语法	length, err = DICT:lpush(key_name, value)
作用	消息队列操作：将string或number从头部插入key的列表中，并返回列表元素的个数。若key不存在则先创建key，存在但不是列表返回nil且err为“value not a list”。
入参	key_name：设置内容的键。 value：设置内容的值。
返回值	length：返回列表元素的个数。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local length, err = cats:lpush("Marry", 1)

ctyun.dict.DICT.rpush

函数信息详见下表：

项目	描述
语法	length, err = DICT:rpush(key_name, value)
作用	消息队列操作：与lpush类似，只是元素会从尾部插入。
入参	key_name：设置内容的键。 value：设置内容的值。
返回值	length：返回列表元素的个数。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local length, err = cats:rpush("Marry", 1)

ctyun.dict.DICT.lpop

函数信息详见下表：

项目	描述
语法	value, err = DICT:lpop(key_name)
作用	消息队列操作：移除并返回key列表的第一个值；若key不存在则返回nil，key存在但不是列表则返回nil且err为“value not a list”。
入参	key_name：设置内容的键。
返回值	value：设置内容的值。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local value, err = cats:lpop("Marry")

ctyun.dict.DICT.rpop

函数信息详见下表：

项目	描述
语法	value, err = DICT:rpop(key_name)
作用	消息队列操作：与lpop类似，只是元素会从尾部弹出。
入参	key_name：设置内容的键。
返回值	value：设置内容的值。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local value, err = cats:rpop("Marry")

ctyun.dict.DICT.llen

函数信息详见下表：

项目	描述
语法	len, err = DICT:llen(key_name)
作用	消息队列操作：返回各项制度为key_name的列表的元素数量。若key不存在则返回0，若key存在但不是列表返回nil且err为“value not a list”。
入参	key_name：设置内容的键。
返回值	len：列表的元素数量。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local len, err = cats:llen("Marry")

ctyun.dict.DICT.ttl

函数信息详见下表：

项目	描述
语法	ttl, err = DICT:ttl(key_name)
作用	获取共享内存中的key的有效期。
入参	key_name：设置内容的键。
返回值	ttl：key的有效期。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local ttl, err = cats:ttl("Marry")

ctyun.dict.DICT.expire

函数信息详见下表：

项目	描述
语法	success, err = DICT:expire(key_name, exptime)
作用	修改共享内存中的key的有效期。
入参	key_name：设置内容的键。 exptime: 要更新的有效期时间值。
返回值	success：布尔类型，是否成功。 err：将错误信息存放在err中。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local ok, err = cats:expire("Marry", 60)

ctyun.dict.DICT.flush_all

函数信息详见下表：

项目	描述
语法	number = DICT:flush_all()
作用	清空共享内存中的所有数据，方法是让所有的数据都过期，这意味着虽然可以用get_stale的方式去读取数据，但不一定会有值存在。
入参	无。
返回值	无。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
cats:flush_all()

ctyun.dict.DICT.flush_expired

函数信息详见下表：

项目	描述
语法	number = DICT:flush_expired(max_count?)
作用	清空共享内存中所有过期的数据，方法是释放掉这些内存，彻底清除数据，并返回所清除数据的数量。
入参	max_count: 可选参数，如果不设置此参数或设为0，则会清除全部过期数据；如果参数值大于0，则会清除相应数量的数据。
返回值	number: 返回实际已刷新的项目数。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local number = cats:flush_expired()

ctyun.dict.DICT.get_keys

函数信息详见下表：

项目	描述
语法	keys = DICT:get_keys(max_count?)
作用	获取共享内存中的全部已保存的key列表，返回的是table类型的数据。
入参	max_count: 设置的是需要返回的数据的数量，默认是1024。如果设置为0，则表示返回全部数据。在实际运用中要尽量避免设置为0，因为如果数据量非常大，此操作会阻塞所有访问这个共享内存数据的worker进程。
返回值	keys : 返回key列表。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local keys = cats:get_keys()
for _, key_name in pairs(keys) do
    local value = cats:get(key_name)
end

ctyun.dict.DICT.free_space

函数信息详见下表：

项目	描述
语法	free_capacity_bytes = DICT:free_space()
作用	确认共享内存的剩余空间大小。
入参	无。
返回值	free_capacity_bytes: 剩余空间大小。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local free_capacity_bytes = cats:free_space()

ctyun.dict.DICT.capacity

函数信息详见下表：

项目	描述
语法	capacity_bytes = DICT:capacity()
作用	确认共享内存的容量大小。
入参	无。
返回值	capacity_bytes: 容量。

示例：

---假设全局字典名称为cats
local cats = ctyun.dict.cats
local capacity_bytes = cats:capacity()

                  

                    
注意
                    
示例中DICT为全局定义共享内存名称，需在控制台预先定义。