Added atomic type opperations to shmdict

  - Added cas(compare and swap) to shdict
  - Added cog(compare or get) to shdict

Author: Miniwoffer

README.markdown

@@ -3560,10 +3560,12 @@ Nginx API for Lua
 * [ngx.shared.DICT](#ngxshareddict)
 * [ngx.shared.DICT.get](#ngxshareddictget)
 * [ngx.shared.DICT.get_stale](#ngxshareddictget_stale)
+* [ngx.shared.DICT.cog](#ngxshareddictcog)
 * [ngx.shared.DICT.set](#ngxshareddictset)
 * [ngx.shared.DICT.safe_set](#ngxshareddictsafe_set)
 * [ngx.shared.DICT.add](#ngxshareddictadd)
 * [ngx.shared.DICT.safe_add](#ngxshareddictsafe_add)
+* [ngx.shared.DICT.cas](#ngxshareddictcas)
 * [ngx.shared.DICT.replace](#ngxshareddictreplace)
 * [ngx.shared.DICT.delete](#ngxshareddictdelete)
 * [ngx.shared.DICT.incr](#ngxshareddictincr)
@@ -6756,10 +6758,12 @@ The resulting object `dict` has the following methods:
 
 * [get](#ngxshareddictget)
 * [get_stale](#ngxshareddictget_stale)
+* [cog](#ngxshareddictcog)
 * [set](#ngxshareddictset)
 * [safe_set](#ngxshareddictsafe_set)
 * [add](#ngxshareddictadd)
 * [safe_add](#ngxshareddictsafe_add)
+* [cas](#ngxshareddictcas)
 * [replace](#ngxshareddictreplace)
 * [delete](#ngxshareddictdelete)
 * [incr](#ngxshareddictincr)
@@ -6884,6 +6888,26 @@ See also [ngx.shared.DICT](#ngxshareddict).
 
 [Back to TOC](#nginx-api-for-lua)
 
+ngx.shared.DICT.cog
+-------------------
+**syntax:** *value, flags = ngx.shared.DICT:cog(key, old_value?, old_flags?)*
+
+**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.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*, ssl_client_hello_by_lua**
+
+Similar to the [get](#ngxshareddictget) method, but only returns if
+`old_value` or `old_flags` do not match.
+
+If `old_value` or `old_flags` is `nil`
+it will be ignored when comparing.
+
+In case of match, `nil, false` will be returned.
+
+This method was first introduced in the `0.XX.X` release.
+
+See also [ngx.shared.DICT](#ngxshareddict).
+
+[Back to TOC](#nginx-api-for-lua)
+
 ngx.shared.DICT.set
 -------------------
 
@@ -6984,6 +7008,28 @@ See also [ngx.shared.DICT](#ngxshareddict).
 
 [Back to TOC](#nginx-api-for-lua)
 
+ngx.shared.DICT.cas
+-------------------
+**syntax:** *success, err, forcible = ngx.shared.DICT:cas(key, old_value?, old_flags?, value?, flags?, exptime?)*
+
+**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.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*, ssl_client_hello_by_lua**
+
+Conditionally sets key-value pair in shm.
+
+If `old_value` or `old_flags` is `nil` it will
+be ignored.
+
+If either `value` or `flags` is `nil` it will
+remain unchanged. If both are `nil`, key-value pair will be deleted.
+
+In case of mismatch, `false, false` will be returned.
+
+This method was first introduced in the `0.XX.X` release.
+
+See also [ngx.shared.DICT](#ngxshareddict).
+
+[Back to TOC](#nginx-api-for-lua)
+
 ngx.shared.DICT.replace
 -----------------------
 

doc/HttpLuaModule.wiki

@@ -5712,10 +5712,12 @@ The resulting object <code>dict</code> has the following methods:
 
 * [[#ngx.shared.DICT.get|get]]
 * [[#ngx.shared.DICT.get_stale|get_stale]]
+* [[#ngx.shared.DICT.cog|cog]]
 * [[#ngx.shared.DICT.set|set]]
 * [[#ngx.shared.DICT.safe_set|safe_set]]
 * [[#ngx.shared.DICT.add|add]]
 * [[#ngx.shared.DICT.safe_add|safe_add]]
+* [[#ngx.shared.DICT.cas|cas]]
 * [[#ngx.shared.DICT.replace|replace]]
 * [[#ngx.shared.DICT.delete|delete]]
 * [[#ngx.shared.DICT.incr|incr]]
@@ -5828,6 +5830,23 @@ This method was first introduced in the <code>0.8.6</code> release.
 
 See also [[#ngx.shared.DICT|ngx.shared.DICT]].
 
+== ngx.shared.DICT.cog ==
+'''syntax:''' ''value, flags = ngx.shared.DICT:cog(key, old_value?, old_flags?)''
+
+'''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.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*, ssl_client_hello_by_lua*''
+
+Similar to the [[#ngx.shared.DICT.get|get]] method, but only returns if
+<code>old_value</code> or <code>old_flags</code> do not match.
+
+If <code>old_value</code> or <code>old_flags</code> is <code>nil</code>
+it will be ignored when comparing.
+
+In case of match, <code>nil, false</code> will be returned.
+
+This method was first introduced in the <code>0.XX.X</code> release.
+
+See also [[#ngx.shared.DICT|ngx.shared.DICT]].
+
 == ngx.shared.DICT.set ==
 
 '''syntax:''' ''success, err, forcible = ngx.shared.DICT:set(key, value, exptime?, flags?)''
@@ -5914,6 +5933,25 @@ This feature was first introduced in the <code>v0.7.18</code> release.
 
 See also [[#ngx.shared.DICT|ngx.shared.DICT]].
 
+== ngx.shared.DICT.cas ==
+'''syntax:''' ''success, err, forcible = ngx.shared.DICT:cas(key, old_value?, old_flags?, value?, flags?, exptime?)''
+
+'''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.*, balancer_by_lua*, ssl_certificate_by_lua*, ssl_session_fetch_by_lua*, ssl_session_store_by_lua*, ssl_client_hello_by_lua*''
+
+Conditionally sets key-value pair in shm.
+
+If <code>old_value</code> or <code>old_flags</code> is <code>nil</code> it will
+be ignored.
+
+If either <code>value</code> or <code>flags</code> is <code>nil</code> it will
+remain unchanged. If both are <code>nil</code>, key-value pair will be deleted.
+
+In case of mismatch, <code>false, false</code> will be returned.
+
+This method was first introduced in the <code>0.XX.X</code> release.
+
+See also [[#ngx.shared.DICT|ngx.shared.DICT]].
+
 == ngx.shared.DICT.replace ==
 
 '''syntax:''' ''success, err, forcible = ngx.shared.DICT:replace(key, value, exptime?, flags?)''