Redis String API Reference

`String Commands`

5 methods

Commands operating on Redis string values.

SET key value [EX seconds | PX ms] [NX | XX] [KEEPTTL]

Sets key to value with optional expiry and existence condition flags.

Name	Type	Description
key	string	Key to set.
value	string	Value to store.
EX	integer	Expire in seconds.
NX	flag	Only set if key does not exist.
XX	flag	Only set if key already exists.

OK | nil

redis

SET session:42 abc123 EX 3600 NX

GET key

Returns the string value stored at key, or nil if the key does not exist.

Name	Type	Description
key	string	Key to read.

string | nil

redis

GET session:42

INCR key | INCRBY key delta

Atomically increments the integer value stored at key by one or by the given delta.

Name	Type	Description
key	string	Key holding an integer string.
delta	integer	Increment for INCRBY; defaults to 1 for INCR.

integer

redis

INCR counter:pageviews

APPEND key value

Appends value to the string at key, creating it if it does not exist. Returns the new length.

Name	Type	Description
key	string	Key to append to.
value	string	Value to append.

integer

redis

APPEND log:today "newline\n"

EXPIRE key seconds [NX | XX | GT | LT]

Sets a time-to-live in seconds on a key, with optional condition flags.

Name	Type	Description
key	string	Key to expire.
seconds	integer	TTL in seconds.

0 | 1

redis

EXPIRE session:42 3600