Skip to content

Latest commit

 

History

History
29 lines (16 loc) · 1.49 KB

ngxshareddictreplace.md

File metadata and controls

29 lines (16 loc) · 1.49 KB

ngx.shared.DICT.replace

语法: success, err, forcible = ngx.shared.DICT:replace(key, value, exptime?, flags?)

环境: init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*

set 方法类似,但仅当存储字典 ngx.shared.DICT存在 该 key 时执行存储 key-value 对。

如果参数 key 在字典中 存在 (或已经过期),success 返回值为 false,同时 err 返回 "not found" (没找到)。

这个功能最早出现在 v0.3.1rc22 版本中。

更多功能请参考 ngx.shared.DICT

English Source

syntax: success, err, forcible = ngx.shared.DICT:replace(key, value, exptime?, flags?)

context: init_by_lua*, set_by_lua*, rewrite_by_lua*, access_by_lua*, content_by_lua*, header_filter_by_lua*, body_filter_by_lua*, log_by_lua*, ngx.timer.*

Just like the set method, but only stores the key-value pair into the dictionary ngx.shared.DICT if the key does exist.

If the key argument does not exist in the dictionary (or expired already), the success return value will be false and the err return value will be "not found".

This feature was first introduced in the v0.3.1rc22 release.

See also ngx.shared.DICT.

返回目录