>  Docs Center  >  Libraries  >  JHU/APL/S1R  >  GETRUN






      N'th run of consecutive integers from a given array.'


Calling Sequence

      w2 = getrun(w, n, [m])


      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


        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.


      w2 = returned run or runs. out

Common Blocks


      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.

© 2020 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us