NAME

cxConnDup - copy a connection list structure

C SPECIFICATION

#include <cx/DataAccess.h>

cxConnection *cxConnDup(cxConnection *src)

FORTRAN SPECIFICATION

integer function cxConnDup(src)
integer src

PARAMETERS

src: Input connection list data structure.

FUNCTION RETURN VALUE

The returned value for this function is a pointer to the newly created connection list, or NULL if its input is malformed or if an allocation error occurs.

DESCRIPTION

cxConnDup makes an exact copy of its input connection list for return to the caller. The routine copies the elements and connections arrays within the connection list.

cxConnDup is useful for creating a new pyramid that refers to lattices contained in another pyramid, but with slightly different connections. The lattices can be added to the new pyramid by reference, but the old connections are copied and then the distinct new connection values are set. Routines cxConnPtrSet and cxConnEleSet set the data values contained within a connection list. They are used to replace all or part of a connection list.