Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

 ◄Key►                                       ◄Up► ◄Contents► ◄Index► ◄Back►
────────────────────────────────────────────────────────────────────────────
 
  Verb:         READ
 
  Function:     Gets a record from a file. In sequential access this
                will be the next or previous record; in random access,
                it will be a specified record.
 
  Syntax:       Which format?  ◄Sequential►    ◄NEXT/PREVIOUS►
                               ◄Relative key►   Record key
 
    ►►─READ file-name-1 RECORD─┬───────────────────┬──►
                               └─INTO identifier-1─┘
 
    ►───┬────────────────────────┬────►
        └─┬────┬─┬────────┬─LOCK─┘
          └WITH┘ ├─KEPT───┤
                 ├─NO─────┤
                 ├─IGNORE─┤
                 └─WAIT───┘
 
    ►─┬─────────────────────────────┬─►
      └─KEY─┬──┬─┬─data-name-1────┬─┘
            └IS┘ └─split-key-name─┘
 
    ►─┬──────────────────────────────────────┬─────────►
      └─INVALID─┬───┬─imperative-statement-1─┘
                └KEY┘
 
    ►─┬──────────────────────────────────────────┬─────►
      └─NOT INVALID─┬───┬─imperative-statement-2─┘
                    └KEY┘
 
    ►─┬──────────┬──►◄
      └─END-READ─┘
                                    -♦-