testing Namespace Reference

Namespaces
namespace	internal
namespace	internal2
Classes
class	AssertionResult
class	EmptyTestEventListener
class	Environment
class	Message
class	ScopedFakeTestPartResultReporter
class	Test
class	TestCase
class	TestEventListener
class	TestEventListeners
class	TestInfo
class	TestPartResult
class	TestPartResultArray
class	TestPartResultReporterInterface
class	TestProperty
class	TestResult
class	UnitTest
Typedefs
typedef internal::TimeInMillis	TimeInMillis
Functions
Environment *	AddGlobalTestEnvironment (Environment *env)
GTEST_API_ AssertionResult	AssertionFailure ()
GTEST_API_ AssertionResult	AssertionFailure (const Message &msg)
GTEST_API_ AssertionResult	AssertionSuccess ()
GTEST_API_ AssertionResult	DoubleLE (const char *expr1, const char *expr2, double val1, double val2)
GTEST_API_ AssertionResult	FloatLE (const char *expr1, const char *expr2, float val1, float val2)
static internal::String	FormatCountableNoun (int count, const char *singular_form, const char *plural_form)
static internal::String	FormatTestCaseCount (int test_case_count)
static internal::String	FormatTestCount (int test_count)
	GTEST_DECLARE_bool_ (death_test_use_fork)
	GTEST_DECLARE_bool_ (also_run_disabled_tests)
	GTEST_DECLARE_bool_ (break_on_failure)
	GTEST_DECLARE_bool_ (catch_exceptions)
	GTEST_DECLARE_bool_ (list_tests)
	GTEST_DECLARE_bool_ (print_time)
	GTEST_DECLARE_bool_ (show_internal_stack_frames)
	GTEST_DECLARE_bool_ (shuffle)
	GTEST_DECLARE_bool_ (throw_on_failure)
	GTEST_DECLARE_int32_ (random_seed)
	GTEST_DECLARE_int32_ (repeat)
	GTEST_DECLARE_int32_ (stack_trace_depth)
	GTEST_DECLARE_string_ (death_test_style)
	GTEST_DECLARE_string_ (color)
	GTEST_DECLARE_string_ (filter)
	GTEST_DECLARE_string_ (output)
	GTEST_DECLARE_string_ (stream_result_to)
	GTEST_DEFINE_bool_ (death_test_use_fork, internal::BoolFromGTestEnv("death_test_use_fork", false),"Instructs to use fork()/_exit() instead of clone() in death tests. ""Ignored and always uses fork() on POSIX systems where clone() is not ""implemented. Useful when running under valgrind or similar tools if ""those do not support clone(). Valgrind 3.3.1 will just fail if ""it sees an unsupported combination of clone() flags. ""It is not recommended to use this flag w/o valgrind though it will ""work in 99% of the cases. Once valgrind is fixed, this flag will ""most likely be removed.")
	GTEST_DEFINE_bool_ (also_run_disabled_tests, internal::BoolFromGTestEnv("also_run_disabled_tests", false),"Run disabled tests too, in addition to the tests normally being run.")
	GTEST_DEFINE_bool_ (break_on_failure, internal::BoolFromGTestEnv("break_on_failure", false),"True iff a failed assertion should be a debugger break-point.")
	GTEST_DEFINE_bool_ (catch_exceptions, internal::BoolFromGTestEnv("catch_exceptions", true),"True iff "GTEST_NAME_" should catch exceptions and treat them as test failures.")
	GTEST_DEFINE_bool_ (list_tests, false,"List all tests without running them.")
	GTEST_DEFINE_bool_ (print_time, internal::BoolFromGTestEnv("print_time", true),"True iff "GTEST_NAME_" should display elapsed time in text output.")
	GTEST_DEFINE_bool_ (show_internal_stack_frames, false,"True iff "GTEST_NAME_" should include internal stack frames when ""printing test failure stack traces.")
	GTEST_DEFINE_bool_ (shuffle, internal::BoolFromGTestEnv("shuffle", false),"True iff "GTEST_NAME_" should randomize tests' order on every run.")
	GTEST_DEFINE_bool_ (throw_on_failure, internal::BoolFromGTestEnv("throw_on_failure", false),"When this flag is specified, a failed assertion will throw an exception ""if exceptions are enabled or exit the program with a non-zero code ""otherwise.")
	GTEST_DEFINE_int32_ (random_seed, internal::Int32FromGTestEnv("random_seed", 0),"Random number seed to use when shuffling test orders. Must be in range ""[1, 99999], or 0 to use a seed based on the current time.")
	GTEST_DEFINE_int32_ (repeat, internal::Int32FromGTestEnv("repeat", 1),"How many times to repeat each test. Specify a negative number ""for repeating forever. Useful for shaking out flaky tests.")
	GTEST_DEFINE_int32_ (stack_trace_depth, internal::Int32FromGTestEnv("stack_trace_depth", kMaxStackTraceDepth),"The maximum number of stack frames to print when an ""assertion fails. The valid range is 0 through 100, inclusive.")
	GTEST_DEFINE_string_ (death_test_style, internal::StringFromGTestEnv("death_test_style", kDefaultDeathTestStyle),"Indicates how to run a death test in a forked child process: ""\"threadsafe\" (child process re-executes the test binary ""from the beginning, running only the specific death test) or ""\"fast\" (child process runs the death test immediately ""after forking).")
	GTEST_DEFINE_string_ (color, internal::StringFromGTestEnv("color","auto"),"Whether to use colors in the output. Valid values: yes, no, ""and auto. 'auto' means to use colors if the output is ""being sent to a terminal and the TERM environment variable ""is set to xterm, xterm-color, xterm-256color, linux or cygwin.")
	GTEST_DEFINE_string_ (filter, internal::StringFromGTestEnv("filter", kUniversalFilter),"A colon-separated list of glob (not regex) patterns ""for filtering the tests to run, optionally followed by a ""'-' and a : separated list of negative patterns (tests to ""exclude). A test is run if it matches one of the positive ""patterns and does not match any of the negative patterns.")
	GTEST_DEFINE_string_ (output, internal::StringFromGTestEnv("output",""),"A format (currently must be \"xml\"), optionally followed ""by a colon and an output file name or directory. A directory ""is indicated by a trailing pathname separator. ""Examples: \"xml:filename.xml\", \"xml::directoryname/\". ""If a directory is specified, output files will be created ""within that directory, with file-names based on the test ""executable's name and, if necessary, made unique by adding ""digits.")
	GTEST_DEFINE_string_ (stream_result_to, internal::StringFromGTestEnv("stream_result_to",""),"This flag specifies the host name and the port number on which to stream ""test results. Example: \"localhost:555\". The flag is effective only on ""Linux.")
