void IDL_RPCVarGetData(IDL_VPTR v, IDL_MEMINT *n, char **pd,  
    int ensure_simple)  

Description

Use this function to obtain a pointer to a variable's data, and to determine how many data elements the variable contains.

Parameters

v

The variable for which data is desired.

n

The address of a variable that will contain the number of elements in v.

pd

The address of a variable that will contain a pointer to v's data, cast to be a pointer to pointer to char (e.g. (char **) &myptr).

ensure_simple

If TRUE, this routine calls the ENSURE_SIMPLE macro on the argument v to screen out variables of the types it prevents. Otherwise, EXCLUDE_FILE is called, because file variables have no data area to return.

Return Value

On exit, IDL_RPCVarGetData() stores the data count and pointer into the variables pointed at by n and pd, respectively.

  IDL Online Help (March 06, 2007)