L_VecInit

#include "lvkrn.h"

L_INT EXT_FUNCTION L_VecInit(pVector)

/* pointer to a vector handle */

Initializes the fields in a vector handle.

Parameter	Description
pVector	Pointer to the vector handle to be initialized.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

You must call this function before calling L_VecCopy.

Required DLLs and Libraries

LVKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	L_VecCopy
Topics:

Example

/* This example will make a copy of a vector handle */

L_INT DoSomething( pVECTORHANDLE pVector )
{
   VECTORHANDLE   TmpVector;  /* Temporary vector handle */
   L_INT          nRet;       /* Return value */

   /* Initiate the temporary vector handle */
   L_VecInit( &TmpVector );

   /* Make a copy */
   nRet = L_VecCopy( &TmpVector, pVector, VECTOR_FLAGS_REPLACE );
   if( nRet != SUCCESS )
   {
      return( nRet );
   }
   /*
   ...
   Do something with TmpVector
   ...
   */

   /* Destroy temporary vector before returning. */
   L_VecFree( &TmpVector );

   return( SUCCESS );
}