NAME

cxUnkGet - get information about unknown data structure

C SPECIFICATION

#include <cx/DataAccess.h>

cxErrorCode cxUnkGet(cxUnknown *src, long *count, char *(data[]))

FORTRAN SPECIFICATION

integer function cxUnkGet(src, count, pdata)
integer src
integer count, pdata
pointer (pdata, data)
integer data(*)

PARAMETERS

src
Input data structure.
count
Set to number of bytes in src.
data
Set to first byte of data array.

FUNCTION RETURN VALUE

Returns an integer error code enumeration.

DESCRIPTION

Retrieves information about size and location of data in an IRIS Explorer cxUnknown data type and stores them in count and data. cxUnkGet returns cx_err_none on success.

The user can tell the function not to get information on a particular field by passing a NULL pointer value. You need not create dummy variables in the calling routine which calls cxUnkGet, because the request is simply ignored when the pointer comes in NULL.

SEE ALSO

cxUnknown(3E)
Last modified: May 27 15:23 1999
[ Documentation Home ]
© The Numerical Algorithms Group Ltd, Oxford UK. 1999