The highest tagged major version is
README
¶
Go Regex
A High Performance PCRE Regex Package That Uses A Cache.
Simplifies the the go-pcre regex package. After calling a regex, the compiled output gets cached to improve performance.
This package uses the go-pcre package for better performance.
Installation
sudo apt-get install libpcre3-dev
go get github.com/AspieSoft/go-regex/v3
Usage
import (
"github.com/AspieSoft/go-regex/v3"
)
// pre compile a regex into the cache
// this method also returns the compiled pcre.Regexp struct
regex.Compile(`re`)
// compile a regex and safely escape user input
regex.Compile(`re %1`, `this will be escaped .*`); // output: this will be escaped \.\*
regex.Compile(`re %1`, `hello \n world`); // output: hello \\n world (note: the \ was escaped, and the n is literal)
// use %n to reference a param
// use %{n} for param indexes with more than 1 digit
regex.Compile(`re %1 and %2 ... %{12}`, `param 1`, `param 2` ..., `param 12`);
// manually escape a string
regex.Escape(`(.*)? \$ \\$ \\\$ regex hack failed`)
// run a replace function (most advanced feature)
regex.RepFunc(myByteArray, regex.Compile(`(?flags)re(capture group)`), func(data func(int) []byte) []byte {
data(0) // get the string
data(1) // get the first capture group
return []byte("")
// if the last option is true, returning nil will stop the loop early
return nil
}, true /* optional: if true, will not process a return output */)
// run a simple light replace function
regex.RepStr(myByteArray, regex.Compile(`re`), myReplacementByteArray)
// return a bool if a regex matches a byte array
regex.Match(myByteArray, regex.Compile(`re`))
// split a byte array in a similar way to JavaScript
regex.Split(myByteArray, regex.Compile(`re|(keep this and split like in JavaScript)`))
// a regex string is modified before compiling, to add a few other features
`use \' in place of ` + "`" + ` to make things easier`
`(?#This is a comment in regex)`
// an alias of pcre.Regexp
regex.Regexp
// another helpful function
// this method makes it easier to return results to a regex function
regex.JoinBytes("string", []byte("byte array"), 10, 'c', data(2))
// the above method can be used in place of
append(append(append(append([]byte("string"), []byte("byte array")...), []byte(strconv.Itoa(10))...), 'c'), data(2)...)
Documentation
¶
Index ¶
- func AutoInstallLinuxDependencies()
- func Escape(re string) string
- func JoinBytes(bytes ...interface{}) []byte
- func Match(str []byte, reg *Regexp) bool
- func MatchRef(str *[]byte, reg *Regexp) bool
- func RepFunc(str []byte, reg *Regexp, rep func(data func(int) []byte) []byte, blank ...bool) []byte
- func RepFuncFirst(str []byte, reg *Regexp, rep func(func(int) []byte) []byte, blank ...bool) []byte
- func RepFuncRef(str *[]byte, reg *Regexp, rep func(data func(int) []byte) []byte, ...) []byte
- func RepStr(str []byte, reg *Regexp, rep []byte) []byte
- func RepStrComplex(str []byte, reg *Regexp, rep []byte) []byte
- func RepStrComplexRef(str *[]byte, reg *Regexp, rep []byte) []byte
- func RepStrComplexRefRes(str *[]byte, reg *Regexp, rep *[]byte) []byte
- func RepStrRef(str *[]byte, reg *Regexp, rep []byte) []byte
- func RepStrRefRes(str *[]byte, reg *Regexp, rep *[]byte) []byte
- func Split(str []byte, reg *Regexp) [][]byte
- func SplitRef(str *[]byte, reg *Regexp) [][]byte
- type Regexp
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AutoInstallLinuxDependencies ¶
func AutoInstallLinuxDependencies()
AutoInstallLinuxDependencies will automatically detect and install dependencies if missing from debian or arch linux debian: libpcre3-dev arch: pcre-dev
func JoinBytes ¶
func JoinBytes(bytes ...interface{}) []byte
JoinBytes is an easy way to join multiple values into a single []byte accepts: []byte, byte, int32, string, [][]byte, int, int64, float64, float32
func MatchRef ¶
MatchRef returns true if a string matches a regex Uses Pointers For Improved Performance
func RepFunc ¶
RepFunc replaces a string with the result of a function similar to JavaScript .replace(/re/, function(data){})
func RepFuncFirst ¶
RepFuncFirst is a copy of the RepFunc method modified to only run once
func RepFuncRef ¶
func RepFuncRef(str *[]byte, reg *Regexp, rep func(data func(int) []byte) []byte, blank ...bool) []byte
RepFuncRef replace a string with the result of a function similar to JavaScript .replace(/re/, function(data){}) Uses Pointers For Improved Performance
func RepStr ¶
RepStr replaces a string with another string note: this function is optimized for performance, and the replacement string does not accept replacements like $1
func RepStrComplex ¶
RepStrComplex is a more complex version of the RepStr method this function will replace things in the result like $1 with your capture groups use $0 to use the full regex capture group use ${123} to use numbers with more than one digit
func RepStrComplexRef ¶
RepStrComplexRef is a more complex version of the RepStrRef method this function will replace things in the result like $1 with your capture groups use $0 to use the full regex capture group use ${123} to use numbers with more than one digit Uses Pointers For Improved Performance
func RepStrComplexRefRes ¶
RepStrComplexRefRes is a more complex version of the RepStrRefRes method this function will replace things in the result like $1 with your capture groups use $0 to use the full regex capture group use ${123} to use numbers with more than one digit Uses Pointers For Improved Performance (also on result)
func RepStrRef ¶
RepStrRef replaces a string with another string note: this function is optimized for performance, and the replacement string does not accept replacements like $1 Uses Pointers For Improved Performance
func RepStrRefRes ¶
RepStrRefRes replaces a string with another string note: this function is optimized for performance, and the replacement string does not accept replacements like $1 Uses Pointers For Improved Performance (also on result)
Source Files