FLDFget_typed_node_data


Synopsis

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

 

INTEGER FLDFget_typed_node_data(field, comp, type, node_data, size, mode)
     INTEGER field(OIDSIZ)
     INTEGER comp
     INTEGER type
     INTEGER size
     INTEGER node_data
     INTEGER mode

Description

FLDFget_typed_node_data returns an array containing the node data, converted to the desired type.

Parameters

field

The field from which to extract the node data.

comp

Which component to extract.

type

An integer representing the desired data type for node_data. 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 node_data array is returned in the integer to which this parameter points.

node_data

An integer representing a pointer to the node_data array is stored into node_data. 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 node_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

3

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