gdaReadStruct#

Purpose#

Gets a structure from a GAUSS Data Archive.

Format#

{ instance, retcode } = gdaReadStruct(filename, varname, structure_type)#

Parameters:

filename (string) – name of data file.
varname (string) – name of structure instance in the GDA.
structure_type (string) – structure type.

Returns:

instance (struct) – instance of the struct.
retcode (scalar) –
0 if successful, otherwise, any of the following error codes:

1

Null file name.

2

File open error.

4

File read error.

5

Invalid file type.

8

Variable not found.

10

File contains no variables.

14

File too large to be read on current platform.

Examples#

// Create structure
struct mystruct {
   matrix x;
   array a;
};

struct mystruct msw;
msw.x = rndn(500, 25);
msw.a = areshape(rndn(5000, 100), 10|500|100);

// Create GDA `myfile`
ret = gdaCreate("myfile.gda", 1);

/*
** Write structure msw to `myfile`
** and store as variable ms
*/
retcode1 = gdaWrite("myfile.gda", msw, "ms");

// Declare new instance of mystruct, `msr`
struct mystruct msr;

// Read ms from GDA tp msr
{ msr, retcode2 } = gdaReadStruct("myfile.gda", "ms", "mystruct");

Remarks#

instance can be an array of structures.

1	Null file name.
2	File open error.
4	File read error.
5	Invalid file type.
8	Variable not found.
10	File contains no variables.
14	File too large to be read on current platform.