LLVM: llvm::Regex Class Reference (original) (raw)

#include "[llvm/Support/Regex.h](Regex%5F8h%5Fsource.html)"

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

Public Member Functions
LLVM_ABI	Regex ()
LLVM_ABI	Regex (StringRef Regex, RegexFlags Flags=NoFlags)
	Compiles the given regular expression Regex.
LLVM_ABI	Regex (StringRef Regex, unsigned Flags)
	Regex (const Regex &)=delete
Regex &	operator= (Regex regex)
LLVM_ABI	Regex (Regex &&regex)
LLVM_ABI	~Regex ()
LLVM_ABI bool	isValid (std::string &Error) const
	isValid - returns the error encountered during regex compilation, if any.
bool	isValid () const
LLVM_ABI unsigned	getNumMatches () const
	getNumMatches - In a valid regex, return the number of parenthesized matches it contains.
LLVM_ABI bool	match (StringRef String, SmallVectorImpl< StringRef > Matches=nullptr, std::string Error=nullptr) const
	matches - Match the regex against a given String.
LLVM_ABI std::string	sub (StringRef Repl, StringRef String, std::string *Error=nullptr) const
	sub - Return the result of replacing the first match of the regex in String with the Repl string.

Static Public Member Functions
static LLVM_ABI bool	isLiteralERE (StringRef Str)
	If this function returns true, ^Str$ is an extended regular expression that matches Str and only Str.
static LLVM_ABI std::string	escape (StringRef String)
	Turn String into a regex by escaping its special characters.

Definition at line 29 of file Regex.h.

◆ RegexFlags

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 31 of file Regex.h.

Regex::Regex	(	Regex &&	regex	)

std::string Regex::escape ( StringRef String)	static

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).

Definition at line 79 of file Regex.cpp.

bool llvm::Regex::isValid ( ) const	inline

bool Regex::isValid	(	std::string &	Error	)	const

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.
Error	- If non-null, any errors in the matching will be recorded as a non-empty string. If there is no error, it will be an empty string.

This returns true on a successful match.

Definition at line 83 of file Regex.cpp.

Regex & llvm::Regex::operator= ( Regex regex)	inline

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

sub - Return the result of replacing the first match of the regex in String with the Repl string.

Backreferences like "\0" and "\g<1>" 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. If there is no error, it will be an empty string.

Definition at line 137 of file Regex.cpp.

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