Name

---

      LIST_INSERT

Purpose

---

      Insert a 1-d array into another 1-d array.

Category

---

Calling Sequence

---

      output = list_insert(input, cmd, line, [add])

Inputs

---

      input = Initial 1-d array. in
      cmd = Edit command: in
            'P': Preceded line by add.
            'R': Replace line by add.
            'F': Follow line by add.
            'D': Delete line (add array ignored).
      line = Index in old (first index=0). in
        This may also be a range of indices: [lo,hi].
      add = 1-d array to insert. in

Keyword Parameters

---

Keywords

---

        COUNT=cnt Returned number of elements in output array.
        ERROR=err Error flag: 0=ok.

Outputs

---

      output = Returned modified array. out

Common Blocks

---

Notes

---

      Note: For a scalar out of range index the array
        is not changed. For an index range the array
        will be changed for commands other than delete.

Modification History

---

      R. Sterner, 2009 May 20
  Copyright (C) 2009, 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.