map-cache

Basic cache object for storing key-value pairs.

# Install

Install with npm:

$ npm install map-cache --save

Based on MapCache in Lo-dash v3.0. MIT License

# Usage

var MapCache = require('map-cache');
var mapCache = new MapCache();

# API

## <a href="index.js#L28">MapCache</a>

Creates a cache object to store key/value pairs.

Example

var cache = new MapCache();

## <a href="index.js#L45">.set</a>

Adds `value` to `key` on the cache.

Params

- `key` **{String}**: The key of the value to cache.
- `value` **{any}**: The value to cache.
- `returns` **{Object}**: Returns the `Cache` object for chaining.

Example

cache.set('foo', 'bar');

## <a href="index.js#L65">.get</a>

Gets the cached value for `key`.

Params

- `key` **{String}**: The key of the value to get.
- `returns` **{any}**: Returns the cached value.

Example

cache.get('foo');
//=> 'bar'

## <a href="index.js#L82">.has</a>

Checks if a cached value for `key` exists.

Params

- `key` **{String}**: The key of the entry to check.
- `returns` **{Boolean}**: Returns `true` if an entry for `key` exists, else `false`.

Example

cache.has('foo');
//=> true

## <a href="index.js#L98">.del</a>

Removes `key` and its value from the cache.

Params

- `key` **{String}**: The key of the value to remove.
- `returns` **{Boolean}**: Returns `true` if the entry was removed successfully, else `false`.

Example

cache.del('foo');

# Related projects

You might also be interested in these projects:

- cache-base: Basic object cache with `get`, `set`, `del`, and `has` methods for node.js/javascript projects. | homepage
- config-cache: General purpose JavaScript object storage methods. | homepage
- option-cache: Simple API for managing options in JavaScript applications. | homepage

# Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

# Building docs

Generate readme and API documentation with verb:

$ npm install verb && npm run docs

Or, if verb is installed globally:

$ verb

# Running tests

Install dev dependencies:

$ npm install -d && npm test

# Author

Jon Schlinkert

- github/jonschlinkert
- twitter/jonschlinkert

# License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

This file was generated by verb, v0.9.0, on May 10, 2016.