.-
help for ^infilen^                                             (STB-42: dm54)
.-

infile fixed format data with a dictionary, storing comments as notes
---------------------------------------------------------------------

   ^infilen^ ^using^ dfilename [^if^ exp] [^in^ range] [^,^ ^a^utomatic
                  ^u^sing^(^filename2^)^ ^clear^ ^n^lines^(^#^)^ ]

The syntax of ^infilen^ is exactly that described in @infile2@, except for the ad-
ditional option ^nlines^; see below.


Description
-----------

^infilen^ reads fixed-format ASCII data from a text file using a data dictionary
found in ^dfilename^; that is, it @infile@s text data as described in @infile2@.hlp.
Then, ^infilen^ re-reads the data dictionary in ^dfilename^, captures any comments
that begin with the characters ^*!^, and saves them as @notes@.

Data dictionaries can include any number of comments, lines with the character
^*^ in the first column.  ^infilen^ issues an ^infile^ command to read data and then
searches the data dictionary used by ^infile^, looking for lines where the first
two columns contain the characters ^*!^. (This is the type of comment line that,
if found in an .ado file, will be displayed by @which@.)  ^infilen^ saves comments
of that type as ^notes^, as if the command @note@^: "comment"^ had been issued for
each ^*!^ comment found; if "^comment^" == "", @note@^: "."^ is issued. Comments with-
out ^!^ in the second column are ignored.

The double quote (^"^) character may not appear in comments to be saved as notes;
left quotes (^`^) may appear, but they will be translated to right quotes (^'^).
Only the first 80 characters of a comment will be saved.


Options
-------

^nlines(^#^)^ controls the maximum number of lines in the data dictionary that will
    be scanned for the string ^*!^; the default value of # is 50.

All other options are as described for @infile2@.


Examples
--------

Assume the text file mandible.dat begins thus:

dictionary {
*! Data from:  Chitty, L. S., Campbell, S., & Altman, D. G. (1993).
*! Measurement of the fetal mandible --- feasibility and construction of
*! a centile chart. _Prenatal Diagnosis_, 13, 749-756.
*
   float  gest       "Length of gestation (weeks)"
   byte   mandible   "Mandible (mm)"
}
 12.28571          8
 12.42857          9
 12.71429         11
      (etc.)


 . ^infile using mandible.dat, clear^
   (Replace the current data with data read from mandible.dat, using the dict-
   ionary shown above)

 . ^infilen using mandible.dat, clear^
   (Replace the current data with data read from mandible.dat, using the dict-
   ionary shown above, and save three comments as notes)

 . ^notes^
   (Display all notes, including comments captured from the data dictionary)

 . ^notes _dta in 1/3^
   (Display only the comments captured from the data dictionary)


Author
------

      John R. Gleason
      Syracuse University
      loesljrg@@ican.net


Also see
--------

    STB:  STB-42 dm54
 Manual:  [U] 27 Commands to input data
          [R] infile (fixed format); [R] notes; [R] which
On-line:  help for @infiling@, @infile2@, @note@, @which@