Method SetIFDNE

string_commands.go:854–872

SetIFDNE sets the value only if the current value's digest does NOT equal matchDigest. This is a compare-and-set operation using xxh3 digest for optimistic locking. The matchDigest parameter is a uint64 xxh3 hash value. Returns "OK" on success (digest didn't match, value was set). Returns redis.Ni

(ctx context.Context, key string, value interface{}, matchDigest uint64, expiration time.Duration)

// NOTE SetIFDNE is still experimental
// it's signature and behaviour may change
func (c cmdable) SetIFDNE(ctx context.Context, key string, value interface{}, matchDigest uint64, expiration time.Duration) *StatusCmd {
	args := []interface{}{"set", key, value}

	if expiration > 0 {
		if usePrecise(expiration) {
			args = append(args, "px", formatMs(ctx, expiration))
		} else {
			args = append(args, "ex", formatSec(ctx, expiration))
		}
	} else if expiration == KeepTTL {
		args = append(args, "keepttl")
	}

	args = append(args, "ifdne", fmt.Sprintf("%016x", matchDigest))

	cmd := NewStatusCmd(ctx, args...)
	_ = c(ctx, cmd)
	return cmd
}

// SetIFDNEGet sets the value only if the current value's digest does NOT equal matchDigest,
// and returns the previous value.