GTEST_API_ void	InitGoogleTest (int *argc, char **argv)
GTEST_API_ void	InitGoogleTest (int *argc, wchar_t **argv)
GTEST_API_ AssertionResult	IsNotSubstring (const char *needle_expr, const char *haystack_expr, const char *needle, const char *haystack)
GTEST_API_ AssertionResult	IsNotSubstring (const char *needle_expr, const char *haystack_expr, const wchar_t *needle, const wchar_t *haystack)
GTEST_API_ AssertionResult	IsNotSubstring (const char *needle_expr, const char *haystack_expr, const ::std::string &needle, const ::std::string &haystack)
GTEST_API_ AssertionResult	IsSubstring (const char *needle_expr, const char *haystack_expr, const char *needle, const char *haystack)
GTEST_API_ AssertionResult	IsSubstring (const char *needle_expr, const char *haystack_expr, const wchar_t *needle, const wchar_t *haystack)
GTEST_API_ AssertionResult	IsSubstring (const char *needle_expr, const char *haystack_expr, const ::std::string &needle, const ::std::string &haystack)
std::ostream &	operator<< (std::ostream &os, const TestPartResult &result)
std::ostream &	operator<< (std::ostream &os, const Message &sb)
static void	PrintTestPartResult (const TestPartResult &test_part_result)
static internal::String	PrintTestPartResultToString (const TestPartResult &test_part_result)
template<typename T >
::std::string	PrintToString (const T &value)
template<typename T1 , typename T2 >
bool	StaticAssertTypeEq ()
static bool	TestPartFatallyFailed (const TestPartResult &result)
static bool	TestPartNonfatallyFailed (const TestPartResult &result)
static const char *	TestPartResultTypeToString (TestPartResult::Type type)
Variables
static const char	kDeathTestCaseFilter [] = "*DeathTest:*DeathTest/*"
static const char	kDefaultDeathTestStyle [] = "fast"
static const char	kDefaultOutputFile [] = "test_detail.xml"
static const char	kDisableTestFilter [] = "DISABLED_*:*/DISABLED_*"
const int	kMaxStackTraceDepth = 100
static const char	kTestShardIndex [] = "GTEST_SHARD_INDEX"
static const char	kTestShardStatusFile [] = "GTEST_SHARD_STATUS_FILE"
static const char	kTestTotalShards [] = "GTEST_TOTAL_SHARDS"
static const char	kUniversalFilter [] = "*"

