push.pro (Documentation for jbiu/)

;+
; NAME:
;    PUSH
;
; PURPOSE:
;    Adds an element to the end of a (possibly non-existent) array.
;
; CATEGORY:
;    Misc
;
; CALLING SEQUENCE:
;    PUSH, Array, Value
;
; INPUTS:
;    Array:   An array to which the values are to be added. The array
;             is created if it doesn't already exist.
;
;    Value:   A value to be added to the end of Array. Must be the
;             same type as Array.
;
; EXAMPLE:
;    IDL> PUSH, a, 5
;    IDL> PRINT, a
;        5
;    IDL> PUSH, a, 8
;    IDL> PRINT, a
;        5      8
;
; MODIFICATION HISTORY:
;    Written by:   Jeremy Bailin
;    12 June 2008  Public release in JBIU
pro push, array, value

case size(array, /n_dimen) of
  0: array = [(value)[*]]
  1: array = [array, (value)[*]]
  else: message, 'Array cannot have more than 1 dimension.'
endcase

end