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.