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
Usage
import (
"github.com/AspieSoft/go-regex"
)
// pre compile a regex into the cache
// this method also returns the compiled pcre.Regexp struct
regex.Compile(`re`)
// run a replace function (most advanced feature)
regex.RepFunc(myByteArray, `(?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, `re`, myReplacementByteArray)
// return a bool if a regex matches a byte array
regex.Match(myByteArray, `re`)
// split a byte array in a similar way to JavaScript
regex.Split(myByteArray, `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 JoinBytes(bytes ...interface{}) []byte
- func Match(str []byte, re string) bool
- func MatchRef(str *[]byte, re string) bool
- func RepFunc(str []byte, re string, rep func(data func(int) []byte) []byte, blank ...bool) []byte
- func RepFuncFirst(str []byte, re string, rep func(func(int) []byte) []byte, blank ...bool) []byte
- func RepFuncRef(str *[]byte, re string, rep func(data func(int) []byte) []byte, blank ...bool) []byte
- func RepStr(str []byte, re string, rep []byte) []byte
- func RepStrComplex(str []byte, re string, rep []byte) []byte
- func RepStrComplexRef(str *[]byte, re string, rep []byte) []byte
- func RepStrComplexRefRes(str *[]byte, re string, rep *[]byte) []byte
- func RepStrRef(str *[]byte, re string, rep []byte) []byte
- func RepStrRefRes(str *[]byte, re string, rep *[]byte) []byte
- func Split(str []byte, re string) [][]byte
- func SplitRef(str *[]byte, re string) [][]byte
- type Regexp
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AutoInstallLinuxDependencies ¶
func AutoInstallLinuxDependencies()
func JoinBytes ¶
func JoinBytes(bytes ...interface{}) []byte
An easy way to join multiple values into a single []byte accepts: []byte, byte, int32, string, [][]byte, int, int64, float64, float32
func RepFunc ¶
Replace a string with the result of a function similar to JavaScript .replace(/re/, function(data){})
func RepFuncFirst ¶
a copy of the RepFunc method modified to only run once
func RepFuncRef ¶
func RepFuncRef(str *[]byte, re string, rep func(data func(int) []byte) []byte, blank ...bool) []byte
Replace a string with the result of a function similar to JavaScript .replace(/re/, function(data){}) Uses Pointers For Improved Performance
func RepStr ¶
Replace with a string note: this function is optimized for performance, and the replacement string does not accept replacements like $1
func RepStrComplex ¶
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 ¶
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 Uses Pointers For Improved Performance
func RepStrComplexRefRes ¶
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 Uses Pointers For Improved Performance (also on result)
func RepStrRef ¶
Replace with a 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 ¶
Replace with a 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