4.86 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:
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors
  • SDDS_GetArray