PStore#fetch

fetch(key, default=PStore::Error)

# File tmp/rubies/ruby-3.3.0/lib/pstore.rb, line 436
def fetch(key, default=PStore::Error)
  in_transaction
  unless @table.key? key
    if default == PStore::Error
      raise PStore::Error, format("undefined key `%s'", key)
    else
      return default
    end
  end
  @table[key]
end

Like [], except that it accepts a default value for the store. If the key does not exist:

Raises an exception if default is PStore::Error.

Returns the value of default otherwise:

Example

example_store do |store|
  store.transaction do
    store.fetch(:nope, nil) # => nil
    store.fetch(:nope)      # Raises an exception.
  end
end

Raises an exception if called outside a transaction block.

See also #empty_marshal_data #in_transaction #empty_marshal_checksum #in_transaction_wr also in 3.4 · 3.2 · 3.1 · 3.0

‹ prev#empty_marshal_data next ›#in_transaction