clear

Remove all keys and values from cache

Syntax

n = clear(c)

Description

n = clear(c) removes all keys and values from cache and returns the number of keys cleared from the cache in n.

clear removes both local and remote keys and values.

Examples

Clear All Keys and Values from Cache

Start a persistence service that uses Redis™ as the persistence provider. The service requires a connection name and an open port. Once the service is running, you can connect to the service using the connection name and create a cache.

ctrl = mps.cache.control('myRedisConnection','Redis','Port',4519);
start(ctrl)
c = mps.cache.connect('myCache', 'Connection', 'myRedisConnection');

Add keys and values to the cache and display them as a MATLAB^® table.

put(c,'keyOne',10,'keyTwo',20,'keyThree',30,'keyFour',[400 500],'keyFive',magic(5))
tt = table(keys(c), get(c,keys(c))','VariableNames',{'Keys','Values'})

tt =

  5×2 table

       Keys          Values   
    __________    ____________

    'keyFive'     [5×5 double]
    'keyFour'     [1×2 double]
    'keyOne'      [        10]
    'keyThree'    [        30]
    'keyTwo'      [        20]

Clear the cache and check if it is empty.

n = clear(c)
k = keys(c)

n =

  int64

   5


k =

  0×1 empty cell array

Input Arguments

c — Data cache

persistence provider specific data cache object

A data cache represented by a persistence provider specific data cache object.

Currently, Redis and MATLAB are the only supported persistence providers. Therefore, the cache objects will be of type mps.cache.RedisCache or mps.cache.MATFileCache.

Example: c

Output Arguments

n — Number of key-value pairs

integer

Number of key-value pairs removed, returned as an integer.

Example: 5

Version History

Introduced in R2018b