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

NEXTITEM

NEXTITEM

Name


      NEXTITEM

Purpose


      Return next line from a file, ignore comments & null lines.

Category


Calling Sequence


      itm = nextitem(lun, [txt])

Inputs


      lun = unit number of opened text file. in

Keyword Parameters


Outputs


      txt = optionally returned complete line. out
      itm = first word in text line. out

Common Blocks


Notes


      Note: Useful to read control files. First item on each
        line is returned. Items may be delimited by spaces,
        commas, or tabs. Null lines and comments are ignored.
        Comment lines have * as the first character in the line.
        If a line contains only a single space it is considered
        a null line. The entire text line may optionally be
        returned. It has commas and tabs converted spaces,
        ready for GETWRD. On EOF a null string is returned.

Modification History


      Written by R. Sterner, 19 June, 1985.
      Johns Hopkins University Applied Physics Laboratory.
      RES 5 Nov, 1985 --- returned TXT.
  Copyright (C) 1985, 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.



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