Download documentation

Choose the products and versions you want. Everything arrives as one .tar.gz, with a directory per product.

Format

This page

	Products	Version
	Develop with Redis Clients, data types, programmability, and Redis for AI. RedisVL is listed separately.
	Libraries and tools Client libraries, observability, and cloud integrations. Redis Data Integration is listed separately.
	RedisVL
	Redis Software
	Redis Cloud
	Redis for Kubernetes
	Redis Open Source
	Redis Iris context engine
	Redis Feature Form
	Redis Insight
	Redis Data Integration
	Glossary
	Command reference

ARGETRANGE

Array is a new data type that is currently in preview and may be subject to change.

Syntax text Syntax diagram API methods

ARGETRANGE key start end

Client:

argetrange(
    name: KeyT,
    start: int,
    end: int
) → list

arGetRange(
    key: RedisArgument,
    start: number | string,
    end: number | string
) → ArrayReply<BlobStringReply | NullReply>

argetrange(
    key: K,  // the key of the array.
    start: long,  // the start index (inclusive).
    end: long  // the end index (inclusive).
) → List<V>  // a list of values (with null for empty slots).

argetrange(
    key: K,  // the key of the array.
    start: long,  // the start index (inclusive).
    end: long  // the end index (inclusive).
) → RedisFuture<List<V>>  // a list of values (with null for empty slots).

argetrange(
    key: K,  // the key of the array.
    start: long,  // the start index (inclusive).
    end: long  // the end index (inclusive).
) → Flux<Value<V>>  // a list of values (with null for empty slots).

ARGetRange(
    ctx: context.Context,  // Context
    key: string,
    start: uint64,
    end: uint64
) → *SliceCmd

argetrange(
    $key: string,
    $start: int,
    $end: int
) → array

Available since:: Redis Open Source 8.8.0
Time complexity:: O(N) where N is the range length
ACL categories:: @read, @array, @slow,
Compatibility:: Redis Software and Redis Cloud compatibility

Gets values in a range of indices.

Required arguments

key

The name of the key that holds the array.

start

The zero-based integer index of the first element to return. If start is greater than end, elements are returned in reverse index order.

end

The zero-based integer index of the last element to return (inclusive). If end is less than start, elements are returned in reverse index order.

Examples

redis> ARMSET myarray 0 "a" 1 "b" 3 "d"
(integer) 3
redis> ARGETRANGE myarray 0 3
1) "a"
2) "b"
3) (nil)
4) "d"
redis> ARGETRANGE myarray 3 0
1) "d"
2) (nil)
3) "b"
4) "a"

Redis Software and Redis Cloud compatibility

Redis Software	Redis Cloud	Notes
❌ Standard ❌ Active-Active	❌ Standard ❌ Active-Active

Return information

RESP2 RESP3

Array reply