Enable JavaScript to interact with content and submit forms on Wolfram websites. Learn how

Wolfram Language & System Documentation Center

Find

Find

Find[stream,"text"]

finds the first line in an input stream that contains the specified string.

Find[stream,{"text₁","text₂",…}]

finds the first line that contains any of the specified strings.

Details and Options

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:

	AnchoredSearch	False	whether to require that the text searched for be at the beginning of a record
	IgnoreCase	False	whether to treat lowercase and uppercase letters as equivalent
	RecordSeparators	{"\r\n", "\n","\r"}	separators for records
	WordSearch	False	whether to require that the text searched for appear as a word
	WordSeparators	{" ","∖t"}	separators for words

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.

Examples

Basic Examples (2)

Open a stream:

Get the first line that contains "electors":

Find the next line that contains "electors":

Open a stream:

Find the first line that contains "electors" or "people":

Top