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

RES_TO_STRUCT

RES_TO_STRUCT

Name


      RES_TO_STRUCT

Purpose


      Read a RES file into a structure.

Category


Calling Sequence


      res_to_struct, resfile, struct

Inputs


      resfile = name of RES file. in

Keyword Parameters


Keywords


        IGNORE=ignore Optional list of tags to be ignored.
          List may be a text array or in a string like 'A B C'.
        /NOCOMMENTS means do not incude RES file comments in
          returned structure.
        /NOARRAYS means do not include any arrays in returned
          structure.
        /ARRAYS_ONLY means include only arrays in returned
          structure. Still can ignore specified tags.
        INCLUDE=include Optional list of tags to include.
          Useful to include some arrays when /NOARRAYS is used, or
          to include some non-arrays when /ARRAYS_ONLY is used.
          List may be a text array or in a string like 'A B C'.
        ERROR=err error flag: 0=ok.

Outputs


      struct = returned structure. out

Common Blocks


Notes


      Notes: Comments are included in tags named
        _comm001, _comm002, ... where number of digits
        depends on length res file header.

Modification History


      R. Sterner, 2003 Aug 20
      R. Sterner, 2004 Jun 28 --- Fixed ndig calculation.
      R. Sterner, 2004 Jun 28 --- Fixed to allow overwrite if 0.
      R. Sterner, 2004 Sep 23 --- Added keyword IGNORE.
      R. Sterner, 2004 Sep 27 --- Dropped overwrite check.
      R. Sterner, 2004 Oct 11 --- Fixed to not read ignored items.
      R. Sterner, 2004 Oct 11 --- Added keywords /NOARRAY, /ARRAYS
      R. Sterner, 2004 Oct 12 --- Comments with = were broke, fixed.
      R. Sterner, 2005 May 06 --- Added keyword INCLUDE.
      R. Sterner, 2010 Jun 09 --- Converted arrays from () to [].
  Copyright (C) 2003, 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.



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