llvm::Regex Class Reference

#include <Regex.h>

Public Types
enum	{ NoFlags =0, IgnoreCase =1, Newline =2, BasicRegex =4 }

Public Member Functions
	Regex (StringRef Regex, unsigned Flags=NoFlags)
	Compiles the given regular expression Regex. More...
	~Regex ()
bool	isValid (std::string &Error)
unsigned	getNumMatches () const
bool	match (StringRef String, SmallVectorImpl< StringRef > *Matches=0)
std::string	sub (StringRef Repl, StringRef String, std::string *Error=0)

Static Public Member Functions
static bool	isLiteralERE (StringRef Str)
	If this function returns true, ^Str$ is an extended regular expression that matches Str and only Str. More...

Detailed Description

Definition at line 28 of file Regex.h.

Member Enumeration Documentation

anonymous enum

Enumerator
NoFlags
IgnoreCase	Compile for matching that ignores upper/lower case distinctions.
Newline	Compile for newline-sensitive matching. With this flag '[^' bracket expressions and '.' never match newline. A ^ anchor matches the null string after any newline in the string in addition to its normal function, and the $ anchor matches the null string before any newline in the string in addition to its normal function.
BasicRegex	By default, the POSIX extended regular expression (ERE) syntax is assumed. Pass this flag to turn on basic regular expressions (BRE) instead.

Definition at line 30 of file Regex.h.

Constructor & Destructor Documentation

Regex::Regex	(	StringRef	Regex,
		unsigned	Flags = NoFlags
	)

Compiles the given regular expression Regex.

Definition at line 22 of file Regex.cpp.

References BasicRegex, llvm::StringRef::data(), llvm::StringRef::end(), IgnoreCase, llvm_regcomp(), Newline, llvm_regex::re_endp, REG_EXTENDED, REG_ICASE, REG_NEWLINE, and REG_PEND.

Regex::~Regex

(

)

Definition at line 35 of file Regex.cpp.

References llvm_regfree().

Member Function Documentation

unsigned Regex::getNumMatches

(

)

const

getNumMatches - In a valid regex, return the number of parenthesized matches it contains. The number filled in by match will include this many entries plus one for the whole regex (as element 0).

getNumMatches - In a valid regex, return the number of parenthesized matches it contains.

Definition at line 53 of file Regex.cpp.

References llvm_regex::re_nsub.

bool Regex::isLiteralERE ( StringRef  Str )

static

If this function returns true, ^Str$ is an extended regular expression that matches Str and only Str.

Definition at line 172 of file Regex.cpp.

References llvm::StringRef::find_first_of(), and llvm::StringRef::npos.

bool Regex::isValid

(

std::string &

Error

)

isValid - returns the error encountered during regex compilation, or matching, if any.

Definition at line 40 of file Regex.cpp.

References llvm_regerror().

bool Regex::match	(	StringRef	String,
		SmallVectorImpl< StringRef > *	Matches = 0
	)

matches - Match the regex against a given String.

Parameters

Matches

- If given, on a successful match this will be filled in with references to the matched group expressions (inside String), the first group is always the entire pattern.

This returns true on a successful match.

Definition at line 57 of file Regex.cpp.

References llvm::SmallVectorImpl< T >::clear(), llvm::StringRef::data(), llvm::SmallVectorTemplateCommon< T >::data(), llvm_regexec(), llvm::SmallVectorTemplateBase< T, isPodLike< T >::value >::push_back(), llvm_regex::re_nsub, REG_NOMATCH, REG_STARTEND, llvm::SmallVectorImpl< T >::resize(), and llvm::StringRef::size().

Referenced by llvm::A64SysReg::SysRegMapper::fromString(), llvm::SpecialCaseList::Entry::match(), and sub().

std::string Regex::sub	(	StringRef	Repl,
		StringRef	String,
		std::string *	Error = 0
	)

sub - Return the result of replacing the first match of the regex in String with the Repl string. Backreferences like "\0" in the replacement string are replaced with the appropriate match substring.

Note that the replacement string has backslash escaping performed on it. Invalid backreferences are ignored (replaced by empty strings).

Parameters

Error

If non-null, any errors in the substitution (invalid backreferences, trailing backslashes) will be recorded as a non-empty string.

Definition at line 96 of file Regex.cpp.

References llvm::StringRef::begin(), llvm::SmallVectorTemplateCommon< T >::begin(), llvm::StringRef::empty(), llvm::sys::path::end(), llvm::StringRef::end(), llvm::SmallVectorTemplateCommon< T >::end(), llvm::StringRef::find_first_not_of(), llvm::StringRef::getAsInteger(), match(), llvm::StringRef::size(), llvm::SmallVectorTemplateCommon< T >::size(), llvm::StringRef::slice(), Split(), llvm::StringRef::split(), llvm::StringRef::str(), and llvm::StringRef::substr().

---

The documentation for this class was generated from the following files:

• Regex.h
• Regex.cpp