Method HIncrBy

structure/hash.go:649–716

HIncrBy increments the integer value of a hash field by the given number. It takes a string key 'k', a field 'f', and an increment value 'increment'. It returns the updated value after increment and any possible error. Parameters: k: The key of the hash table. f: The field whose value needs to b

(key string, field interface{}, increment int64)

//	int64: The updated value of the field after increment.
//	error: An error if occurred during the operation, or nil on success.
func (hs *HashStructure) HIncrBy(key string, field interface{}, increment int64) (int64, error) {
	// Convert the parameters to bytes
	k := stringToBytesWithKey(key)

	// Convert the parameters to bytes
	f, err, _ := interfaceToBytes(field)
	if err != nil {
		return 0, err
	}

	// Check the parameters
	if len(k) == 0 || len(f) == 0 {
		return 0, _const.ErrKeyIsEmpty
	}

	// Find the hash metadata by the given key
	hashMeta, err := hs.findHashMeta(key, Hash)
	if err != nil {
		return 0, err
	}

	// If the counter is 0, return 0
	if hashMeta.counter == 0 {
		return 0, nil
	}

	// Create a new HashField
	hf := &HashField{
		field:   f,
		key:     k,
		version: hashMeta.version,
	}

	// Encode the HashField
	hfBuf := hf.encodeHashField()

	// Get the field from the database
	value, err := hs.db.Get(hfBuf)
	if err != nil && err == _const.ErrKeyNotFound {
		return 0, nil
	}

	// Convert the value to int64
	val, err := strconv.ParseInt(string(value), 10, 64)
	if err != nil {
		return 0, err
	}

	// Add the increment to the value
	val += increment

	// Convert the value to string
	value = []byte(strconv.FormatInt(val, 10))

	// Create a new write batch
	batch := hs.db.NewWriteBatch(config.DefaultWriteBatchOptions)

	// Put the field to the database