>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  M_PUT






      Save a value by a tag name in a global area.


Calling Sequence

      m_put, tag, val


      tag = Tag name for value. in
        (spaces converted to _)
      val = Value to save. in
        Any IDL data item, scalars, arrays, structures,
        even objects.

Keyword Parameters


        AREA=aname Name of area to use (def="DEFAULT").
          Limit of 9 named areas (plus default area).
          (spaces converted to _)
        DEFAULT=area Name of area to default to instead
          of "DEFAULT". Later calls to m_put, m_list, or
          m_get will use this default area instead of "DEFAULT".
          To clear back to the normal default, call with
          DEFAULT="DEFAULT". The default keyword will work on
          any of the m_* routines.
        /CLEAR clear an area or a tag.
          If a tag name is given that tag wil be cleared in
          the default or specified area. If tag name is not
          given then the specified area will be cleared.
        ERROR=err Error flag: 0=ok.
        /QUIET inhibit error messages.


Common Blocks



      Notes: This routine is used to save values under given
      names to be retrieved later using m_get. m_get may be
      used in another routine, no values need be passed to it.
      Values are saved in areas, there are 10 such areas, one
      default area and 9 which are specified by an area name.
      If an area name is not given the default area is used.
      The name "default" (case ignored) will use the default area.
      Use m_get or m_fun to retrieve items from a global area,
        m_list to list items in the global areas.

Modification History

      R. Sterner, 2004 May 05
  Copyright (C) 2004, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.

© 2022 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us