Skip to content

Latest commit

 

History

History
74 lines (42 loc) · 2.28 KB

ngxshareddictget.md

File metadata and controls

74 lines (42 loc) · 2.28 KB

ngx.shared.DICT.get

语法: value, flags = ngx.shared.DICT:get(key)

环境: 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.*

ngx.shared.DICT 字典中获取名为 key 的键 (key) 值。如果此 key 不存在或已过期,返回 nil

当发生错误时,将返回 nil 和一个描述错误的字符串。

返回值将保持写入字典时的原始数据类型,例如,Lua 布尔型、数字型、或字符串型。

此方法的第一个参数必须是该字典对象本身,例如,

 local cats = ngx.shared.cats
 local value, flags = cats.get(cats, "Marry")

或使用 Lua 的“语法糖”形式来调用方法:

 local cats = ngx.shared.cats
 local value, flags = cats:get("Marry")

这两种形式完全等价。

如果用户标志 (flags) 是 0 (默认值),将不会返回 flags 值。

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

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

English Source

syntax: value, flags = ngx.shared.DICT:get(key)

context: 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.*

Retrieving the value in the dictionary ngx.shared.DICT for the key key. If the key does not exist or has been expired, then nil will be returned.

In case of errors, nil and a string describing the error will be returned.

The value returned will have the original data type when they were inserted into the dictionary, for example, Lua booleans, numbers, or strings.

The first argument to this method must be the dictionary object itself, for example,

 local cats = ngx.shared.cats
 local value, flags = cats.get(cats, "Marry")

or use Lua's syntactic sugar for method calls:

 local cats = ngx.shared.cats
 local value, flags = cats:get("Marry")

These two forms are fundamentally equivalent.

If the user flags is 0 (the default), then no flags value will be returned.

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

See also ngx.shared.DICT.

返回目录