Text.Regex.PCRE.ByteString.Utils

A module implementing regexp-based split and substitute.

>>> substituteCompile "(a+)" "lapin" "'\\1'"
Right "l'a'pin"

>>> splitCompile "\\d" "a1b2c3"
Right ["a","b","c"]

Perl-like utility functions

substitute

Arguments

:: Regex

The regular expression, taken from a call to compile

-> ByteString

The source string

-> ByteString

The replacement string

-> IO (Either String ByteString)

Substitutes values matched by a Regex. References can be used.

It doesn't support anything else than global substitution for now ..

split

Arguments

:: Regex

The regular expression, taken from a call to compile

-> ByteString

The source string

-> IO (Either String [ByteString])

Splits strings, using a Regex as delimiter.

substituteCompile

Arguments

:: ByteString

The regular expression

-> ByteString

The source string

-> ByteString

The replacement string

-> IO (Either String ByteString)

Compiles the regular expression (using default options) and substitutes

splitCompile

Arguments

:: ByteString

The regular expression

-> ByteString

The source string

-> IO (Either String [ByteString])

Compiles the regular expression (using default options) and splits.

Re-exports from Text.Regex.PCRE.ByteString

data Regex

A compiled regular expression

Instances

RegexLike Regex ByteString

RegexOptions Regex CompOption ExecOption

RegexContext Regex ByteString ByteString

RegexMaker Regex CompOption ExecOption ByteString

data CompOption

Instances

Eq CompOption

Num CompOption

Show CompOption

Bits CompOption

RegexOptions Regex CompOption ExecOption

RegexMaker Regex CompOption ExecOption ByteString

data ExecOption

Instances

Eq ExecOption

Num ExecOption

Show ExecOption

Bits ExecOption

RegexOptions Regex CompOption ExecOption

RegexMaker Regex CompOption ExecOption ByteString

compBlank :: CompOption

execBlank :: ExecOption

Pure version of the functions, using unsafePerformIO

compile' :: CompOption -> ExecOption -> ByteString -> Either (MatchOffset, String) Regex

A pure version of compile, using unsafePerformIO.

execute' :: Regex -> ByteString -> Either WrapError (Maybe (Array Int (MatchOffset, MatchLength)))

A pure version of execute, using unsafePerformIO.

substitute'

Arguments

:: Regex

The regular expression, taken from a call to compile

-> ByteString

The source string

-> ByteString

The replacement string

-> Either String ByteString

A pure version of substitute, using unsafePerformIO.

split'

Arguments

:: Regex

The regular expression, taken from a call to compile

-> ByteString

The source string

-> Either String [ByteString]

A pure version of split, using unsafePerformIO.

substituteCompile'

Arguments

:: ByteString

The regular expression

-> ByteString

The source string

-> ByteString

The replacement string

-> Either String ByteString

A pure version of substituteCompile, using unsafePerformIO.

splitCompile'

Arguments

:: ByteString

The regular expression

-> ByteString

The source string

-> Either String [ByteString]

A pure version of splitCompile, using unsafePerformIO.