This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English version of the page.

Note: This page has been translated by MathWorks. Click here to see
To view all translated materials including this page, select Country from the country navigator on the bottom of this page.


Number of key-value pairs in the data cache


num = length(c)
num = length(c,location)



num = length(c) returns the total number of key-value pairs in the data cache c.

num = length(c,location) returns the numbers of key-value pairs in the data cache c stored remotely or locally as specified by location.


collapse all

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);
c = mps.cache.connect('myCache', 'Connection', 'myRedisConnection');

Retain a few keys locally.

retain(c, {'keyOne','keyTwo'})

Add keys and values to the cache.

put(c,'keyOne',10,'keyTwo',20,'keyThree',30,'keyFour',[400 500],'keyFive',magic(5))

Count the number of keys-value pairs.

numTotal = length(c)
numRemote = length(c,'Remote')
numLocal = length(c,'Local')
numTotal =



numRemote =



numLocal =



Since keyOne and keyTwo were retained before being written to the cache, they were never written to the persistence service. They are stored locally until flushed or purged to the persistence service.

Input Arguments

collapse all

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

Location of keys specified as an enumerated member of the class mps.cache.Location. The valid location options are either 'Remote' or 'Local'.

Example: 'Remote'

Output Arguments

collapse all

Total number of key-value pairs in the data cache or the number stored remotely or locally, returned as an integer.

Introduced in R2018b