SDDS_SetArray

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”
int32_t SDDS_SetArray(SDDS_TABLE *SDDS_table, char *array_name, int32_t mode, void *pointer, int32_t 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.
- mode: SDDS_POINTER_ARRAY or SDDS_CONTIGUOUS_DATA.
- pointer: Address of multidimensional pointer array indexing the data. The type of this pointer in the caller’s program is data-type*n, where data-type is the data type of the array and *n 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 int32_t, 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: