Text.Regex.Do.Pcre.ReplaceOpen

extensible and reusable replacement functions

Run replacement with your preferred content types e.g. Data.Text, from search results with non-PCRE regex or non-regex libs

open a bug or a PR on git to request a new Extract' instance

Data.Text instance already works

>>> replace (Just $ toArray [(4,3)]) (Replacement "4567") (Body "abc 123 def"::Body Text)

"abc 4567 def"

GroupReplacer can be used too

Documentation

class ReplaceOpen f r where

Methods

replace :: Extract' a => f MatchArray -> r a -> Body a -> a

Instances

ReplaceOpen [] Replacement

ReplaceOpen [] GroupReplacer

ReplaceOpen Maybe Replacement

ReplaceOpen Maybe GroupReplacer

toArray :: [PosLen] -> MatchArray

class Extract a => Extract' a where

see String, ByteString instances for implementation examples

see Text.Regex.Base.RegexLike for Extract detail

Methods

concat' :: [a] -> a

len' :: a -> Int

Instances

Extract' String

Extract' ByteString

Extract' Text

defaultReplacer

Arguments

:: Extract' a

=> Int

group idx

-> (a -> a)

(group match -> replacement) tweak

-> GroupReplacer a

Replaces specified (by idx) group match with tweaked value. Works for one common simple use case

GroupReplacer can be used with complicated regex

another custom dynamic replacer could e.g. inspect all group matches before looking up a replacement.

getGroup :: Extract a => ReplaceAcc a -> MatchArray -> Int -> Maybe a

get group content safely

see defaultReplacer source for use example

replaceMatch

Arguments

:: Extract' a

=> PosLen

replaceable, unadjusted

-> (a, ReplaceAcc a)

(new val, acc passed to GroupReplacer)

-> ReplaceAcc a

new acc

call from your custom GroupReplacer passed to replaceGroup

see defaultReplacer source for use example