Previous: SDDS_DefineArray
Up: Manual Pages
Next: SDDS_DefineColumn
Previous Page: SDDS_DefineArray
Next Page: SDDS_DefineColumn

SDDS_DefineAssociate

• name:
  SDDS_DefineAssociate
• description:
  Processes a definition of an associate file.
• synopsis: #include "SDDS.h"
  long SDDS_DefineAssociate(SDDS_TABLE *SDDS_table, char *filename, char *path, char *description, char *contents, long sdds)
• arguments:
  • SDDS_table : Address of the SDDS_TABLE structure for the data set.
  • filename: A NULL-terminated string giving the name of the associated file.
  • path: A NULL-terminated string giving the directory path of the associated file.
  • description: A NULL-terminated string giving the description entry for the associated file description.
  • contents: A NULL-terminated string giving the contents entry for the associated file description.
  • sdds: If non-zero, indicates that the associated file is a SDDS file.
• return value:
  On success, returns the index of the newly-defined associate. Returns -1 on failure and records an error message.
• see also:
  • SDDS_GetAssociateDefinition
  • SDDS_GetAssociateInformation
  • SDDS_GetAssociateNames
  • SDDS_NumberOfErrors
  • SDDS_PrintErrors