---

Typedef Documentation

typedef internal::TimeInMillis testing::TimeInMillis

Definition at line 469 of file gtest.h.

---

Function Documentation

Environment* testing::AddGlobalTestEnvironment

(

Environment *

env

)

[inline]

Definition at line 1267 of file gtest.h.

AssertionResult testing::AssertionFailure

(

)

Definition at line 971 of file gtest.cc.

AssertionResult testing::AssertionFailure

(

const Message &

msg

)

Definition at line 977 of file gtest.cc.

AssertionResult testing::AssertionSuccess

(

)

Definition at line 966 of file gtest.cc.

AssertionResult testing::DoubleLE	(	const char *	expr1,
		const char *	expr2,
		double	val1,
		double	val2
	)

Definition at line 1102 of file gtest.cc.

AssertionResult testing::FloatLE	(	const char *	expr1,
		const char *	expr2,
		float	val1,
		float	val2
	)

Definition at line 1095 of file gtest.cc.

static internal::String testing::FormatCountableNoun	(	int	count,
		const char *	singular_form,
		const char *	plural_form
	)		[static]

Definition at line 2479 of file gtest.cc.

static internal::String testing::FormatTestCaseCount

(

int

test_case_count

)

[static]

Definition at line 2492 of file gtest.cc.

static internal::String testing::FormatTestCount

(

int

test_count

)

[static]

Definition at line 2487 of file gtest.cc.

testing::GTEST_DECLARE_bool_

(

death_test_use_fork

)

testing::GTEST_DECLARE_bool_

(

also_run_disabled_tests

)

testing::GTEST_DECLARE_bool_

(

break_on_failure

)

testing::GTEST_DECLARE_bool_

(

catch_exceptions

)

testing::GTEST_DECLARE_bool_

(

list_tests

)

testing::GTEST_DECLARE_bool_

(

print_time

)

testing::GTEST_DECLARE_bool_

(

show_internal_stack_frames

)

testing::GTEST_DECLARE_bool_

(

shuffle

)

testing::GTEST_DECLARE_bool_

(

throw_on_failure

)

testing::GTEST_DECLARE_int32_

(

random_seed

)

testing::GTEST_DECLARE_int32_

(

repeat

)

testing::GTEST_DECLARE_int32_

(

stack_trace_depth

)

testing::GTEST_DECLARE_string_

(

death_test_style

)

testing::GTEST_DECLARE_string_

(

color

)

testing::GTEST_DECLARE_string_

(

filter

)

testing::GTEST_DECLARE_string_

(

output

)

testing::GTEST_DECLARE_string_

(

stream_result_to

)

testing::GTEST_DEFINE_bool_	(	death_test_use_fork	,
		internal::	BoolFromGTestEnv"death_test_use_fork", false,
		"Instructs to use fork()/_exit() instead of clone() in death tests. ""Ignored and always uses fork() on POSIX systems where clone() is not ""implemented. Useful when running under valgrind or similar tools if ""those do not support clone(). Valgrind 3.3.1 will just fail if ""it sees an unsupported combination of clone() flags. ""It is not recommended to use this flag w/o valgrind though it will ""work in 99% of the cases. Once valgrind is	fixed,
		this flag will""most likely be removed."
	)

testing::GTEST_DEFINE_bool_	(	also_run_disabled_tests	,
		internal::	BoolFromGTestEnv"also_run_disabled_tests", false,
		"Run disabled tests	too,
		in addition to the tests normally being run."
	)

testing::GTEST_DEFINE_bool_	(	break_on_failure	,
		internal::	BoolFromGTestEnv"break_on_failure", false,
		"True iff a failed assertion should be a debugger break-point."
	)

testing::GTEST_DEFINE_bool_	(	catch_exceptions	,
		internal::	BoolFromGTestEnv"catch_exceptions", true,
		"True iff "GTEST_NAME_" should catch exceptions and treat them as test failures."
	)

testing::GTEST_DEFINE_bool_	(	list_tests	,
		false	,
		"List all tests without running them."
	)

testing::GTEST_DEFINE_bool_	(	print_time	,
		internal::	BoolFromGTestEnv"print_time", true,
		"True iff "GTEST_NAME_" should display elapsed time in text output."
	)

testing::GTEST_DEFINE_bool_	(	show_internal_stack_frames	,
		false	,
		"True iff "GTEST_NAME_" should include internal stack frames when ""printing test failure stack traces."
	)

testing::GTEST_DEFINE_bool_	(	shuffle	,
		internal::	BoolFromGTestEnv"shuffle", false,
		"True iff "GTEST_NAME_" should randomize tests' order on every run."
	)

testing::GTEST_DEFINE_bool_	(	throw_on_failure	,
		internal::	BoolFromGTestEnv"throw_on_failure", false,
		"When this flag is	specified,
		a failed assertion will throw an exception""if exceptions are enabled or exit the program with a non-zero code""otherwise."
	)

testing::GTEST_DEFINE_int32_	(	random_seed	,
		internal::	Int32FromGTestEnv"random_seed", 0,
		"Random number seed to use when shuffling test orders. Must be in range ""	[1, 99999],
		or 0 to use a seed based on the current time."
	)

testing::GTEST_DEFINE_int32_	(	repeat	,
		internal::	Int32FromGTestEnv"repeat", 1,
		"How many times to repeat each test. Specify a negative number ""for repeating forever. Useful for shaking out flaky tests."
	)

testing::GTEST_DEFINE_int32_	(	stack_trace_depth	,
		internal::	Int32FromGTestEnv"stack_trace_depth", kMaxStackTraceDepth,
		"The maximum number of stack frames to print when an ""assertion fails. The valid range is 0 through	100,
		inclusive."
	)

testing::GTEST_DEFINE_string_	(	death_test_style	,
		internal::	StringFromGTestEnv"death_test_style", kDefaultDeathTestStyle,
		"Indicates how to run a death test in a forked child process: ""\"threadsafe\" (child process re-executes the test binary ""from the beginning, running only the specific death test) or ""\"fast\" (child process runs the death test immediately ""after forking)."
	)

testing::GTEST_DEFINE_string_	(	color	,
		internal::	StringFromGTestEnv"color","auto",
		"Whether to use colors in the output. Valid values:	yes,
		no	,
		""and auto. 'auto'means to use colors if the output is""being sent to a terminal and the TERM environment variable""is set to	xterm,
		xterm-	color,
		xterm-	256color,
		linux or cygwin."
	)

testing::GTEST_DEFINE_string_	(	filter	,
		internal::	StringFromGTestEnv"filter", kUniversalFilter,
		"A colon-separated list of glob (not regex) patterns ""for filtering the tests to	run,
		optionally followed by a""'-'and a:separated list of negative patterns(tests to""exclude).A test is run if it matches one of the positive""patterns and does not match any of the negative patterns."
	)

testing::GTEST_DEFINE_string_	(	output	,
		internal::	StringFromGTestEnv"output","",
		"A format	currently must be \"xml\",
		optionally followed""by a colon and an output file name or directory.A directory""is indicated by a trailing pathname separator.""Examples:\"xml:filename.xml\"	,
		\"xml::directoryname/\". ""If a directory is	specified,
		output files will be created""within that	directory,
		with file-names based on the test""executable's name	and,
		if	necessary,
		made unique by adding""digits."
	)

testing::GTEST_DEFINE_string_	(	stream_result_to	,
		internal::	StringFromGTestEnv"stream_result_to","",
		"This flag specifies the host name and the port number on which to stream ""test results. Example: \"localhost:555\". The flag is effective only on ""Linux."
	)

void testing::InitGoogleTest	(	int *	argc,
		char **	argv
	)

Definition at line 4888 of file gtest.cc.

void testing::InitGoogleTest	(	int *	argc,
		wchar_t **	argv
	)

Definition at line 4894 of file gtest.cc.

AssertionResult testing::IsNotSubstring	(	const char *	needle_expr,
		const char *	haystack_expr,
		const char *	needle,
		const char *	haystack
	)

Definition at line 1292 of file gtest.cc.

AssertionResult testing::IsNotSubstring	(	const char *	needle_expr,
		const char *	haystack_expr,
		const wchar_t *	needle,
		const wchar_t *	haystack
	)

Definition at line 1298 of file gtest.cc.

AssertionResult testing::IsNotSubstring	(	const char *	needle_expr,
		const char *	haystack_expr,
		const ::std::string &	needle,
		const ::std::string &	haystack
	)

Definition at line 1310 of file gtest.cc.

AssertionResult testing::IsSubstring	(	const char *	needle_expr,
		const char *	haystack_expr,
		const char *	needle,
		const char *	haystack
	)

Definition at line 1280 of file gtest.cc.

AssertionResult testing::IsSubstring	(	const char *	needle_expr,
		const char *	haystack_expr,
		const wchar_t *	needle,
		const wchar_t *	haystack
	)

Definition at line 1286 of file gtest.cc.

AssertionResult testing::IsSubstring	(	const char *	needle_expr,
		const char *	haystack_expr,
		const ::std::string &	needle,
		const ::std::string &	haystack
	)

Definition at line 1304 of file gtest.cc.

std::ostream & testing::operator<<	(	std::ostream &	os,
		const TestPartResult &	result
	)

Definition at line 58 of file gtest-test-part.cc.

std::ostream& testing::operator<<	(	std::ostream &	os,
		const Message &	sb
	)		[inline]

Definition at line 224 of file gtest-message.h.

static void testing::PrintTestPartResult

(

const TestPartResult &

test_part_result

)

[static]

Definition at line 2528 of file gtest.cc.

static internal::String testing::PrintTestPartResultToString

(

const TestPartResult &

test_part_result

)

[static]

Definition at line 2518 of file gtest.cc.

template<typename T >

std::string testing::PrintToString

(

const T &

value

)

Definition at line 788 of file gtest-printers.h.

template<typename T1 , typename T2 >

bool testing::StaticAssertTypeEq

(

)

Definition at line 2078 of file gtest.h.

static bool testing::TestPartFatallyFailed

(

const TestPartResult &

result

)

[static]

Definition at line 1862 of file gtest.cc.

static bool testing::TestPartNonfatallyFailed

(

const TestPartResult &

result

)

[static]

Definition at line 1872 of file gtest.cc.

static const char* testing::TestPartResultTypeToString

(

TestPartResult::Type

type

)

[static]

Definition at line 2500 of file gtest.cc.

---

Variable Documentation

const char testing::kDeathTestCaseFilter[] = "*DeathTest:*DeathTest/*" [static]

Definition at line 155 of file gtest.cc.

const char testing::kDefaultDeathTestStyle[] = "fast" [static]

Definition at line 78 of file gtest-death-test.cc.

const char testing::kDefaultOutputFile[] = "test_detail.xml" [static]

Definition at line 161 of file gtest.cc.

const char testing::kDisableTestFilter[] = "DISABLED_*:*/DISABLED_*" [static]

Definition at line 150 of file gtest.cc.

const int testing::kMaxStackTraceDepth = 100

Definition at line 150 of file gtest.h.

const char testing::kTestShardIndex[] = "GTEST_SHARD_INDEX" [static]

Definition at line 164 of file gtest.cc.

const char testing::kTestShardStatusFile[] = "GTEST_SHARD_STATUS_FILE" [static]

Definition at line 168 of file gtest.cc.

const char testing::kTestTotalShards[] = "GTEST_TOTAL_SHARDS" [static]

Definition at line 166 of file gtest.cc.

const char testing::kUniversalFilter[] = "*" [static]

Definition at line 158 of file gtest.cc.