SDK
SDK Javascript v7.x
2

zrangebylex #

Returns elements within a provided interval, in a sorted set where all members have equal score, using lexicographical ordering.

[Redis documentation]

Arguments #

zrangebylex(key, min, max, [options]);

ArgumentsTypeDescription
key
string
Sorted set key
min
string
Minimum range value
max
string
Maximum range value
options
object
Optional query arguments

By default, the provided min and max values are inclusive. This behavior can be changed using the syntax described in the Redis ZRANGEBYLEX documentation.

options #

The options arguments can contain the following option properties:

PropertyType (default)Description
limit
integer[2]
An array of 2 integers, used to limit the number of returned matching elements (similar to SELECT LIMIT offset, count in SQL).
Format: [<offset>,<count>]
queuable
boolean (true)
If true, queues the request during downtime, until connected to Kuzzle again
timeout
number

(-1)
Time (in ms) during which a request will still be waited to be resolved. Set it -1 if you want to wait indefinitely
triggerEvents
boolean

(false)
If set to true, will trigger events even if using Embeded SDK. You should always ensure that your events/pipes does not create an infinite loop.
Available since Kuzzle 2.31.0

Resolve #

Resolves to an array of matched elements.

Usage #

try {
  await kuzzle.ms.zadd('ssetfoo', [
    {member: 'foo', score: '0'},
    {member: 'bar', score: '0'},
    {member: 'baz', score: '0'}
  ]);
  // Prints: [ 'bar', 'baz' ]
  // Lexicographically gets elements with a maximum value of 'f' (excluded),
  // without a minimum value
  console.log(await kuzzle.ms.zrangebylex('ssetfoo', '-', '(f'));
} catch (error) {
  console.error(error.message);
}