hsetnx

Sets a field and its value in a hash, only if the field does not already exist.

[Redis documentation]


hsetnx(key, field, value, [options], [callback])

Arguments Type Description
key string Key identifier
field string Field name to insert or to update
value string Associated field value
options JSON Object Optional parameters
callback function Callback

Options

Option Type Description Default
queuable boolean Make this request queuable or not true

Return Value

Returns the MemoryStorage object to allow chaining.


Callback Response

Returns a boolean specifying if the operation was successful or not.

Usage

Copied to clipboard!

<?php

use \Kuzzle\Kuzzle;


$kuzzle = new Kuzzle('localhost');

try {
  $status = $kuzzle->memoryStorage()->hsetnx('key', 'field', 'value');
}
catch (ErrorException $e) {

}

Callback response:

Copied to clipboard!
true