Previous: DSGETS
Up: Retrieving data
Previous Page: DSGETS
Next Page: Example

IDSGET

integer function idsget(name,*iv*,ient,
     > isize*,ngot*,mxent,ncopy,idata,ierr*)

void *idsget(name, iv, ient, isize, ngot,
             mxent, ncopy, idata, ierr)
      char *name;
      int *iv, ient, *isize, *ngot,
          mxent, *ncopy, *idata, *ierr;

Generic GET function.

IDSGET may perform following tasks

• Copy complete data sets into specified address
• Copy selected entries of a data set
• Copy selected words of each entry into a vector
• Copy selected subsets each entry into an array
• Return a pointer to a data set or to any subset

NAME

- data set name

*IV*

- descriptor. It helps idsget to avoid multiple searches or name parsing. It must be set to 0 before the first call and never modified by the user.

IENT

- entry number (ignored if specified in name)

ISIZE*

- ROOT data set size in bytes (per entry)

NGOT*

- Number of available entries

MXENT

- Number of entries to copy (if 0 only the pointer s returned)

NCOPY*

- Number of entries copied

IDATA*

- Copied data

IERR*

- DSPACK error flag

• Example