add(key, value, expiry = 0, raw = false) — MemCache

add(key, value, expiry = 0, raw = false)

Add key to the cache with value value that expires in expiry seconds, but only if key does not already exist in the cache. If raw is true, value will not be Marshalled.

Readers should call this method in the event of a cache miss, not MemCache#set or MemCache#[]=.

Parameters

key req
value req
expiry opt = 0
raw opt = false

Source

# File activesupport/lib/active_support/vendor/memcache-client-1.5.1/memcache.rb, line 352
  def add(key, value, expiry = 0, raw = false)
    raise MemCacheError, "Update of readonly cache" if @readonly
    server, cache_key = request_setup key
    socket = server.socket

    value = Marshal.dump value unless raw
    command = "add #{cache_key} 0 #{expiry} #{value.size}\r\n#{value}\r\n"

    begin
      @mutex.lock if @multithread
      socket.write command
      result = socket.gets
      raise_on_error_response! result
      result
    rescue SocketError, SystemCallError, IOError => err
      server.close
      raise MemCacheError, err.message
    ensure
      @mutex.unlock if @multithread
    end
  end

Defined in activesupport/lib/active_support/vendor/memcache-client-1.5.1/memcache.rb line 352 · View on GitHub · Improve this page · Find usages on GitHub

Defined in MemCache

Signature

Parameters