Name

---

      WORDARRAY

Purpose

---

      Convert text string or string array to 1-d array of words.

Category

---

Calling Sequence

---

      wordarray, instring, outlist

Inputs

---

      instring = string or string array to process. in

Keyword Parameters

---

Keywords

---

        IGNORE=string of characters to ignore (array allowed).
          These characters are removed before processing.
          Ex: wordarray,in,out,ignore=',;()'
              wordarray,in,out,ignore=[',',';','(',')']
        DELIMITERS = word delimiter characters, like IGNORE.
        /WHITE means include white space (spaces,tabs) along
          with the specified delimiters.
        NUMBER=num Number of elements in returned array.

Outputs

---

      outlist = 1-d array of words in instring. out

Common Blocks

---

Notes

---

      Notes: Words are assumed delimited by given delimiters
        (defaults are spaces and/or tabs)
        Non-delimiters are returned as part of the words.
        Delimiters not needed at the front and end of the strings.
        See commalist for a near inverse.

Modification History

---

      R. Sterner, 29 Nov, 1989
      BLG --- Modified June 22,1991 to include tabs as delimiters
      R. Sterner, 11 Dec, 1992 --- fixed to handle pure white space.
      R. Sterner, 27 Jan, 1993 --- dropped reference to array.
      R. Sterner, 1998 Apr 1 --- Added DELIMITER. Modified IGNORE.
      R. Sterner, 1998 Jul 31 --- Added NUMBER=nwds.
      R. Sterner, 2010 Apr 29 --- Converted arrays from () to [].
  Copyright (C) 1989, 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.