testing Namespace Reference

Namespaces
	internal
	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)
template<int kSize>
std::vector< std::string >	ArrayAsVector (const char *const (&array)[kSize])
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 std::string	FormatCountableNoun (int count, const char *singular_form, const char *plural_form)
static std::string	FormatTestCaseCount (int test_case_count)
static std::string	FormatTestCount (int test_count)
static std::string	FormatWordList (const std::vector< std::string > &words)
static const char *	GetDefaultFilter ()
static std::vector< std::string >	GetReservedAttributesForElement (const std::string &xml_element)
	GTEST_DECLARE_bool_ (also_run_disabled_tests)
	GTEST_DECLARE_bool_ (break_on_failure)
	GTEST_DECLARE_bool_ (catch_exceptions)
	GTEST_DECLARE_bool_ (death_test_use_fork)
	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_ (color)
	GTEST_DECLARE_string_ (death_test_style)
	GTEST_DECLARE_string_ (filter)
	GTEST_DECLARE_string_ (output)
	GTEST_DECLARE_string_ (stream_result_to)
	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_ (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_ (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_ (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 a terminal type that supports colors.")
	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_ (filter, internal::StringFromGTestEnv("filter", GetDefaultFilter()), "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 ::std::string &needle, const ::std::string &haystack)
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	IsSubstring (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)
std::ostream &	operator<< (std::ostream &os, const Message &sb)
std::ostream &	operator<< (std::ostream &os, const TestPartResult &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)
bool	ValidateTestPropertyName (const std::string &property_name, const std::vector< std::string > &reserved_names)

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 *const	kReservedTestCaseAttributes []
static const char *const	kReservedTestSuiteAttributes []
static const char *const	kReservedTestSuitesAttributes []
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

TimeInMillis

typedef internal::TimeInMillis testing::TimeInMillis

Definition at line 457 of file gtest.h.

Function Documentation

AddGlobalTestEnvironment()

Environment* testing::AddGlobalTestEnvironment ( Environment *  env )

inline

Definition at line 1318 of file gtest.h.

ArrayAsVector()

template<int kSize>

std::vector<std::string> testing::ArrayAsVector

(

const char *const (&)

array[kSize]

)

Definition at line 1788 of file gtest.cc.

AssertionFailure() [1/2]

AssertionResult testing::AssertionFailure

(

)

Definition at line 976 of file gtest.cc.

AssertionFailure() [2/2]

AssertionResult testing::AssertionFailure

(

const Message &

msg

)

Definition at line 982 of file gtest.cc.

AssertionSuccess()

AssertionResult testing::AssertionSuccess

(

)

Definition at line 971 of file gtest.cc.

DoubleLE()

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

Definition at line 1108 of file gtest.cc.

FloatLE()

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

Definition at line 1101 of file gtest.cc.

FormatCountableNoun()

static std::string testing::FormatCountableNoun ( int  count, const char *  singular_form, const char *  plural_form  )

static

Definition at line 2482 of file gtest.cc.

FormatTestCaseCount()

static std::string testing::FormatTestCaseCount ( int  test_case_count )

static

Definition at line 2495 of file gtest.cc.

FormatTestCount()

static std::string testing::FormatTestCount ( int  test_count )

static

Definition at line 2490 of file gtest.cc.

FormatWordList()

static std::string testing::FormatWordList ( const std::vector< std::string > &  words )

static

Definition at line 1807 of file gtest.cc.

GetDefaultFilter()

static const char* testing::GetDefaultFilter ( )

static

Definition at line 188 of file gtest.cc.

GetReservedAttributesForElement()

static std::vector<std::string> testing::GetReservedAttributesForElement ( const std::string &  xml_element )

static

Definition at line 1792 of file gtest.cc.

GTEST_DECLARE_bool_() [1/9]

testing::GTEST_DECLARE_bool_

(

also_run_disabled_tests

)

GTEST_DECLARE_bool_() [2/9]

testing::GTEST_DECLARE_bool_

(

break_on_failure

)

GTEST_DECLARE_bool_() [3/9]

testing::GTEST_DECLARE_bool_

(

catch_exceptions

)

GTEST_DECLARE_bool_() [4/9]

testing::GTEST_DECLARE_bool_

(

death_test_use_fork

)

GTEST_DECLARE_bool_() [5/9]

testing::GTEST_DECLARE_bool_

(

list_tests

)

GTEST_DECLARE_bool_() [6/9]

testing::GTEST_DECLARE_bool_

(

print_time

)

GTEST_DECLARE_bool_() [7/9]

testing::GTEST_DECLARE_bool_

(

show_internal_stack_frames

)

GTEST_DECLARE_bool_() [8/9]

testing::GTEST_DECLARE_bool_

(

shuffle

)

GTEST_DECLARE_bool_() [9/9]

testing::GTEST_DECLARE_bool_

(

throw_on_failure

)

GTEST_DECLARE_int32_() [1/3]

testing::GTEST_DECLARE_int32_

(

random_seed

)

GTEST_DECLARE_int32_() [2/3]

testing::GTEST_DECLARE_int32_

(

repeat

)

GTEST_DECLARE_int32_() [3/3]

testing::GTEST_DECLARE_int32_

(

stack_trace_depth

)

GTEST_DECLARE_string_() [1/5]

testing::GTEST_DECLARE_string_

(

color

)

GTEST_DECLARE_string_() [2/5]

testing::GTEST_DECLARE_string_

(

death_test_style

)

GTEST_DECLARE_string_() [3/5]

testing::GTEST_DECLARE_string_

(

filter

)

GTEST_DECLARE_string_() [4/5]

testing::GTEST_DECLARE_string_

(

output

)

GTEST_DECLARE_string_() [5/5]

testing::GTEST_DECLARE_string_

(

stream_result_to

)

GTEST_DEFINE_bool_() [1/9]

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

GTEST_DEFINE_bool_() [2/9]

testing::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_() [3/9]

testing::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_() [4/9]

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

GTEST_DEFINE_bool_() [5/9]

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

GTEST_DEFINE_bool_() [6/9]

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

GTEST_DEFINE_bool_() [7/9]

testing::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_() [8/9]

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

GTEST_DEFINE_bool_() [9/9]

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

GTEST_DEFINE_int32_() [1/3]

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

GTEST_DEFINE_int32_() [2/3]

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

GTEST_DEFINE_int32_() [3/3]

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

GTEST_DEFINE_string_() [1/5]

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 a terminal type that supports colors."
	)

GTEST_DEFINE_string_() [2/5]

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

GTEST_DEFINE_string_() [3/5]

testing::GTEST_DEFINE_string_	(	filter	,
		internal::StringFromGTestEnv("filter", GetDefaultFilter())	,
		"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_() [4/5]

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

GTEST_DEFINE_string_() [5/5]

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

InitGoogleTest() [1/2]

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

Definition at line 5008 of file gtest.cc.

InitGoogleTest() [2/2]

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

Definition at line 5014 of file gtest.cc.

IsNotSubstring() [1/3]

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

Definition at line 1316 of file gtest.cc.

IsNotSubstring() [2/3]

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

Definition at line 1298 of file gtest.cc.

IsNotSubstring() [3/3]

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

Definition at line 1304 of file gtest.cc.

IsSubstring() [1/3]

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

Definition at line 1310 of file gtest.cc.

IsSubstring() [2/3]

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

Definition at line 1286 of file gtest.cc.

IsSubstring() [3/3]

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

Definition at line 1292 of file gtest.cc.

operator<<() [1/2]

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

inline

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

operator<<() [2/2]

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

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

PrintToString()

template<typename T >

::std::string testing::PrintToString

(

const T &

value

)

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

StaticAssertTypeEq()

template<typename T1 , typename T2 >

bool testing::StaticAssertTypeEq

(

)

Definition at line 2205 of file gtest.h.

TestPartFatallyFailed()

static bool testing::TestPartFatallyFailed ( const TestPartResult &  result )

static

Definition at line 1859 of file gtest.cc.

TestPartNonfatallyFailed()

static bool testing::TestPartNonfatallyFailed ( const TestPartResult &  result )

static

Definition at line 1869 of file gtest.cc.

TestPartResultTypeToString()

static const char* testing::TestPartResultTypeToString ( TestPartResult::Type  type )

static

Definition at line 2503 of file gtest.cc.

ValidateTestPropertyName()

bool testing::ValidateTestPropertyName	(	const std::string &	property_name,
		const std::vector< std::string > &	reserved_names
	)

Definition at line 1821 of file gtest.cc.

Variable Documentation

kDeathTestCaseFilter

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

static

Definition at line 161 of file gtest.cc.

kDefaultDeathTestStyle

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

static

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

kDefaultOutputFile

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

static

Definition at line 167 of file gtest.cc.

kDisableTestFilter

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

static

Definition at line 156 of file gtest.cc.

kMaxStackTraceDepth

const int testing::kMaxStackTraceDepth = 100

Definition at line 147 of file gtest.h.

kReservedTestCaseAttributes

const char* const testing::kReservedTestCaseAttributes[]

static

Initial value:

= {
  "classname",
  "name",
  "status",
  "time",
  "type_param",
  "value_param"
}

Definition at line 1778 of file gtest.cc.

kReservedTestSuiteAttributes

const char* const testing::kReservedTestSuiteAttributes[]

static

Initial value:

= {
  "disabled",
  "errors",
  "failures",
  "name",
  "tests",
  "time"
}

Definition at line 1768 of file gtest.cc.

kReservedTestSuitesAttributes

const char* const testing::kReservedTestSuitesAttributes[]

static

Initial value:

= {
  "disabled",
  "errors",
  "failures",
  "name",
  "random_seed",
  "tests",
  "time",
  "timestamp"
}

Definition at line 1755 of file gtest.cc.

kTestShardIndex

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

static

Definition at line 170 of file gtest.cc.

kTestShardStatusFile

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

static

Definition at line 174 of file gtest.cc.

kTestTotalShards

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

static

Definition at line 172 of file gtest.cc.

kUniversalFilter

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

static

Definition at line 164 of file gtest.cc.