Name

---

      TYPEXTRACT

Purpose

---

      Extract a specified datatype from binary data in byte array.

Category

---

Calling Sequence

---

      num = typextract(txt, offset, bindat)

Inputs

---

      txt = datatype description in a text string. in
      offset = offset in bytes into bindat. in
      bindat = binary data in a byte array. in

Keyword Parameters

---

Keywords

---

        BITS=bits Returned total number of bits in given item.
        ERROR=err Error flag: 0=ok, else error.

Outputs

---

      num = extracted numeric item. out

Common Blocks

---

Notes

---

      Note: datatypes are: BYT, INT, LON, FLT, DBL, COMPLEX,
        DCOMPLEX, UINT, ULON, LONG64, ULONG64.
        Any array dimensions follow the data type in parantheses.
        Examples: "UINT","FLT","BYT(3,4)","LON(100)".
        The inverse of datatype. Note array syntax is
        not quite like the IDL array functions, use byt(3,4)
        for this routine instead of bytarr(3,4).
        See also typ2num.

Modification History

---

      R. Sterner, 2002 Oct 11
      R. Sterner, 2010 Jun 07 --- Converted arrays from () to [].
      R. Sterner, 2011 May 27 --- Added portable data descriptions: I8, I16, I32, ...
      R. Sterner, 2011 May 31 --- Can now handle character strings.
  Copyright (C) 2002, 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.