Catch Namespace Reference

Namespaces
	detail
	Detail
	Generators
	literals
	Matchers

Classes
struct	always_false
class	AssertionHandler
struct	AssertionInfo
struct	AssertionReaction
struct	AutoReg
class	BinaryExpr
class	Capturer
struct	CaseSensitive
struct	Counts
struct	Decomposer
class	ExceptionTranslatorRegistrar
class	ExprLhs
class	GeneratorException
struct	IConfig
struct	IContext
struct	IExceptionTranslator
struct	IExceptionTranslatorRegistry
struct	IGeneratorTracker
struct	IMutableContext
struct	IMutableEnumValuesRegistry
struct	IMutableRegistryHub
struct	IRegistryHub
struct	IResultCapture
struct	IRunner
struct	is_callable
struct	is_callable< Fun(Args...)>
struct	is_callable_tester
struct	is_range
struct	IStream
struct	ITestCaseRegistry
struct	ITestInvoker
struct	ITransientExpression
class	LazyExpression
class	MatchExpr
struct	MessageBuilder
struct	MessageInfo
struct	MessageStream
struct	NameAndTags
class	NonCopyable
class	Option
struct	pluralise
struct	RegistrarForTagAliases
struct	ResultDisposition
struct	ResultWas
class	ReusableStringStream
struct	RunTests
class	ScopedMessage
class	Section
struct	SectionEndInfo
struct	SectionInfo
struct	ShowDurations
class	SimplePcg32
struct	SourceLineInfo
struct	StreamEndStop
struct	StringMaker
struct	StringMaker< bool >
struct	StringMaker< Catch::Detail::Approx >
struct	StringMaker< char * >
struct	StringMaker< char >
struct	StringMaker< char const * >
struct	StringMaker< char[SZ]>
struct	StringMaker< double >
struct	StringMaker< float >
struct	StringMaker< int >
struct	StringMaker< long >
struct	StringMaker< long long >
struct	StringMaker< R C::* >
struct	StringMaker< R, typename std::enable_if< is_range< R >::value &&!::Catch::Detail::IsStreamInsertable< R >::value >::type >
struct	StringMaker< signed char >
struct	StringMaker< signed char[SZ]>
struct	StringMaker< std::nullptr_t >
struct	StringMaker< std::string >
struct	StringMaker< std::wstring >
struct	StringMaker< T * >
struct	StringMaker< T[SZ]>
struct	StringMaker< unsigned char >
struct	StringMaker< unsigned char[SZ]>
struct	StringMaker< unsigned int >
struct	StringMaker< unsigned long >
struct	StringMaker< unsigned long long >
struct	StringMaker< wchar_t * >
struct	StringMaker< wchar_t const * >
class	StringRef
class	TestCase
struct	TestCaseInfo
struct	TestFailureException
class	TestInvokerAsMethod
class	Timer
struct	Totals
struct	true_given
class	UnaryExpr
struct	UseColour
struct	WaitForKeypress
struct	WarnAbout

Typedefs
template<typename Func , typename... U>
using	FunctionReturnType = typename std::remove_reference< typename std::remove_cv< typename std::result_of< Func(U...)>::type >::type >::type
using	IReporterFactoryPtr = std::shared_ptr< IReporterFactory >
using	exceptionTranslateFunction = std::string(*)()
using	ExceptionTranslators = std::vector< std::unique_ptr< IExceptionTranslator const > >
using	StringMatcher = Matchers::Impl::MatcherBase< std::string >
using	IConfigPtr = std::shared_ptr< IConfig const >

Enumerations
enum	Verbosity { Verbosity::Quiet = 0, Verbosity::Normal, Verbosity::High }

Functions
unsigned int	rngSeed ()
std::ostream &	operator<< (std::ostream &os, SourceLineInfo const &info)
template<typename T >
T const &	operator+ (T const &value, StreamEndStop)
bool	isThrowSafe (TestCase const &testCase, IConfig const &config)
bool	matchTest (TestCase const &testCase, TestSpec const &testSpec, IConfig const &config)
std::vector< TestCase >	filterTests (std::vector< TestCase > const &testCases, TestSpec const &testSpec, IConfig const &config)
std::vector< TestCase > const &	getAllTestCasesSorted (IConfig const &config)
auto	operator+= (std::string &lhs, StringRef const &sr) -> std::string &
auto	operator<< (std::ostream &os, StringRef const &sr) -> std::ostream &
constexpr auto	operator""_sr (char const *rawChars, std::size_t size) noexcept -> StringRef
auto	makeTestInvoker (void(*testAsFunction)()) noexcept -> ITestInvoker *
template<typename C >
auto	makeTestInvoker (void(C::*testAsMethod)()) noexcept -> ITestInvoker *
bool	isOk (ResultWas::OfType resultType)
bool	isJustInfo (int flags)
ResultDisposition::Flags	operator| (ResultDisposition::Flags lhs, ResultDisposition::Flags rhs)
bool	shouldContinueOnFailure (int flags)
bool	isFalseTest (int flags)
bool	shouldSuppressFailure (int flags)
std::ostream &	cout ()
std::ostream &	cerr ()
std::ostream &	clog ()
auto	makeStream (StringRef const &filename) -> IStream const *
template<typename Range >
std::string	rangeToString (Range const &range)
template<typename Allocator >
std::string	rangeToString (std::vector< bool, Allocator > const &v)
void	formatReconstructedExpression (std::ostream &os, std::string const &lhs, StringRef op, std::string const &rhs)
template<typename LhsT , typename RhsT >
auto	compareEqual (LhsT const &lhs, RhsT const &rhs) -> bool
template<typename T >
auto	compareEqual (T *const &lhs, int rhs) -> bool
template<typename T >
auto	compareEqual (T *const &lhs, long rhs) -> bool
template<typename T >
auto	compareEqual (int lhs, T *const &rhs) -> bool
template<typename T >
auto	compareEqual (long lhs, T *const &rhs) -> bool
template<typename LhsT , typename RhsT >
auto	compareNotEqual (LhsT const &lhs, RhsT &&rhs) -> bool
template<typename T >
auto	compareNotEqual (T *const &lhs, int rhs) -> bool
template<typename T >
auto	compareNotEqual (T *const &lhs, long rhs) -> bool
template<typename T >
auto	compareNotEqual (int lhs, T *const &rhs) -> bool
template<typename T >
auto	compareNotEqual (long lhs, T *const &rhs) -> bool
void	handleExpression (ITransientExpression const &expr)
template<typename T >
void	handleExpression (ExprLhs< T > const &expr)
IResultCapture &	getResultCapture ()
void	handleExceptionMatchExpr (AssertionHandler &handler, std::string const &str, StringRef const &matcherString)
auto	getCurrentNanosecondsSinceEpoch () -> uint64_t
auto	getEstimatedClockResolution () -> uint64_t
IRegistryHub const &	getRegistryHub ()
IMutableRegistryHub &	getMutableRegistryHub ()
void	cleanUp ()
std::string	translateActiveException ()
bool	startsWith (std::string const &s, std::string const &prefix)
bool	startsWith (std::string const &s, char prefix)
bool	endsWith (std::string const &s, std::string const &suffix)
bool	endsWith (std::string const &s, char suffix)
bool	contains (std::string const &s, std::string const &infix)
void	toLowerInPlace (std::string &s)
std::string	toLower (std::string const &s)
std::string	trim (std::string const &str)
	Returns a new string without whitespace at the start/end. More...
StringRef	trim (StringRef ref)
	Returns a substring of the original ref without whitespace. Beware lifetimes! More...
std::vector< StringRef >	splitStringRef (StringRef str, char delimiter)
bool	replaceInPlace (std::string &str, std::string const &replaceThis, std::string const &withThis)
void	handleExceptionMatchExpr (AssertionHandler &handler, StringMatcher const &matcher, StringRef const &matcherString)
template<typename ArgT , typename MatcherT >
auto	makeMatchExpr (ArgT const &arg, MatcherT const &matcher, StringRef const &matcherString) -> MatchExpr< ArgT, MatcherT >
void	throw_exception (std::exception const &e)
void	throw_logic_error (std::string const &msg)
void	throw_domain_error (std::string const &msg)
void	throw_runtime_error (std::string const &msg)
IMutableContext &	getCurrentMutableContext ()
IContext &	getCurrentContext ()
void	cleanUpContext ()
SimplePcg32 &	rng ()
TestCase	makeTestCase (ITestInvoker *testCase, std::string const &className, NameAndTags const &nameAndTags, SourceLineInfo const &lineInfo)

Typedef Documentation

exceptionTranslateFunction

using Catch::exceptionTranslateFunction = typedef std::string(*)()

ExceptionTranslators

using Catch::ExceptionTranslators = typedef std::vector<std::unique_ptr<IExceptionTranslator const> >

FunctionReturnType

template<typename Func , typename... U>

using Catch::FunctionReturnType = typedef typename std::remove_reference<typename std::remove_cv<typename std::result_of<Func(U...)>::type>::type>::type

IConfigPtr

typedef std::shared_ptr< IConfig const > Catch::IConfigPtr

IReporterFactoryPtr

using Catch::IReporterFactoryPtr = typedef std::shared_ptr<IReporterFactory>

StringMatcher

using Catch::StringMatcher = typedef Matchers::Impl::MatcherBase<std::string>

Enumeration Type Documentation

Verbosity

enum Catch::Verbosity

strong

Enumerator
Quiet
Normal
High

Function Documentation

cerr()

std::ostream& Catch::cerr

(

)

Here is the caller graph for this function:

cleanUp()

void Catch::cleanUp

(

)

cleanUpContext()

void Catch::cleanUpContext

(

)

clog()

std::ostream& Catch::clog

(

)

compareEqual() [1/5]

template<typename T >

auto Catch::compareEqual	(	int	lhs,
		T *const &	rhs
	)		-> bool

compareEqual() [2/5]

template<typename LhsT , typename RhsT >

auto Catch::compareEqual	(	LhsT const &	lhs,
		RhsT const &	rhs
	)		-> bool

Here is the caller graph for this function:

compareEqual() [3/5]

template<typename T >

auto Catch::compareEqual	(	long	lhs,
		T *const &	rhs
	)		-> bool

compareEqual() [4/5]

template<typename T >

auto Catch::compareEqual	(	T *const &	lhs,
		int	rhs
	)		-> bool

compareEqual() [5/5]

template<typename T >

auto Catch::compareEqual	(	T *const &	lhs,
		long	rhs
	)		-> bool

compareNotEqual() [1/5]

template<typename T >

auto Catch::compareNotEqual	(	int	lhs,
		T *const &	rhs
	)		-> bool

compareNotEqual() [2/5]

template<typename LhsT , typename RhsT >

auto Catch::compareNotEqual	(	LhsT const &	lhs,
		RhsT &&	rhs
	)		-> bool

Here is the caller graph for this function:

compareNotEqual() [3/5]

template<typename T >

auto Catch::compareNotEqual	(	long	lhs,
		T *const &	rhs
	)		-> bool

compareNotEqual() [4/5]

template<typename T >

auto Catch::compareNotEqual	(	T *const &	lhs,
		int	rhs
	)		-> bool

compareNotEqual() [5/5]

template<typename T >

auto Catch::compareNotEqual	(	T *const &	lhs,
		long	rhs
	)		-> bool

contains()

bool Catch::contains	(	std::string const &	s,
		std::string const &	infix
	)

cout()

std::ostream& Catch::cout

(

)

Here is the caller graph for this function:

endsWith() [1/2]

bool Catch::endsWith	(	std::string const &	s,
		char	suffix
	)

endsWith() [2/2]

bool Catch::endsWith	(	std::string const &	s,
		std::string const &	suffix
	)

filterTests()

std::vector<TestCase> Catch::filterTests	(	std::vector< TestCase > const &	testCases,
		TestSpec const &	testSpec,
		IConfig const &	config
	)

formatReconstructedExpression()

void Catch::formatReconstructedExpression	(	std::ostream &	os,
		std::string const &	lhs,
		StringRef	op,
		std::string const &	rhs
	)

Here is the caller graph for this function:

getAllTestCasesSorted()

std::vector<TestCase> const& Catch::getAllTestCasesSorted

(

IConfig const &

config

)

getCurrentContext()

IContext& Catch::getCurrentContext ( )

inline

Here is the call graph for this function:

getCurrentMutableContext()

IMutableContext& Catch::getCurrentMutableContext ( )

inline

Here is the call graph for this function:

Here is the caller graph for this function:

getCurrentNanosecondsSinceEpoch()

auto Catch::getCurrentNanosecondsSinceEpoch

(

)

-> uint64_t

getEstimatedClockResolution()

auto Catch::getEstimatedClockResolution

(

)

-> uint64_t

getMutableRegistryHub()

IMutableRegistryHub& Catch::getMutableRegistryHub

(

)

Here is the caller graph for this function:

getRegistryHub()

IRegistryHub const& Catch::getRegistryHub

(

)

getResultCapture()

IResultCapture& Catch::getResultCapture

(

)

handleExceptionMatchExpr() [1/2]

void Catch::handleExceptionMatchExpr	(	AssertionHandler &	handler,
		std::string const &	str,
		StringRef const &	matcherString
	)

handleExceptionMatchExpr() [2/2]

void Catch::handleExceptionMatchExpr	(	AssertionHandler &	handler,
		StringMatcher const &	matcher,
		StringRef const &	matcherString
	)

handleExpression() [1/2]

template<typename T >

void Catch::handleExpression

(

ExprLhs< T > const &

expr

)

Here is the call graph for this function:

handleExpression() [2/2]

void Catch::handleExpression

(

ITransientExpression const &

expr

)

Here is the caller graph for this function:

isFalseTest()

bool Catch::isFalseTest ( int  flags )

inline

isJustInfo()

bool Catch::isJustInfo

(

int

flags

)

isOk()

bool Catch::isOk

(

ResultWas::OfType

resultType

)

isThrowSafe()

bool Catch::isThrowSafe	(	TestCase const &	testCase,
		IConfig const &	config
	)

makeMatchExpr()

template<typename ArgT , typename MatcherT >

auto Catch::makeMatchExpr	(	ArgT const &	arg,
		MatcherT const &	matcher,
		StringRef const &	matcherString
	)		-> MatchExpr<ArgT, MatcherT>

Here is the call graph for this function:

makeStream()

auto Catch::makeStream

(

StringRef const &

filename

)

-> IStream const *

makeTestCase()

TestCase Catch::makeTestCase	(	ITestInvoker *	testCase,
		std::string const &	className,
		NameAndTags const &	nameAndTags,
		SourceLineInfo const &	lineInfo
	)

makeTestInvoker() [1/2]

auto Catch::makeTestInvoker ( void(*)()  testAsFunction ) -> ITestInvoker *

noexcept

makeTestInvoker() [2/2]

template<typename C >

auto Catch::makeTestInvoker ( void(C::*)()  testAsMethod ) -> ITestInvoker*

noexcept

matchTest()

bool Catch::matchTest	(	TestCase const &	testCase,
		TestSpec const &	testSpec,
		IConfig const &	config
	)

operator""_sr()

constexpr auto Catch::operator""_sr ( char const *  rawChars, std::size_t  size  ) -> StringRef

constexprnoexcept

operator+()

template<typename T >

T const& Catch::operator+	(	T const &	value,
		StreamEndStop
	)

Here is the caller graph for this function:

operator+=()

auto Catch::operator+=	(	std::string &	lhs,
		StringRef const &	sr
	)		-> std::string &

Here is the caller graph for this function:

operator<<() [1/2]

std::ostream& Catch::operator<<	(	std::ostream &	os,
		SourceLineInfo const &	info
	)

operator<<() [2/2]

auto Catch::operator<<	(	std::ostream &	os,
		StringRef const &	sr
	)		-> std::ostream &

operator|()

ResultDisposition::Flags Catch::operator|	(	ResultDisposition::Flags	lhs,
		ResultDisposition::Flags	rhs
	)

rangeToString() [1/2]

template<typename Range >

std::string Catch::rangeToString

(

Range const &

range

)

Here is the call graph for this function:

Here is the caller graph for this function:

rangeToString() [2/2]

template<typename Allocator >

std::string Catch::rangeToString

(

std::vector< bool, Allocator > const &

v

)

Here is the call graph for this function:

Here is the caller graph for this function:

replaceInPlace()

bool Catch::replaceInPlace	(	std::string &	str,
		std::string const &	replaceThis,
		std::string const &	withThis
	)

rng()

SimplePcg32& Catch::rng

(

)

rngSeed()

unsigned int Catch::rngSeed

(

)

shouldContinueOnFailure()

bool Catch::shouldContinueOnFailure

(

int

flags

)

shouldSuppressFailure()

bool Catch::shouldSuppressFailure

(

int

flags

)

splitStringRef()

std::vector<StringRef> Catch::splitStringRef	(	StringRef	str,
		char	delimiter
	)

startsWith() [1/2]

bool Catch::startsWith	(	std::string const &	s,
		char	prefix
	)

startsWith() [2/2]

bool Catch::startsWith	(	std::string const &	s,
		std::string const &	prefix
	)

throw_domain_error()

void Catch::throw_domain_error

(

std::string const &

msg

)

throw_exception()

void Catch::throw_exception

(

std::exception const &

e

)

Here is the caller graph for this function:

throw_logic_error()

void Catch::throw_logic_error

(

std::string const &

msg

)

throw_runtime_error()

void Catch::throw_runtime_error

(

std::string const &

msg

)

toLower()

std::string Catch::toLower

(

std::string const &

s

)

toLowerInPlace()

void Catch::toLowerInPlace

(

std::string &

s

)

translateActiveException()

std::string Catch::translateActiveException

(

)

trim() [1/2]

std::string Catch::trim

(

std::string const &

str

)

Returns a new string without whitespace at the start/end.

trim() [2/2]

StringRef Catch::trim

(

StringRef

ref

)

Returns a substring of the original ref without whitespace. Beware lifetimes!