Function: LiMeshingRefinementCopy

LiMeshingRefinementCopy

Function

LtMeshingRefinement

LiMeshingRefinementCopy(	`LtMeshingRefinement`	copy_me
	)

Synopsis Create a brand new meshing refinement, by copying an existing one.

Location ligeops

Parameters

copy_me Meshing refinement to be copied.

Return Value

A copy of the meshing refinement that was passed in.

Description

Allows us to copy a meshing refinement that has previously been created using either LiMeshingRefinementCreate or LiMeshingRefinementCopy.

If the function returns (LtMeshingRefinement)NULL, then either a memory allocation error has occurred, or a NULL refinement has been passed into the routine.

Any criteria in the copy_me refinement (passed in) that have had values associated with them, will be associated with exactly the same values, in the resultant refinement.

Example

 /*
 * Copy a meshing refinement that I like the look of
 */
copy_ref = LiMeshingRefinementCopy(nice_ref);
if ( not copy_ref )
   /* memory allocation failure */