DOCUMENTATION CENTER SEARCH

Mathematica > Low-Level File Operations >

Built-in Mathematica Symbol

Tutorials »|See Also »|More About »

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.

MORE INFORMATION

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 lower and upper case 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.

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":

FindList Read Skip StreamPosition StringToStream NotebookFind StringCases

Searching Files

External Operations

Files

Low-Level File Operations

String Operations

New in 2

© 2008 Wolfram Research, Inc.

Ask a question about this page | Suggest an improvement | Leave a message for the team