Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


Harris Geospatial / Docs Center / Using IDL / Copying Variables

IDL

Copying Variables

Copying Variables

To copy the contents of one variable to another, use the IDL_VarCopy() function:

void IDL_VarCopy(IDL_VPTR src, IDL_VPTR dst) 

Arguments src and dst are the source and destination, respectively.

IDL_VarCopy() uses the following rules when copying variables:

  • If the destination variable already has a dynamic part, this dynamic part is released.
  • The destination becomes a copy of the source.
  • If the source is a temporary variable, IDL_VarCopy() does not make a duplicate of the dynamic part for the destination. Instead, the dynamic part of the source is given to the destination, and the source variable itself is returned to the pool of free temporary variables. This is the equivalent of freeing the temporary variable. Therefore, the variable must not be used any further and the caller should not explicitly free the variable. This optimization significantly improves resource utilization and performance because this special case occurs frequently.



© 2017 Exelis Visual Information Solutions, Inc. |  Legal
My Account    |    Buy    |    Contact Us