Version: v0.5.0 Latest Latest

This package is not in the latest version of its module.

Go to latest
Published: Apr 12, 2023 License: Apache-2.0 Imports: 4 Imported by: 0



Package regexp implements regular expression search.

The syntax of the regular expressions accepted is the same general syntax used by Perl, Python, and other languages. More precisely, it is the syntax accepted by RE2 and described at, except for \C. For an overview of the syntax, run

go doc regexp/syntax

The regexp implementation provided by this package is guaranteed to run in time linear in the size of the input. (This is a property not guaranteed by most open source implementations of regular expressions.) For more information about this property, see

or any book about automata theory.

All characters are UTF-8-encoded code points.

The regexp package functions match a regular expression and identify the matched text. Their names are matched by this regular expression:


If 'All' is present, the routine matches successive non-overlapping matches of the entire expression. Empty matches abutting a preceding match are ignored. The return value is a slice containing the successive return values of the corresponding non-'All' routine. These routines take an extra integer argument, n. If n >= 0, the function returns at most n matches/submatches; otherwise, it returns all of them.

If 'Submatch' is present, the return value is a slice identifying the successive submatches of the expression. Submatches are matches of parenthesized subexpressions (also known as capturing groups) within the regular expression, numbered from left to right in order of opening parenthesis. Submatch 0 is the match of the entire expression, submatch 1 the match of the first parenthesized subexpression, and so on.



This section is empty.


This section is empty.


func Find added in v0.0.12

func Find(pattern, s string) (string, error)

Find returns a list holding the text of the leftmost match in b of the regular expression. A return value of bottom indicates no match.

func FindAll added in v0.0.12

func FindAll(pattern, s string, n int) ([]string, error)

FindAll is the 'All' version of Find; it returns a list of all successive matches of the expression, as defined by the 'All' description in the package comment. A return value of bottom indicates no match.

func FindAllNamedSubmatch added in v0.0.12

func FindAllNamedSubmatch(pattern, s string, n int) ([]map[string]string, error)

FindAllNamedSubmatch is like FindAllSubmatch, but returns a list of maps with the named used in capturing groups. See FindNamedSubmatch for an example on how to use named groups.

func FindAllSubmatch added in v0.0.12

func FindAllSubmatch(pattern, s string, n int) ([][]string, error)

FindAllSubmatch is the 'All' version of FindSubmatch; it returns a list of all successive matches of the expression, as defined by the 'All' description in the package comment. A return value of bottom indicates no match.

func FindNamedSubmatch added in v0.0.12

func FindNamedSubmatch(pattern, s string) (map[string]string, error)

FindNamedSubmatch is like FindSubmatch, but returns a map with the names used in capturing groups.


regexp.FindNamedSubmatch(#"Hello (?P<person>\w*)!"#, "Hello World!")


[{person: "World"}]

func FindSubmatch added in v0.0.12

func FindSubmatch(pattern, s string) ([]string, error)

FindSubmatch returns a list of lists holding the text of the leftmost match of the regular expression in b and the matches, if any, of its subexpressions, as defined by the 'Submatch' descriptions in the package comment. A return value of bottom indicates no match.

func Match

func Match(pattern string, s string) (matched bool, err error)

Match reports whether the string s contains any match of the regular expression pattern. More complicated queries need to use Compile and the full Regexp interface.

func QuoteMeta

func QuoteMeta(s string) string

QuoteMeta returns a string that escapes all regular expression metacharacters inside the argument text; the returned string is a regular expression matching the literal text.

func ReplaceAll added in v0.4.3

func ReplaceAll(pattern, src, repl string) (string, error)

ReplaceAll returns a copy of src, replacing variables in repl with corresponding matches drawn from src, according to the following rules.

In the template repl, a variable is denoted by a substring of the form $name or ${name}, where name is a non-empty sequence of letters, digits, and underscores. A purely numeric name like $1 refers to the submatch with the corresponding index; other names refer to capturing parentheses named with the (?P<name>...) syntax. A reference to an out of range or unmatched index or a name that is not present in the regular expression is replaced with an empty slice.

In the $name form, name is taken to be as long as possible: $1x is equivalent to ${1x}, not ${1}x, and, $10 is equivalent to ${10}, not ${1}0.

To insert a literal $ in the output, use $$ in the template.

func ReplaceAllLiteral added in v0.4.3

func ReplaceAllLiteral(pattern, src, repl string) (string, error)

ReplaceAllLiteral returns a copy of src, replacing matches of the regexp pattern with the replacement string repl. The replacement repl is substituted directly.

func Valid added in v0.1.0

func Valid(pattern string) (bool, error)

Valid reports whether the given regular expression is valid.


This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL