Skip to content

Matlab API Set Operations

Blocking set functions

These functions return only once the device has received the set value. If the set operation fails, an exception is raised.

Note

Before version 25.04, these functions returned without waiting for the device to acknowledge the node value. This is not anymore the case.

setDouble

ziDAQ('setDouble', path, value);

path (string) = Node path
value (double) = Setting value

setComplex

ziDAQ('setComplex', path, value);

path (string) = Node path
value (complex double) = Setting value

setInt

ziDAQ('setInt', path, value);

path (string) = Node path
value (int64) = Setting value

setByte

ziDAQ('setByte', path, value);

path (string) = Node path
value (double) = Setting value

setString

ziDAQ('setString', path, value);

path (string) = Node path
value (string) = Setting value

setVector

ziDAQ('setVector', path, value);

path (string) = Vector node path
value (vector of (u)int8, (u)int16, (u)int32, (u)int64,
       float, double; or string) = Setting value

Batch set functions

When many values need to be set, better performance can be achieved by grouping the sets together, instead of sending the set commands one by one. This can be done using the set function.

set

ziDAQ('set', values);

path (string) = Node path
values (matrix) = Matrix where every row consists of a path
                  and a value. The first column is the path
                  and the second column is the value.
Set multiple node values at once in a single transaction.
This is more efficient than calling 'set*' multiple times.

Async set functions

These functions return immediately. No exception is ever raised, even if the set operation fails.

asyncSetString

ziDAQ('asyncSetString', path, value);

path (string) = Node path
value (string) = Setting value

Legacy blocking set functions

These functions block until the device has acknowledged the set value. Since version 25.04, setInt, setDouble, setComplex, setString and setByte have the same behavior so these functions are now superfluous and kept only for backward compatibility.

syncSetDouble

ziDAQ('syncSetDouble', path, value);

path (string) = Node path
value (double) = Setting value
Since version 25.04, syncSetDouble and setDouble have the 
same behavior. It is recommended to use setDouble instead of
syncSetDouble.

syncSetInt

ziDAQ('syncSetInt', path, value);

path (string) = Node path
value (int64) = Setting value
Since version 25.04, syncSetInt and setInt have the 
same behavior. It is recommended to use setInt instead of
syncSetInt.

syncSetString

ziDAQ('syncSetString', path, value);

path (string) = Node path
value (string) = Setting value
Since version 25.04, syncSetString and setString have the 
same behavior. It is recommended to use setString instead of
syncSetString.