summaryrefslogtreecommitdiffstats
path: root/iredis/data/commands/exists.md
blob: 83c20434420fc242b03633c26b6bd6b3ae9eff1a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
Returns if `key` exists.

Since Redis 3.0.3 it is possible to specify multiple keys instead of a single
one. In such a case, it returns the total number of keys existing. Note that
returning 1 or 0 for a single key is just a special case of the variadic usage,
so the command is completely backward compatible.

The user should be aware that if the same existing key is mentioned in the
arguments multiple times, it will be counted multiple times. So if `somekey`
exists, `EXISTS somekey somekey` will return 2.

@return

@integer-reply, specifically:

- `1` if the key exists.
- `0` if the key does not exist.

Since Redis 3.0.3 the command accepts a variable number of keys and the return
value is generalized:

- The number of keys existing among the ones specified as arguments. Keys
  mentioned multiple times and existing are counted multiple times.

@examples

```cli
SET key1 "Hello"
EXISTS key1
EXISTS nosuchkey
SET key2 "World"
EXISTS key1 key2 nosuchkey
```