Name

---

      BYT2STRARR

Purpose

---

      Unpack a string array from a byte array

Category

---

Calling Sequence

---

      byt2strarr, barr, tarr

Inputs

---

      barr = byte array with text. in

Keyword Parameters

---

Outputs

---

      tarr = text string array. out

Common Blocks

---

Notes

---

      Notes: The format of barr is:
        byte 0: NUM = Number of strings (255 max).
        byte 1: MAX = Length of longest string (255 max).
        byte 2: LEN1 = Length of 1st string.
        byte 3: C1_0 = 1st char of 1st string.
        byte 4: C1_1 = 2nd char of 1st string.
        byte 5: C1_2 = 3rd char of 1st string.
        . . .
        byte x1 (2+LEN1): C1_last = last char of 1st string.
        byte x1+1: LEN2 = Length of 2nd string.
        . . .
        To last char of last string in tarr.
        NUM, MAX, LEN1, C1, C2, ..., Clast, LEN2, C1, C2, ...
     
        Advantage: saves space, allows storing text arrays of
        various lengths. See also strarr2byt, the inverse.

Modification History

---

      R. Sterner, 1996 May 29
      R. Sterner, 2010 Apr 30 --- Converted arrays from () to [].
  Copyright (C) 1996, 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.