Previous: SDDS_ReadTable
Up: Manual Pages
Next: SDDS_SetColumnFlags
Previous Page: SDDS_ReadTable
Next Page: SDDS_SetColumnFlags
- name:
SDDS_SetArray
- description:
Accepts a pointer to a structure containing the data and other information to be
used for an array in the current data table of a data set.
- synopsis:
#include "SDDS.h"
long SDDS_SetArray(SDDS_TABLE *SDDS_table, char *array_name, void *pointer, dimension-list);
- arguments:
- SDDS_table: Address of the SDDS_TABLE structure for the data set.
- array_name: A NULL-terminated character string giving the name of the array to return.
- pointer: Address of multidimensional pointer array indexing the data. The type of this
pointer in the caller's program is data-type*
, where data-type is the data
type of the array and * represents a sequence of n asterisks, n begin the number of dimensions
of the array. (Note that for type SDDS_STRING, data-type is char *.)
This corresponds to the pointer field of the SDDS_ARRAY structure
(see the manual page for SDDS_GetArray). The data is copied so that the caller may change
it after this call without affecting the behavior of SDDS routines.
- dimension-list: n arguments of type long, where n is the number of dimensions.
Successive arguments give the size in each dimension.
- return value:
On success, returns 1. On failure, returns 0 and records an error message.
- see also: