blob: 4998f5f582a0d1f3f132ce1bfc53eaa9a0833cb7 (
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
34
35
36
37
38
39
40
41
42
|
Increment the string representing a floating point number stored at `key` by the
specified `increment`. By using a negative `increment` value, the result is that
the value stored at the key is decremented (by the obvious properties of
addition). If the key does not exist, it is set to `0` before performing the
operation. An error is returned if one of the following conditions occur:
- The key contains a value of the wrong type (not a string).
- The current key content or the specified increment are not parsable as a
double precision floating point number.
If the command is successful the new incremented value is stored as the new
value of the key (replacing the old one), and returned to the caller as a
string.
Both the value already contained in the string key and the increment argument
can be optionally provided in exponential notation, however the value computed
after the increment is stored consistently in the same format, that is, an
integer number followed (if needed) by a dot, and a variable number of digits
representing the decimal part of the number. Trailing zeroes are always removed.
The precision of the output is fixed at 17 digits after the decimal point
regardless of the actual internal precision of the computation.
@return
@bulk-string-reply: the value of `key` after the increment.
@examples
```cli
SET mykey 10.50
INCRBYFLOAT mykey 0.1
INCRBYFLOAT mykey -5
SET mykey 5.0e3
INCRBYFLOAT mykey 2.0e2
```
## Implementation details
The command is always propagated in the replication link and the Append Only
File as a `SET` operation, so that differences in the underlying floating point
math implementation will not be sources of inconsistency.
|
