regex-pcre-0.95.0.0: PCRE Backend for "Text.Regex" (regex-base)
Safe HaskellNone
LanguageHaskell2010

Text.Regex.PCRE.String

Description

This exports instances of the high level API and the medium level API of compile,execute, and regexec.

Synopsis

Types

data Regex #

A compiled regular expression

Instances

Instances details
RegexLike Regex String # 
Instance details

Defined in Text.Regex.PCRE.String

RegexLike Regex ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString.Lazy

RegexLike Regex ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString

RegexOptions Regex CompOption ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

RegexContext Regex String String # 
Instance details

Defined in Text.Regex.PCRE.String

Methods

match :: Regex -> String -> String #

matchM :: MonadFail m => Regex -> String -> m String #

RegexContext Regex ByteString ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString.Lazy

RegexContext Regex ByteString ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString

RegexMaker Regex CompOption ExecOption String # 
Instance details

Defined in Text.Regex.PCRE.String

RegexMaker Regex CompOption ExecOption ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString.Lazy

RegexMaker Regex CompOption ExecOption ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString

RegexMaker Regex CompOption ExecOption (Seq Char) # 
Instance details

Defined in Text.Regex.PCRE.Sequence

RegexLike Regex (Seq Char) # 
Instance details

Defined in Text.Regex.PCRE.Sequence

RegexContext Regex (Seq Char) (Seq Char) # 
Instance details

Defined in Text.Regex.PCRE.Sequence

Methods

match :: Regex -> Seq Char -> Seq Char #

matchM :: MonadFail m => Regex -> Seq Char -> m (Seq Char) #

type MatchOffset = Int #

0 based index from start of source, or (-1) for unused

type MatchLength = Int #

non-negative length of a match

newtype CompOption #

Constructors

CompOption CInt 

Instances

Instances details
Eq CompOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Num CompOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Show CompOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Bits CompOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

RegexOptions Regex CompOption ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

RegexMaker Regex CompOption ExecOption String # 
Instance details

Defined in Text.Regex.PCRE.String

RegexMaker Regex CompOption ExecOption ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString.Lazy

RegexMaker Regex CompOption ExecOption ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString

RegexMaker Regex CompOption ExecOption (Seq Char) # 
Instance details

Defined in Text.Regex.PCRE.Sequence

newtype ExecOption #

Constructors

ExecOption CInt 

Instances

Instances details
Eq ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Num ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Show ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Bits ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

RegexOptions Regex CompOption ExecOption # 
Instance details

Defined in Text.Regex.PCRE.Wrap

RegexMaker Regex CompOption ExecOption String # 
Instance details

Defined in Text.Regex.PCRE.String

RegexMaker Regex CompOption ExecOption ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString.Lazy

RegexMaker Regex CompOption ExecOption ByteString # 
Instance details

Defined in Text.Regex.PCRE.ByteString

RegexMaker Regex CompOption ExecOption (Seq Char) # 
Instance details

Defined in Text.Regex.PCRE.Sequence

data ReturnCode #

Instances

Instances details
Eq ReturnCode # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Show ReturnCode # 
Instance details

Defined in Text.Regex.PCRE.Wrap

Miscellaneous

getVersion :: Maybe String #

Version string of PCRE library

NOTE: The Maybe type is used for historic reasons; practically, getVersion is never Nothing.

Medium level API functions

compile #

Arguments

:: CompOption

Flags (summed together)

-> ExecOption

Flags (summed together)

-> String

The regular expression to compile

-> IO (Either (MatchOffset, String) Regex)

Returns: an error string and offset or the compiled regular expression

Compiles a regular expression

execute #

Arguments

:: Regex

Compiled regular expression

-> String

String to match against

-> IO (Either WrapError (Maybe (Array Int (MatchOffset, MatchLength))))

Returns: Nothing if the regex did not match the string, or: Just an array of (offset,length) pairs where index 0 is whole match, and the rest are the captured subexpressions.

Matches a regular expression against a string

regexec #

Arguments

:: Regex

compiled regular expression

-> String

string to match

-> IO (Either WrapError (Maybe (String, String, String, [String])))

Returns: Nothing if no match, else (text before match, text after match, array of matches with 0 being the whole match)

execute match and extract substrings rather than just offsets

Constants for CompOption

Constants for ExecOption

Orphan instances