GETRUN Name
GETRUN Purpose
N'th run of consecutive integers from a given array.'
Category
Calling Sequence
w2 = getrun(w, n, [m]) Inputs
w = output from where to process. in
n = run number to get (first = 0 = def). in
m = optional last run number to get. in
Keyword Parameters
Keywords
LOCATION = l. Return run n start location.
/LAST means n is offset from last run. So n=0 gives
last run, n=-1 gives next to last, ...
If n=-2 and m=0 then last 3 runs are returned.
/LONGEST returns the longest run. n returned, m ignored.
Outputs
w2 = returned run or runs. out
Common Blocks
Notes
Note: Getrun is meant to be used on the output from where.
if m > n then w2 will be a string of runs from run n to
run m. If no m is given then w2 will be a single run.
If n<0 returns runs starting at run abs(n) to end of w.
If n is out of range then a -1 is returned.
See also nruns.
Modification History
R. Sterner, 18 Mar, 1990
R. Sterner, 12 Aug, 1993 --- minor simplification.
R. Sterner, 2011 Jun 14 --- Converted arrays from () to [].
Copyright (C) 1990, 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.