# Regexp
{% hint style="info" %}
You can easily import all the functions from the `regexp` registry by including the following import statement in your code
```go
import "github.com/go-sprout/sprout/registry/regexp"
```
{% endhint %}
### regexFind
The function returns the first match found in the string that corresponds to the specified regular expression pattern.
Name
Value
Signature
RegexFind(regex string, s string) (string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ "hello world" | regexFind "hello" }} // Output: "hello"
{{ "hello world" | regexFind "\\invalid$^///" }} // Error
```
{% endtab %}
{% endtabs %}
### regexFindAll
The function returns all matches of the regex pattern in the string, up to a specified maximum number of matches (`n`).
Name
Value
Signature
RegexFindAll(regex string, s string, n int) ([]string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ regexFindAll "a." "aba acada afa" 3 }} // Output: [ab a ac]
{{ regexFindAll "\\invalid$^///" "aba acada afa" 3 }} // Error
```
{% endtab %}
{% endtabs %}
### regexMatch
The function checks if the entire string matches the given regular expression pattern.
Name
Value
Signature
RegexMatch(regex string, s string) (bool, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ regexMatch "^[a-zA-Z]+$" "Hello" }} // Output: true
{{ regexMatch "\\invalid$^///" "Hello" }} // Error
```
{% endtab %}
{% endtabs %}
### regexSplit
The function splits the string into substrings based on matches of the regex pattern, performing the split up to `n` times.
Name
Value
Signature
RegexSplit(regex string, s string, n int) ([]string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ regexSplit "\\s+" "hello world from Go" 2 }}
// Output(humain readable): [hello "world from Go"]
{{ regexSplit "\\invalid$^///" "hello world from Go" 2 }} // Error
```
{% endtab %}
{% endtabs %}
### regexReplaceAll
The function replaces all occurrences of the regex pattern in the string with the specified replacement string.
Name
Value
Signature
RegexReplaceAll(regex string, s string, repl string) (string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ regexReplaceAll "\\d" "R2D2 C3PO" "X" }} // Output: "RXDX CXPO"
{{ regexReplaceAll "\\invalid$^///" "R2D2 C3PO" "X" }} // Error
```
{% endtab %}
{% endtabs %}
### regexReplaceAllLiteral
The function replaces all occurrences of the regex pattern in the string with the specified literal replacement string, without interpreting any special characters in the replacement.
Name
Value
Signature
RegexReplaceAllLiteral(regex string, s string, repl string) (string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ regexReplaceAllLiteral "world" "hello world" "$1" }} // Output: "hello $1"
{{ regexReplaceAllLiteral "none" "hello world" "all" }} // Output: "hello world"
{{ regexReplaceAllLiteral "\\invalid$^///" "hello world" "all" }} // Error
```
{% endtab %}
{% endtabs %}
### regexQuoteMeta
The function returns a version of the provided string that can be used as a literal pattern in a regular expression, escaping any special characters.
Name
Value
Signature
RegexQuoteMeta(str string) string
{% tabs %}
{% tab title="Template Example" %}
```go
{{ regexQuoteMeta ".+*?^$()[]{}|" }}
// Output: \\.\\+\\*\\?\\^\\$\\(\\)\\[\\]\\{\\}\\|
```
{% endtab %}
{% endtabs %}
### regexFindGroups
The function finds the first match of a regex pattern in a string and returns the matched groups, with error handling.
{% tabs %}
{% tab title="Template Example" %}
```go
{{ "aaabbb" | regexFindGroups "(a+)(b+)" }} // Output: [aaabbb aaa bbb]
{{ "aaabbb" | regexFindGroups "\\invalid$^///" }} // Error
```
{% endtab %}
{% endtabs %}
### regexFindAllGroups
The function finds all matches of a regex pattern in a string up to a specified limit and returns the matched groups, with error handling.
Name
Value
Signature
RegexFindAllGroups(regex string, n int, str string) ([]string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ "aaabbb aab aaabbb" | regexFindAllGroups "(a+)(b+)" -1 }} // Output: [[aaabbb aaa bbb] [aab aa b] [aaabbb aaa bbb]]
{{ "aaabbb aab aaabbb" | regexFindAllGroups "(a+)(b+)" 1 }} // Output: [[aaabbb aaa bbb]]
{{ "aaabbb" | regexFindAllGroups "\\invalid$^///" }} // Error
```
{% endtab %}
{% endtabs %}
### regexFindNamed
The function finds the first match of a regex pattern with named capturing groups in a string and returns a map of group names to matched strings, with error handling.
{% tabs %}
{% tab title="Template Example" %}
```go
{{ "aaabbb" | regexFindNamed "(?Pa+)(?Pb+)" }} // Output: map[first:aaa second:bbb]
{{ "aaabbb" | regexFindNamed "(?Pa+)(b+)" }} // Output: map[first:aaa]
{{ "bbb" | regexFindNamed "(?Pa+)" }} // Output: map[]
{{ "aaabbb" | regexFindNamed "\\invalid$^///" }} // Error
```
{% endtab %}
{% endtabs %}
### regexFindAllNamed
The function finds all matches of a regex pattern with named capturing groups in a string up to a specified limit and returns a slice of maps of group names to matched strings, with error handling.
Name
Value
Signature
RegexFindAllNamed(regex string, n int, str string) ([]map[string]string, error)
{% tabs %}
{% tab title="Template Example" %}
```go
{{ "var1=value1&var2=value2" | regexFindAllNamed "(?P\\w+)=(?P\\w+)" -1 }} // Output: [map[param:var1 value:value1] map[param:var2 value:value2]]
{{ "var1=value1&var2=value2" | regexFindAllNamed "(?P\\w+)=(?P\\w+)" 1 }} // Output: [map[param:var1 value:value1]]
{{ "var1+value1" | regexFindAllNamed "(?P\\w+)=(?P\\w+)" -1 }} // Output: []
{{ "var1=value1" | regexFindAllNamed "\\invalid$^///" -1 }} // Error
```
{% endtab %}
{% endtabs %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.atom.codes/sprout/registries/regexp.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.