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


Harris Geospatial / Docs Center / Libraries / Markwardt / CMSV_PTRSUM

CMSV_PTRSUM

CMSV_PTRSUM

Name


  CMSV_PTRSUM

Author


  Craig B. Markwardt, NASA/GSFC Code 662, Greenbelt, MD 20770
  craigm@lheamail.gsfc.nasa.gov

Purpose


  Construct an inventory of heap data accessible to a variable

Calling Sequence


  CMSV_PTRSUM, VAR, LIST
 

Description



  This procedure constructs an inventory of heap data that is
  accessible to a single variable. It searches all array elements,
  recursively through structure tags, and by dereferencing pointers.
  Users can use this procedure to determine all heap variables that
  need to be saved to disk.
  This procedure is part of the CMSVLIB SAVE library for IDL by
  Craig Markwardt.
  ==================================================================
  Research Systems, Inc. has issued a separate license intended
  to resolve any potential conflict between this software and the
  IDL End User License Agreement. The text of that license
  can be found in the file LICENSE.RSI, included with this
  software library.
  ==================================================================

Inputs



  VAR - the variable to be examined
  LIST - upon output, an array of pointers, each of which points to
          a heap variable accessible to VAR. If there are no heap
          data pointed to by VAR, then LIST returns a NULL value.

Keywords



  NULL - if set, return the null value in LIST instead of the
          pointer list. VAR is ignored.
  HAS_OBJECTS - upon return, the value is 1 if VAR contains or
                points to an object reference, and 0 if not.

Example


See Also



  CMRESTORE, SAVE, RESTORE, CMSVLIB

Modification History


  Written, 2000
  Documented, 24 Jan 2001
  Make version checks with correct precision, 19 Jul 2001, CM
  Added notification about RSI License, 13 May 2002, CM
  $Id: cmsv_ptrsum.pro,v 1.7 2002/05/13 06:41:10 craigm Exp $



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