Name

---

BOOST_ARRAY

Purpose

---

Append one array onto a destination array

Explanation

---

Add array APPEND to array DESTINATION, allowing the dimensions of
DESTINATION to adjust to accommodate it. If both input arrays have the
same number of dimensions, then the output array will have one
additional dimension. Otherwise, the last dimension of DESTINATION
will be incremented by one.

Category

---

Utility

Calling Sequence

---

BOOST_ARRAY, DESTINATION, APPEND

Input

---

DESTINATION = Array to be expanded.
APPEND = Array to append to DESTINATION.

Outputs

---

DESTINATION = Expanded output array.

Restrictions

---

DESTINATION and APPEND have to be either both of type string or both of
numerical types.
APPEND cannot have more dimensions than DESTINATION.
  MODIFICATION HISTOBY:
Written Aug'88 (DMZ, ARC)
Modified Sep'89 to handle byte arrays (DMZ)
Modifed to version 2, Paul Hick (ARC), Feb 1991
Removed restriction to 2D arrays, William Thompson (ARC), Feb 1992.
Converted to IDL V5.0 W. Landsman September 1997