# go-pcre

[![GoDoc](https://godoc.org/github.com/gijsbers/go-pcre?status.svg=)](https://pkg.go.dev/github.com/scorpionknifes/go-pcre) [![Test](https://github.com/scorpionknifes/go-pcre/actions/workflows/test.yml/badge.svg)](https://github.com/scorpionknifes/go-pcre/actions/workflows/test.yml)

This is a Go language package providing support for Perl Compatible Regular Expressions (PCRE).

This version is created from [go-pcre](https://github.com/rubrikinc/goc-pcre) to allow windows support.

Current version is PCRE 8.45

## Features:

- Support Windows, Linux & MacOS
- Statically build into your application

## Installation

Install the package with the following:

    go get git.company.lan/gopkg/go-pcre

## Usage

Go programs that depend on this package should import this package as follows to allow automatic downloading:

    import "git.company.lan/gopkg/go-pcre"

## History

This is a clone of [go-pcre](https://github.com/rubrikinc/goc-pcre)

This was a clone of [golang-pkg-pcre](http://git.enyo.de/fw/debian/golang-pkg-pcre.git) by Florian Weimer, which has been placed on Github by Glenn Brown, so it can be fetched automatically by Go's package installer.

Glenn Brown added `FindIndex()` and `ReplaceAll()` to mimic functions in Go's default regexp package.

Mathieu Payeur Levallois added `Matcher.ExtractString()`.

Malte Nuhn added `GroupIndices()` to retrieve positions of a matching group.

Chandra Sekar S added `Index()` and stopped invoking `Match()` twice in `FindIndex()`.

Misakwa added support for `pkg-config` to locate `libpcre`.

Yann Ramin added `ReplaceAllString()` and changed `Compile()` return type to `error`.

Nikolay Sivko modified `name2index()` to return error instead of panic.

Harry Waye exposed raw `pcre_exec`.

Hazzadous added partial match support.

Pavel Gryaznov added support for JIT compilation.