Matching the End of Lines with $

Do not think of ^ as an extra letter that must be present in the input. It is an instruction about location: begin checking the rest of the pattern at the beginning of the line.

Programming

A Small Symbol with a Large Effect

When you search text for From:, an unanchored search can find that text anywhere on a line. That may include the beginning, middle, or end of the line. In many filtering tasks, however, location matters: you may want only lines that begin with From:. The caret symbol, ^, makes that requirement explicit by anchoring the pattern to the beginning of a line.

What do you think happens?

Suppose a line contains the text Re: From: support@example.com. Would the pattern ^From: match this line?

Yes, because From: appears somewhere on the line
No, because From: does not appear at the beginning
Only if From: appears twice

Reveal answer

Answer:

No, because From: does not appear at the beginning.

The caret restricts the pattern to the position at the very beginning of a line. Finding From: later in the line is not enough.

The Position Before the First Character

The caret is a zero-width anchor. Zero-width means that it identifies a position without consuming or matching a character from the text. For a line such as From: Alice, the caret refers to the position immediately before the F. The characters From: are then the part of the pattern that must appear starting at that position.

What does the caret match if it consumes no character, and where is that matching position located in a line?

Key point

Do not think of ^ as an extra letter that must be present in the input. It is an instruction about location: begin checking the rest of the pattern at the beginning of the line.

Unanchored and Anchored Searches

Pattern	Allowed location	Result for From: in a line
From:	Anywhere on the line	Matches when From: appears at the beginning, middle, or end
^From:	Beginning of the line	Matches only when the line starts with From:

Adding ^ changes the allowed position of the pattern.

Which lines match when the same text appears at the beginning of a line versus in the middle of a line?

This difference becomes important in multi-line text. An unanchored search examines each line for the requested text wherever it occurs. An anchored search still examines the lines, but it accepts the pattern only when the required text begins at the line's starting position.

Filtering Mailbox Headers

Worked example

Keeping only sender-header lines

A mailbox file contains lines that begin with From:, along with quoted replies and message-body lines that contain From: later in the line. Which pattern should a filter use to select only sender-header lines?

1
Identify the required location
The target text must occur at the very beginning of the line, not merely somewhere in the line.
2
Add the anchor
Place ^ before From: to form ^From:. The anchor restricts the match to the line's beginning.
3
Apply the pattern while examining lines
A regular-expression search such as Python's re.search() can check each line. Only lines matching ^From: should be printed.
4
Reject false matches
A line containing From: in a quoted reply, forwarded message, or message body does not match when From: appears after other characters.

Result

Use ^From: when the filter should keep only lines that begin with From:.

How does adding ^ change which positions in each line a regular expression is allowed to match?

Combining the Anchor with Patterns

The caret is especially valuable when the beginning-of-line rule must be combined with other regular-expression features. For example, ^(From|To): describes lines beginning with either From: or To:. The pattern ^[A-Z]: describes lines beginning with an uppercase letter followed by a colon. These forms show why an anchor can be more flexible than a single fixed-prefix check.

Pattern	Beginning required	What it filters
From:	No	Lines containing From: anywhere
^From:	Yes	Lines beginning with From:
^(From\|To):	Yes	Lines beginning with From: or To:
^[A-Z]:	Yes	Lines beginning with an uppercase letter followed by a colon

The anchor can be combined with alternation and character classes.

Best practice

Use a regular-expression anchor when the location rule is part of the problem, especially when the beginning condition must be combined with alternatives, character classes, or quantifiers. For a simple fixed substring, Python's startswith() method is often clearer and faster.

Mistakes with the Caret

Common mistake
Treating ^ as a character that must appear in the text
What it looks like
Expecting ^From: to match a line containing the literal characters ^From:
Why it fails
The caret is a zero-width anchor. It identifies the beginning position and does not consume a character.
Do this instead
Read ^From: as 'at the beginning of the line, match From:'.
Common mistake
Forgetting the difference between From: and ^From:
What it looks like
Using From: when quoted replies or message-body text must be excluded
Why it fails
Without the anchor, From: can match anywhere on a line.
Do this instead
Use ^From: when only lines beginning with From: should be accepted.
Common mistake
Using a regular expression for a simple fixed-prefix check without considering clarity
What it looks like
Choosing a regular expression only to test whether a string begins with one fixed substring
Why it fails
The source notes that startswith() is often clearer and faster for simple cases.
Do this instead
Prefer startswith() for a simple fixed beginning; use ^ when regular-expression features add value.

Apply the Filter Rule

MEDIUM

A multi-line document contains these lines: From: Dana, Re: From: Dana, To: Lee, and Message mentions From: in the text. Decide which lines match each pattern: From:, ^From:, and ^(From|To):. Then explain which pattern best represents a filter for header lines beginning with From: or To:.

Hints

First decide whether the pattern requires a line beginning.
For an unanchored pattern, check whether the target text appears anywhere in the line.
For an anchored pattern, inspect the characters at the line's beginning.

Your attempt (not saved)

Key point

The key decision is not only what text to search for, but where that text is allowed to occur. Adding ^ turns a general containment search into a beginning-of-line filter.

What to Remember

1
The caret (^) is a zero-width anchor that identifies the beginning of a line.
2
It does not match or consume a visible character.
3
A pattern such as From: can match the text anywhere on a line, while ^From: requires it to begin the line.
4
Anchoring helps eliminate false matches in multi-line filtering tasks such as processing mailbox headers.
5
For simple fixed-prefix checks, startswith() may be clearer and faster, but ^ becomes valuable when combined with other regular-expression features.

At a glance

The caret (^) anchors a regular-expression pattern to the beginning of a line.
Because it is zero-width, ^ matches a position rather than a character.
Adding ^ prevents a pattern from matching the same text later in a line.
Patterns such as ^From:, ^(From|To):, and ^[A-Z]: support precise line filtering.
Use startswith() for simple fixed-prefix checks when a regular expression is unnecessary.

Related concepts

Filtering text with Python regular expressions

More concepts starting with M