FLDFget_typed_cell_data


Synopsis

returns an array containing the cell data, converted to the desired type


INTEGER FLDFget_typed_cell_data(field, comp, type, cell_data, size, mode)
     INTEGER field(OIDSIZ)
     INTEGER comp
     INTEGER type, size
    INTEGER cell_data
     INTEGER mode

Description

FLDFget_typed_cell_data returns an array containing the cell data, converted to the desired type.

Parameters

field

The field from which to extract the cell data.

comp

Which component to extract.

type

You store the desired type, according to the table below, into type. Possible values are:

 

Constant

 

Value

 

DTYPE_CHAR

0

DTYPE_BYTE

1

DTYPE_SHORT

2

DTYPE_INTEGER

3

DTYPE_FLOAT

4

DTYPE_DOUBLE

5

 

size

The size of the returned cell_data array is returned in the integer to which this parameter points.

cell_data

An integer representing a pointer to an unknown (void) type. You must call ARRFfree() on the resulting an integer representing a pointer when you are done using it.

On 64-bit platforms dims_ptr is actually an INTEGER*8.

mode

The access mode for the cell_data array:

 

Mode

 

Value

 

Meaning

 

OM_GET_ARRAY_RD

0

The program reads the array, but does not write to it.

OM_GET_ARRAY_WR

1

The program writes to the array, completely replacing it.

OM_GET_ARRAY_RW

2

The program reads from and writes to the array.

OM_GET_ARRAY_RD_COPY

 

The program requires a copy of the array for its own, private use (reading or writing).