Find

Find[stream, "text"] finds the first line in an input stream that contains the specified string.

Find[stream, "", "", ... ] finds the first line that contains any of the specified strings.

Find breaks the input stream into records, delimited by record separators, and scans each record for the strings you specify.

Find returns as a string the first record which contains the specified text.

If Find does not find any record which contains the specified text before it reaches the end of the file, it returns EndOfFile.

The following options can be given:

The first argument to Find can be InputStream["name", n], or simply "name" if there is only one open input stream with the specified name.

You can open a file or pipe to get an InputStream object using OpenRead.

Find does not close streams after it finishes reading from them.

See The Mathematica Book: Section 2.11.9.

See also: Read, Skip, StreamPosition, StringToStream, NotebookFind.