NAME

C SPECIFICATION

#include <cx/DataAccess.h>

cxErrorCode cxConnPtrGet(cxConnection *src,
long *numElements,
long *numConnections,
long **elements,
long **connections)

FORTRAN SPECIFICATION

integer src
integer numelements, numconnections
integer pelements, pconnections

pointer (pelements, elements)
pointer (pconnections, connections)
integer elements(numelements)
integer connections(numconnections)

PARAMETERS

src

Input connection list data structure.

numElements

Output length of the elements array.

numConnections

Output length of the connections array.

elements

Output pointer to the array of the cumulative number of connections from all lattice elements at a given pyramid layer.

connections

Output pointer to the array of the concatenated list of all connections (represented by the index number of the connection's destination) for the lattice elements at a given pyramid layer.

FUNCTION RETURN VALUE

DESCRIPTION

The Fortran user can access the elements and connections arrays by using the Fortran pointer construction to equivalence the returned integer memory address and the start of the desired array, as indicated in the Fortran specification above.

cxConnPtrGet performs essentially the same function as repeated calls to the cxConnEleGet routine, but is many times faster since it avoids data copying and the overhead of multiple subroutine calls.

A return value of cx_err_none indicates 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 cxConnPtrGet, because the request is simply ignored when the pointer comes in NULL.

SEE ALSO