6 - Language Dictionary
102
cfStateList
Syntax
int cfStateList(CF_HANDLE server, char *buffer);
Description
Returns a comma-separated and null terminated list of instrument state names that are stored on
the server. The buffer must be large enough to hold a list of the names of the maximum number
of states that can be saved in a Cell Forming Server. The constant
CF_MAX_STATE_LIST_LEN can be used to allocate space for the buffer.
Example
char list_buffer[CF_MAX_STATE_LIST_LEN];
/* Read and print the list of instrument state names. */
cfStateList(server, list_buffer);
printf("%s\n", list_buffer);
cfStateRecall
Syntax
int cfStateRecall(CF_HANDLE server, char *state);
Description
Loads a named instrument state previously created with cfStateSave. The server argument can be
either a handle to a group obtained by cfOpenGroup, or a handle to all cells in the instrument if
no groups are defined. All programmable functions of the instrument are set to the values stored
in the state. This command also aborts any forming sequence that is in progress, setting the
forming state to CF_IDLE.
cfStateSave
Syntax
int cfStateSave(CF_HANDLE server, char *state);
Description
Saves the current instrument settings in a non-volatile state with the name given by the state
parameter. The server argument can be either a handle to a group obtained by cfOpenGroup, or a
handle to all cells in the instrument if no groups are defined. If a state already exists with the
given name, the old state is over-written. State names are limited to
CF_MAX_STATE_NAME_LEN characters in length.
cfTrigger
Syntax
int cfTrigger(CF_HANDLE server);
Description
Sends a trigger from the CF_LAN trigger source. The server argument can be either a handle to a
group obtained by cfOpenGroup, or a handle to all cells in the instrument if no groups are
defined.