touch.3valkey - Man Page

Returns the number of existing keys out of those specified after updating the time they were last accessed.

Synopsis

TOUCH key [key...]

Description

Alters the last access time of a key(s). A key is ignored if it does not exist.

Reply

valkey-protocol(7) Integer reply: the number of touched keys.

Complexity

O(N) where N is the number of keys that will be touched.

Acl Categories

@fast @keyspace @read

History

Examples

127.0.0.1:6379> SET key1 "Hello"
OK
127.0.0.1:6379> SET key2 "World"
OK
127.0.0.1:6379> TOUCH key1 key2
(integer) 2

See Also

copy(3valkey), del(3valkey), dump(3valkey), exists(3valkey), expire(3valkey), expireat(3valkey), expiretime(3valkey), keys(3valkey), migrate(3valkey), move(3valkey), object(3valkey), object-encoding(3valkey), object-freq(3valkey), object-help(3valkey), object-idletime(3valkey), object-refcount(3valkey), persist(3valkey), pexpire(3valkey), pexpireat(3valkey), pexpiretime(3valkey), pttl(3valkey), randomkey(3valkey), rename(3valkey), renamenx(3valkey), restore(3valkey), scan(3valkey), sort(3valkey), sort_ro(3valkey), ttl(3valkey), type(3valkey), unlink(3valkey), wait(3valkey), waitaof(3valkey)

Info

2024-09-23 8.0.0 Valkey Command Manual