Name

---

      TAG_VALUE

Purpose

---

      Return the value for a given structure tag.

Category

---

Calling Sequence

---

      val = tag_value(ss, tag)

Inputs

---

      ss = given structure. in
      tag = given tag. in

Keyword Parameters

---

Keywords

---

        INDEX=in Index into structure where tag found (-1 if none).
          Could access value as val = ss.(in)
        MINLEN=mn Minimum tag length to match (def=exact match).
          SS may have the tag abbreviated down to mn characters.
          (But tag must be at least as long as appears in ss).
        TRUNCATE=len Length to optionally truncate SS tag names to.
          First match, if any, of truncated tags will be returned.
          So tag of 'GRIB_PAT' and TRUNCATE=8 will match
          'GRIB_PAT_00Z' or 'GRIB_PAT_12Z' if they are in SS.
        ERROR=err Error flag: 0=ok, else tag not found.
          On error returned value is a null string.

Outputs

---

      val = returned value. out

Common Blocks

---

Notes

---

Modification History

---

      R. Sterner, 2004 May 05
      R. Sterner, 2006 Sep 27 --- Added MINLEN.
      R. Sterner, 2008 Oct 24 --- Added INDEX=in.
      R. Sterner, 2009 Mar 27 --- Added TRUNCATE=len.
  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.