1 // Copyright 2007, Google Inc. 2 // All rights reserved. 3 // 4 // Redistribution and use in source and binary forms, with or without 5 // modification, are permitted provided that the following conditions are 6 // met: 7 // 8 // * Redistributions of source code must retain the above copyright 9 // notice, this list of conditions and the following disclaimer. 10 // * Redistributions in binary form must reproduce the above 11 // copyright notice, this list of conditions and the following disclaimer 12 // in the documentation and/or other materials provided with the 13 // distribution. 14 // * Neither the name of Google Inc. nor the names of its 15 // contributors may be used to endorse or promote products derived from 16 // this software without specific prior written permission. 17 // 18 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 30 // Google Mock - a framework for writing C++ mock classes. 31 // 32 // This file tests some commonly used argument matchers. 33 34 #include <functional> 35 #include <memory> 36 #include <string> 37 #include <tuple> 38 #include <vector> 39 40 #include "test/gmock-matchers_test.h" 41 42 // Silence warning C4244: 'initializing': conversion from 'int' to 'short', 43 // possible loss of data and C4100, unreferenced local parameter 44 GTEST_DISABLE_MSC_WARNINGS_PUSH_(4244 4100) 45 46 47 namespace testing { 48 namespace gmock_matchers_test { 49 namespace { 50 51 INSTANTIATE_GTEST_MATCHER_TEST_P(MonotonicMatcherTest); 52 53 TEST_P(MonotonicMatcherTestP, IsPrintable) { 54 stringstream ss; 55 ss << GreaterThan(5); 56 EXPECT_EQ("is > 5", ss.str()); 57 } 58 59 TEST(MatchResultListenerTest, StreamingWorks) { 60 StringMatchResultListener listener; 61 listener << "hi" << 5; 62 EXPECT_EQ("hi5", listener.str()); 63 64 listener.Clear(); 65 EXPECT_EQ("", listener.str()); 66 67 listener << 42; 68 EXPECT_EQ("42", listener.str()); 69 70 // Streaming shouldn't crash when the underlying ostream is NULL. 71 DummyMatchResultListener dummy; 72 dummy << "hi" << 5; 73 } 74 75 TEST(MatchResultListenerTest, CanAccessUnderlyingStream) { 76 EXPECT_TRUE(DummyMatchResultListener().stream() == nullptr); 77 EXPECT_TRUE(StreamMatchResultListener(nullptr).stream() == nullptr); 78 79 EXPECT_EQ(&std::cout, StreamMatchResultListener(&std::cout).stream()); 80 } 81 82 TEST(MatchResultListenerTest, IsInterestedWorks) { 83 EXPECT_TRUE(StringMatchResultListener().IsInterested()); 84 EXPECT_TRUE(StreamMatchResultListener(&std::cout).IsInterested()); 85 86 EXPECT_FALSE(DummyMatchResultListener().IsInterested()); 87 EXPECT_FALSE(StreamMatchResultListener(nullptr).IsInterested()); 88 } 89 90 // Makes sure that the MatcherInterface<T> interface doesn't 91 // change. 92 class EvenMatcherImpl : public MatcherInterface<int> { 93 public: 94 bool MatchAndExplain(int x, 95 MatchResultListener* /* listener */) const override { 96 return x % 2 == 0; 97 } 98 99 void DescribeTo(ostream* os) const override { *os << "is an even number"; } 100 101 // We deliberately don't define DescribeNegationTo() and 102 // ExplainMatchResultTo() here, to make sure the definition of these 103 // two methods is optional. 104 }; 105 106 // Makes sure that the MatcherInterface API doesn't change. 107 TEST(MatcherInterfaceTest, CanBeImplementedUsingPublishedAPI) { 108 EvenMatcherImpl m; 109 } 110 111 // Tests implementing a monomorphic matcher using MatchAndExplain(). 112 113 class NewEvenMatcherImpl : public MatcherInterface<int> { 114 public: 115 bool MatchAndExplain(int x, MatchResultListener* listener) const override { 116 const bool match = x % 2 == 0; 117 // Verifies that we can stream to a listener directly. 118 *listener << "value % " << 2; 119 if (listener->stream() != nullptr) { 120 // Verifies that we can stream to a listener's underlying stream 121 // too. 122 *listener->stream() << " == " << (x % 2); 123 } 124 return match; 125 } 126 127 void DescribeTo(ostream* os) const override { *os << "is an even number"; } 128 }; 129 130 TEST(MatcherInterfaceTest, CanBeImplementedUsingNewAPI) { 131 Matcher<int> m = MakeMatcher(new NewEvenMatcherImpl); 132 EXPECT_TRUE(m.Matches(2)); 133 EXPECT_FALSE(m.Matches(3)); 134 EXPECT_EQ("value % 2 == 0", Explain(m, 2)); 135 EXPECT_EQ("value % 2 == 1", Explain(m, 3)); 136 } 137 138 INSTANTIATE_GTEST_MATCHER_TEST_P(MatcherTest); 139 140 // Tests default-constructing a matcher. 141 TEST(MatcherTest, CanBeDefaultConstructed) { Matcher<double> m; } 142 143 // Tests that Matcher<T> can be constructed from a MatcherInterface<T>*. 144 TEST(MatcherTest, CanBeConstructedFromMatcherInterface) { 145 const MatcherInterface<int>* impl = new EvenMatcherImpl; 146 Matcher<int> m(impl); 147 EXPECT_TRUE(m.Matches(4)); 148 EXPECT_FALSE(m.Matches(5)); 149 } 150 151 // Tests that value can be used in place of Eq(value). 152 TEST(MatcherTest, CanBeImplicitlyConstructedFromValue) { 153 Matcher<int> m1 = 5; 154 EXPECT_TRUE(m1.Matches(5)); 155 EXPECT_FALSE(m1.Matches(6)); 156 } 157 158 // Tests that NULL can be used in place of Eq(NULL). 159 TEST(MatcherTest, CanBeImplicitlyConstructedFromNULL) { 160 Matcher<int*> m1 = nullptr; 161 EXPECT_TRUE(m1.Matches(nullptr)); 162 int n = 0; 163 EXPECT_FALSE(m1.Matches(&n)); 164 } 165 166 // Tests that matchers can be constructed from a variable that is not properly 167 // defined. This should be illegal, but many users rely on this accidentally. 168 struct Undefined { 169 virtual ~Undefined() = 0; 170 static const int kInt = 1; 171 }; 172 173 TEST(MatcherTest, CanBeConstructedFromUndefinedVariable) { 174 Matcher<int> m1 = Undefined::kInt; 175 EXPECT_TRUE(m1.Matches(1)); 176 EXPECT_FALSE(m1.Matches(2)); 177 } 178 179 // Test that a matcher parameterized with an abstract class compiles. 180 TEST(MatcherTest, CanAcceptAbstractClass) { Matcher<const Undefined&> m = _; } 181 182 // Tests that matchers are copyable. 183 TEST(MatcherTest, IsCopyable) { 184 // Tests the copy constructor. 185 Matcher<bool> m1 = Eq(false); 186 EXPECT_TRUE(m1.Matches(false)); 187 EXPECT_FALSE(m1.Matches(true)); 188 189 // Tests the assignment operator. 190 m1 = Eq(true); 191 EXPECT_TRUE(m1.Matches(true)); 192 EXPECT_FALSE(m1.Matches(false)); 193 } 194 195 // Tests that Matcher<T>::DescribeTo() calls 196 // MatcherInterface<T>::DescribeTo(). 197 TEST(MatcherTest, CanDescribeItself) { 198 EXPECT_EQ("is an even number", Describe(Matcher<int>(new EvenMatcherImpl))); 199 } 200 201 // Tests Matcher<T>::MatchAndExplain(). 202 TEST_P(MatcherTestP, MatchAndExplain) { 203 Matcher<int> m = GreaterThan(0); 204 StringMatchResultListener listener1; 205 EXPECT_TRUE(m.MatchAndExplain(42, &listener1)); 206 EXPECT_EQ("which is 42 more than 0", listener1.str()); 207 208 StringMatchResultListener listener2; 209 EXPECT_FALSE(m.MatchAndExplain(-9, &listener2)); 210 EXPECT_EQ("which is 9 less than 0", listener2.str()); 211 } 212 213 // Tests that a C-string literal can be implicitly converted to a 214 // Matcher<std::string> or Matcher<const std::string&>. 215 TEST(StringMatcherTest, CanBeImplicitlyConstructedFromCStringLiteral) { 216 Matcher<std::string> m1 = "hi"; 217 EXPECT_TRUE(m1.Matches("hi")); 218 EXPECT_FALSE(m1.Matches("hello")); 219 220 Matcher<const std::string&> m2 = "hi"; 221 EXPECT_TRUE(m2.Matches("hi")); 222 EXPECT_FALSE(m2.Matches("hello")); 223 } 224 225 // Tests that a string object can be implicitly converted to a 226 // Matcher<std::string> or Matcher<const std::string&>. 227 TEST(StringMatcherTest, CanBeImplicitlyConstructedFromString) { 228 Matcher<std::string> m1 = std::string("hi"); 229 EXPECT_TRUE(m1.Matches("hi")); 230 EXPECT_FALSE(m1.Matches("hello")); 231 232 Matcher<const std::string&> m2 = std::string("hi"); 233 EXPECT_TRUE(m2.Matches("hi")); 234 EXPECT_FALSE(m2.Matches("hello")); 235 } 236 237 #if GTEST_INTERNAL_HAS_STRING_VIEW 238 // Tests that a C-string literal can be implicitly converted to a 239 // Matcher<StringView> or Matcher<const StringView&>. 240 TEST(StringViewMatcherTest, CanBeImplicitlyConstructedFromCStringLiteral) { 241 Matcher<internal::StringView> m1 = "cats"; 242 EXPECT_TRUE(m1.Matches("cats")); 243 EXPECT_FALSE(m1.Matches("dogs")); 244 245 Matcher<const internal::StringView&> m2 = "cats"; 246 EXPECT_TRUE(m2.Matches("cats")); 247 EXPECT_FALSE(m2.Matches("dogs")); 248 } 249 250 // Tests that a std::string object can be implicitly converted to a 251 // Matcher<StringView> or Matcher<const StringView&>. 252 TEST(StringViewMatcherTest, CanBeImplicitlyConstructedFromString) { 253 Matcher<internal::StringView> m1 = std::string("cats"); 254 EXPECT_TRUE(m1.Matches("cats")); 255 EXPECT_FALSE(m1.Matches("dogs")); 256 257 Matcher<const internal::StringView&> m2 = std::string("cats"); 258 EXPECT_TRUE(m2.Matches("cats")); 259 EXPECT_FALSE(m2.Matches("dogs")); 260 } 261 262 // Tests that a StringView object can be implicitly converted to a 263 // Matcher<StringView> or Matcher<const StringView&>. 264 TEST(StringViewMatcherTest, CanBeImplicitlyConstructedFromStringView) { 265 Matcher<internal::StringView> m1 = internal::StringView("cats"); 266 EXPECT_TRUE(m1.Matches("cats")); 267 EXPECT_FALSE(m1.Matches("dogs")); 268 269 Matcher<const internal::StringView&> m2 = internal::StringView("cats"); 270 EXPECT_TRUE(m2.Matches("cats")); 271 EXPECT_FALSE(m2.Matches("dogs")); 272 } 273 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 274 275 // Tests that a std::reference_wrapper<std::string> object can be implicitly 276 // converted to a Matcher<std::string> or Matcher<const std::string&> via Eq(). 277 TEST(StringMatcherTest, 278 CanBeImplicitlyConstructedFromEqReferenceWrapperString) { 279 std::string value = "cats"; 280 Matcher<std::string> m1 = Eq(std::ref(value)); 281 EXPECT_TRUE(m1.Matches("cats")); 282 EXPECT_FALSE(m1.Matches("dogs")); 283 284 Matcher<const std::string&> m2 = Eq(std::ref(value)); 285 EXPECT_TRUE(m2.Matches("cats")); 286 EXPECT_FALSE(m2.Matches("dogs")); 287 } 288 289 // Tests that MakeMatcher() constructs a Matcher<T> from a 290 // MatcherInterface* without requiring the user to explicitly 291 // write the type. 292 TEST(MakeMatcherTest, ConstructsMatcherFromMatcherInterface) { 293 const MatcherInterface<int>* dummy_impl = new EvenMatcherImpl; 294 Matcher<int> m = MakeMatcher(dummy_impl); 295 } 296 297 // Tests that MakePolymorphicMatcher() can construct a polymorphic 298 // matcher from its implementation using the old API. 299 const int g_bar = 1; 300 class ReferencesBarOrIsZeroImpl { 301 public: 302 template <typename T> 303 bool MatchAndExplain(const T& x, MatchResultListener* /* listener */) const { 304 const void* p = &x; 305 return p == &g_bar || x == 0; 306 } 307 308 void DescribeTo(ostream* os) const { *os << "g_bar or zero"; } 309 310 void DescribeNegationTo(ostream* os) const { 311 *os << "doesn't reference g_bar and is not zero"; 312 } 313 }; 314 315 // This function verifies that MakePolymorphicMatcher() returns a 316 // PolymorphicMatcher<T> where T is the argument's type. 317 PolymorphicMatcher<ReferencesBarOrIsZeroImpl> ReferencesBarOrIsZero() { 318 return MakePolymorphicMatcher(ReferencesBarOrIsZeroImpl()); 319 } 320 321 TEST(MakePolymorphicMatcherTest, ConstructsMatcherUsingOldAPI) { 322 // Using a polymorphic matcher to match a reference type. 323 Matcher<const int&> m1 = ReferencesBarOrIsZero(); 324 EXPECT_TRUE(m1.Matches(0)); 325 // Verifies that the identity of a by-reference argument is preserved. 326 EXPECT_TRUE(m1.Matches(g_bar)); 327 EXPECT_FALSE(m1.Matches(1)); 328 EXPECT_EQ("g_bar or zero", Describe(m1)); 329 330 // Using a polymorphic matcher to match a value type. 331 Matcher<double> m2 = ReferencesBarOrIsZero(); 332 EXPECT_TRUE(m2.Matches(0.0)); 333 EXPECT_FALSE(m2.Matches(0.1)); 334 EXPECT_EQ("g_bar or zero", Describe(m2)); 335 } 336 337 // Tests implementing a polymorphic matcher using MatchAndExplain(). 338 339 class PolymorphicIsEvenImpl { 340 public: 341 void DescribeTo(ostream* os) const { *os << "is even"; } 342 343 void DescribeNegationTo(ostream* os) const { *os << "is odd"; } 344 345 template <typename T> 346 bool MatchAndExplain(const T& x, MatchResultListener* listener) const { 347 // Verifies that we can stream to the listener directly. 348 *listener << "% " << 2; 349 if (listener->stream() != nullptr) { 350 // Verifies that we can stream to the listener's underlying stream 351 // too. 352 *listener->stream() << " == " << (x % 2); 353 } 354 return (x % 2) == 0; 355 } 356 }; 357 358 PolymorphicMatcher<PolymorphicIsEvenImpl> PolymorphicIsEven() { 359 return MakePolymorphicMatcher(PolymorphicIsEvenImpl()); 360 } 361 362 TEST(MakePolymorphicMatcherTest, ConstructsMatcherUsingNewAPI) { 363 // Using PolymorphicIsEven() as a Matcher<int>. 364 const Matcher<int> m1 = PolymorphicIsEven(); 365 EXPECT_TRUE(m1.Matches(42)); 366 EXPECT_FALSE(m1.Matches(43)); 367 EXPECT_EQ("is even", Describe(m1)); 368 369 const Matcher<int> not_m1 = Not(m1); 370 EXPECT_EQ("is odd", Describe(not_m1)); 371 372 EXPECT_EQ("% 2 == 0", Explain(m1, 42)); 373 374 // Using PolymorphicIsEven() as a Matcher<char>. 375 const Matcher<char> m2 = PolymorphicIsEven(); 376 EXPECT_TRUE(m2.Matches('\x42')); 377 EXPECT_FALSE(m2.Matches('\x43')); 378 EXPECT_EQ("is even", Describe(m2)); 379 380 const Matcher<char> not_m2 = Not(m2); 381 EXPECT_EQ("is odd", Describe(not_m2)); 382 383 EXPECT_EQ("% 2 == 0", Explain(m2, '\x42')); 384 } 385 386 INSTANTIATE_GTEST_MATCHER_TEST_P(MatcherCastTest); 387 388 // Tests that MatcherCast<T>(m) works when m is a polymorphic matcher. 389 TEST_P(MatcherCastTestP, FromPolymorphicMatcher) { 390 Matcher<int16_t> m; 391 if (use_gtest_matcher_) { 392 m = MatcherCast<int16_t>(GtestGreaterThan(int64_t{5})); 393 } else { 394 m = MatcherCast<int16_t>(Gt(int64_t{5})); 395 } 396 EXPECT_TRUE(m.Matches(6)); 397 EXPECT_FALSE(m.Matches(4)); 398 } 399 400 // For testing casting matchers between compatible types. 401 class IntValue { 402 public: 403 // An int can be statically (although not implicitly) cast to a 404 // IntValue. 405 explicit IntValue(int a_value) : value_(a_value) {} 406 407 int value() const { return value_; } 408 409 private: 410 int value_; 411 }; 412 413 // For testing casting matchers between compatible types. 414 bool IsPositiveIntValue(const IntValue& foo) { return foo.value() > 0; } 415 416 // Tests that MatcherCast<T>(m) works when m is a Matcher<U> where T 417 // can be statically converted to U. 418 TEST(MatcherCastTest, FromCompatibleType) { 419 Matcher<double> m1 = Eq(2.0); 420 Matcher<int> m2 = MatcherCast<int>(m1); 421 EXPECT_TRUE(m2.Matches(2)); 422 EXPECT_FALSE(m2.Matches(3)); 423 424 Matcher<IntValue> m3 = Truly(IsPositiveIntValue); 425 Matcher<int> m4 = MatcherCast<int>(m3); 426 // In the following, the arguments 1 and 0 are statically converted 427 // to IntValue objects, and then tested by the IsPositiveIntValue() 428 // predicate. 429 EXPECT_TRUE(m4.Matches(1)); 430 EXPECT_FALSE(m4.Matches(0)); 431 } 432 433 // Tests that MatcherCast<T>(m) works when m is a Matcher<const T&>. 434 TEST(MatcherCastTest, FromConstReferenceToNonReference) { 435 Matcher<const int&> m1 = Eq(0); 436 Matcher<int> m2 = MatcherCast<int>(m1); 437 EXPECT_TRUE(m2.Matches(0)); 438 EXPECT_FALSE(m2.Matches(1)); 439 } 440 441 // Tests that MatcherCast<T>(m) works when m is a Matcher<T&>. 442 TEST(MatcherCastTest, FromReferenceToNonReference) { 443 Matcher<int&> m1 = Eq(0); 444 Matcher<int> m2 = MatcherCast<int>(m1); 445 EXPECT_TRUE(m2.Matches(0)); 446 EXPECT_FALSE(m2.Matches(1)); 447 } 448 449 // Tests that MatcherCast<const T&>(m) works when m is a Matcher<T>. 450 TEST(MatcherCastTest, FromNonReferenceToConstReference) { 451 Matcher<int> m1 = Eq(0); 452 Matcher<const int&> m2 = MatcherCast<const int&>(m1); 453 EXPECT_TRUE(m2.Matches(0)); 454 EXPECT_FALSE(m2.Matches(1)); 455 } 456 457 // Tests that MatcherCast<T&>(m) works when m is a Matcher<T>. 458 TEST(MatcherCastTest, FromNonReferenceToReference) { 459 Matcher<int> m1 = Eq(0); 460 Matcher<int&> m2 = MatcherCast<int&>(m1); 461 int n = 0; 462 EXPECT_TRUE(m2.Matches(n)); 463 n = 1; 464 EXPECT_FALSE(m2.Matches(n)); 465 } 466 467 // Tests that MatcherCast<T>(m) works when m is a Matcher<T>. 468 TEST(MatcherCastTest, FromSameType) { 469 Matcher<int> m1 = Eq(0); 470 Matcher<int> m2 = MatcherCast<int>(m1); 471 EXPECT_TRUE(m2.Matches(0)); 472 EXPECT_FALSE(m2.Matches(1)); 473 } 474 475 // Tests that MatcherCast<T>(m) works when m is a value of the same type as the 476 // value type of the Matcher. 477 TEST(MatcherCastTest, FromAValue) { 478 Matcher<int> m = MatcherCast<int>(42); 479 EXPECT_TRUE(m.Matches(42)); 480 EXPECT_FALSE(m.Matches(239)); 481 } 482 483 // Tests that MatcherCast<T>(m) works when m is a value of the type implicitly 484 // convertible to the value type of the Matcher. 485 TEST(MatcherCastTest, FromAnImplicitlyConvertibleValue) { 486 const int kExpected = 'c'; 487 Matcher<int> m = MatcherCast<int>('c'); 488 EXPECT_TRUE(m.Matches(kExpected)); 489 EXPECT_FALSE(m.Matches(kExpected + 1)); 490 } 491 492 struct NonImplicitlyConstructibleTypeWithOperatorEq { 493 friend bool operator==( 494 const NonImplicitlyConstructibleTypeWithOperatorEq& /* ignored */, 495 int rhs) { 496 return 42 == rhs; 497 } 498 friend bool operator==( 499 int lhs, 500 const NonImplicitlyConstructibleTypeWithOperatorEq& /* ignored */) { 501 return lhs == 42; 502 } 503 }; 504 505 // Tests that MatcherCast<T>(m) works when m is a neither a matcher nor 506 // implicitly convertible to the value type of the Matcher, but the value type 507 // of the matcher has operator==() overload accepting m. 508 TEST(MatcherCastTest, NonImplicitlyConstructibleTypeWithOperatorEq) { 509 Matcher<NonImplicitlyConstructibleTypeWithOperatorEq> m1 = 510 MatcherCast<NonImplicitlyConstructibleTypeWithOperatorEq>(42); 511 EXPECT_TRUE(m1.Matches(NonImplicitlyConstructibleTypeWithOperatorEq())); 512 513 Matcher<NonImplicitlyConstructibleTypeWithOperatorEq> m2 = 514 MatcherCast<NonImplicitlyConstructibleTypeWithOperatorEq>(239); 515 EXPECT_FALSE(m2.Matches(NonImplicitlyConstructibleTypeWithOperatorEq())); 516 517 // When updating the following lines please also change the comment to 518 // namespace convertible_from_any. 519 Matcher<int> m3 = 520 MatcherCast<int>(NonImplicitlyConstructibleTypeWithOperatorEq()); 521 EXPECT_TRUE(m3.Matches(42)); 522 EXPECT_FALSE(m3.Matches(239)); 523 } 524 525 // ConvertibleFromAny does not work with MSVC. resulting in 526 // error C2440: 'initializing': cannot convert from 'Eq' to 'M' 527 // No constructor could take the source type, or constructor overload 528 // resolution was ambiguous 529 530 #if !defined _MSC_VER 531 532 // The below ConvertibleFromAny struct is implicitly constructible from anything 533 // and when in the same namespace can interact with other tests. In particular, 534 // if it is in the same namespace as other tests and one removes 535 // NonImplicitlyConstructibleTypeWithOperatorEq::operator==(int lhs, ...); 536 // then the corresponding test still compiles (and it should not!) by implicitly 537 // converting NonImplicitlyConstructibleTypeWithOperatorEq to ConvertibleFromAny 538 // in m3.Matcher(). 539 namespace convertible_from_any { 540 // Implicitly convertible from any type. 541 struct ConvertibleFromAny { 542 ConvertibleFromAny(int a_value) : value(a_value) {} 543 template <typename T> 544 ConvertibleFromAny(const T& /*a_value*/) : value(-1) { 545 ADD_FAILURE() << "Conversion constructor called"; 546 } 547 int value; 548 }; 549 550 bool operator==(const ConvertibleFromAny& a, const ConvertibleFromAny& b) { 551 return a.value == b.value; 552 } 553 554 ostream& operator<<(ostream& os, const ConvertibleFromAny& a) { 555 return os << a.value; 556 } 557 558 TEST(MatcherCastTest, ConversionConstructorIsUsed) { 559 Matcher<ConvertibleFromAny> m = MatcherCast<ConvertibleFromAny>(1); 560 EXPECT_TRUE(m.Matches(ConvertibleFromAny(1))); 561 EXPECT_FALSE(m.Matches(ConvertibleFromAny(2))); 562 } 563 564 TEST(MatcherCastTest, FromConvertibleFromAny) { 565 Matcher<ConvertibleFromAny> m = 566 MatcherCast<ConvertibleFromAny>(Eq(ConvertibleFromAny(1))); 567 EXPECT_TRUE(m.Matches(ConvertibleFromAny(1))); 568 EXPECT_FALSE(m.Matches(ConvertibleFromAny(2))); 569 } 570 } // namespace convertible_from_any 571 572 #endif // !defined _MSC_VER 573 574 struct IntReferenceWrapper { 575 IntReferenceWrapper(const int& a_value) : value(&a_value) {} 576 const int* value; 577 }; 578 579 bool operator==(const IntReferenceWrapper& a, const IntReferenceWrapper& b) { 580 return a.value == b.value; 581 } 582 583 TEST(MatcherCastTest, ValueIsNotCopied) { 584 int n = 42; 585 Matcher<IntReferenceWrapper> m = MatcherCast<IntReferenceWrapper>(n); 586 // Verify that the matcher holds a reference to n, not to its temporary copy. 587 EXPECT_TRUE(m.Matches(n)); 588 } 589 590 class Base { 591 public: 592 virtual ~Base() = default; 593 Base() = default; 594 595 private: 596 Base(const Base&) = delete; 597 Base& operator=(const Base&) = delete; 598 }; 599 600 class Derived : public Base { 601 public: 602 Derived() : Base() {} 603 int i; 604 }; 605 606 class OtherDerived : public Base {}; 607 608 INSTANTIATE_GTEST_MATCHER_TEST_P(SafeMatcherCastTest); 609 610 // Tests that SafeMatcherCast<T>(m) works when m is a polymorphic matcher. 611 TEST_P(SafeMatcherCastTestP, FromPolymorphicMatcher) { 612 Matcher<char> m2; 613 if (use_gtest_matcher_) { 614 m2 = SafeMatcherCast<char>(GtestGreaterThan(32)); 615 } else { 616 m2 = SafeMatcherCast<char>(Gt(32)); 617 } 618 EXPECT_TRUE(m2.Matches('A')); 619 EXPECT_FALSE(m2.Matches('\n')); 620 } 621 622 // Tests that SafeMatcherCast<T>(m) works when m is a Matcher<U> where 623 // T and U are arithmetic types and T can be losslessly converted to 624 // U. 625 TEST(SafeMatcherCastTest, FromLosslesslyConvertibleArithmeticType) { 626 Matcher<double> m1 = DoubleEq(1.0); 627 Matcher<float> m2 = SafeMatcherCast<float>(m1); 628 EXPECT_TRUE(m2.Matches(1.0f)); 629 EXPECT_FALSE(m2.Matches(2.0f)); 630 631 Matcher<char> m3 = SafeMatcherCast<char>(TypedEq<int>('a')); 632 EXPECT_TRUE(m3.Matches('a')); 633 EXPECT_FALSE(m3.Matches('b')); 634 } 635 636 // Tests that SafeMatcherCast<T>(m) works when m is a Matcher<U> where T and U 637 // are pointers or references to a derived and a base class, correspondingly. 638 TEST(SafeMatcherCastTest, FromBaseClass) { 639 Derived d, d2; 640 Matcher<Base*> m1 = Eq(&d); 641 Matcher<Derived*> m2 = SafeMatcherCast<Derived*>(m1); 642 EXPECT_TRUE(m2.Matches(&d)); 643 EXPECT_FALSE(m2.Matches(&d2)); 644 645 Matcher<Base&> m3 = Ref(d); 646 Matcher<Derived&> m4 = SafeMatcherCast<Derived&>(m3); 647 EXPECT_TRUE(m4.Matches(d)); 648 EXPECT_FALSE(m4.Matches(d2)); 649 } 650 651 // Tests that SafeMatcherCast<T&>(m) works when m is a Matcher<const T&>. 652 TEST(SafeMatcherCastTest, FromConstReferenceToReference) { 653 int n = 0; 654 Matcher<const int&> m1 = Ref(n); 655 Matcher<int&> m2 = SafeMatcherCast<int&>(m1); 656 int n1 = 0; 657 EXPECT_TRUE(m2.Matches(n)); 658 EXPECT_FALSE(m2.Matches(n1)); 659 } 660 661 // Tests that MatcherCast<const T&>(m) works when m is a Matcher<T>. 662 TEST(SafeMatcherCastTest, FromNonReferenceToConstReference) { 663 Matcher<std::unique_ptr<int>> m1 = IsNull(); 664 Matcher<const std::unique_ptr<int>&> m2 = 665 SafeMatcherCast<const std::unique_ptr<int>&>(m1); 666 EXPECT_TRUE(m2.Matches(std::unique_ptr<int>())); 667 EXPECT_FALSE(m2.Matches(std::unique_ptr<int>(new int))); 668 } 669 670 // Tests that SafeMatcherCast<T&>(m) works when m is a Matcher<T>. 671 TEST(SafeMatcherCastTest, FromNonReferenceToReference) { 672 Matcher<int> m1 = Eq(0); 673 Matcher<int&> m2 = SafeMatcherCast<int&>(m1); 674 int n = 0; 675 EXPECT_TRUE(m2.Matches(n)); 676 n = 1; 677 EXPECT_FALSE(m2.Matches(n)); 678 } 679 680 // Tests that SafeMatcherCast<T>(m) works when m is a Matcher<T>. 681 TEST(SafeMatcherCastTest, FromSameType) { 682 Matcher<int> m1 = Eq(0); 683 Matcher<int> m2 = SafeMatcherCast<int>(m1); 684 EXPECT_TRUE(m2.Matches(0)); 685 EXPECT_FALSE(m2.Matches(1)); 686 } 687 688 #if !defined _MSC_VER 689 690 namespace convertible_from_any { 691 TEST(SafeMatcherCastTest, ConversionConstructorIsUsed) { 692 Matcher<ConvertibleFromAny> m = SafeMatcherCast<ConvertibleFromAny>(1); 693 EXPECT_TRUE(m.Matches(ConvertibleFromAny(1))); 694 EXPECT_FALSE(m.Matches(ConvertibleFromAny(2))); 695 } 696 697 TEST(SafeMatcherCastTest, FromConvertibleFromAny) { 698 Matcher<ConvertibleFromAny> m = 699 SafeMatcherCast<ConvertibleFromAny>(Eq(ConvertibleFromAny(1))); 700 EXPECT_TRUE(m.Matches(ConvertibleFromAny(1))); 701 EXPECT_FALSE(m.Matches(ConvertibleFromAny(2))); 702 } 703 } // namespace convertible_from_any 704 705 #endif // !defined _MSC_VER 706 707 TEST(SafeMatcherCastTest, ValueIsNotCopied) { 708 int n = 42; 709 Matcher<IntReferenceWrapper> m = SafeMatcherCast<IntReferenceWrapper>(n); 710 // Verify that the matcher holds a reference to n, not to its temporary copy. 711 EXPECT_TRUE(m.Matches(n)); 712 } 713 714 TEST(ExpectThat, TakesLiterals) { 715 EXPECT_THAT(1, 1); 716 EXPECT_THAT(1.0, 1.0); 717 EXPECT_THAT(std::string(), ""); 718 } 719 720 TEST(ExpectThat, TakesFunctions) { 721 struct Helper { 722 static void Func() {} 723 }; 724 void (*func)() = Helper::Func; 725 EXPECT_THAT(func, Helper::Func); 726 EXPECT_THAT(func, &Helper::Func); 727 } 728 729 // Tests that A<T>() matches any value of type T. 730 TEST(ATest, MatchesAnyValue) { 731 // Tests a matcher for a value type. 732 Matcher<double> m1 = A<double>(); 733 EXPECT_TRUE(m1.Matches(91.43)); 734 EXPECT_TRUE(m1.Matches(-15.32)); 735 736 // Tests a matcher for a reference type. 737 int a = 2; 738 int b = -6; 739 Matcher<int&> m2 = A<int&>(); 740 EXPECT_TRUE(m2.Matches(a)); 741 EXPECT_TRUE(m2.Matches(b)); 742 } 743 744 TEST(ATest, WorksForDerivedClass) { 745 Base base; 746 Derived derived; 747 EXPECT_THAT(&base, A<Base*>()); 748 // This shouldn't compile: EXPECT_THAT(&base, A<Derived*>()); 749 EXPECT_THAT(&derived, A<Base*>()); 750 EXPECT_THAT(&derived, A<Derived*>()); 751 } 752 753 // Tests that A<T>() describes itself properly. 754 TEST(ATest, CanDescribeSelf) { EXPECT_EQ("is anything", Describe(A<bool>())); } 755 756 // Tests that An<T>() matches any value of type T. 757 TEST(AnTest, MatchesAnyValue) { 758 // Tests a matcher for a value type. 759 Matcher<int> m1 = An<int>(); 760 EXPECT_TRUE(m1.Matches(9143)); 761 EXPECT_TRUE(m1.Matches(-1532)); 762 763 // Tests a matcher for a reference type. 764 int a = 2; 765 int b = -6; 766 Matcher<int&> m2 = An<int&>(); 767 EXPECT_TRUE(m2.Matches(a)); 768 EXPECT_TRUE(m2.Matches(b)); 769 } 770 771 // Tests that An<T>() describes itself properly. 772 TEST(AnTest, CanDescribeSelf) { EXPECT_EQ("is anything", Describe(An<int>())); } 773 774 // Tests that _ can be used as a matcher for any type and matches any 775 // value of that type. 776 TEST(UnderscoreTest, MatchesAnyValue) { 777 // Uses _ as a matcher for a value type. 778 Matcher<int> m1 = _; 779 EXPECT_TRUE(m1.Matches(123)); 780 EXPECT_TRUE(m1.Matches(-242)); 781 782 // Uses _ as a matcher for a reference type. 783 bool a = false; 784 const bool b = true; 785 Matcher<const bool&> m2 = _; 786 EXPECT_TRUE(m2.Matches(a)); 787 EXPECT_TRUE(m2.Matches(b)); 788 } 789 790 // Tests that _ describes itself properly. 791 TEST(UnderscoreTest, CanDescribeSelf) { 792 Matcher<int> m = _; 793 EXPECT_EQ("is anything", Describe(m)); 794 } 795 796 // Tests that Eq(x) matches any value equal to x. 797 TEST(EqTest, MatchesEqualValue) { 798 // 2 C-strings with same content but different addresses. 799 const char a1[] = "hi"; 800 const char a2[] = "hi"; 801 802 Matcher<const char*> m1 = Eq(a1); 803 EXPECT_TRUE(m1.Matches(a1)); 804 EXPECT_FALSE(m1.Matches(a2)); 805 } 806 807 // Tests that Eq(v) describes itself properly. 808 809 class Unprintable { 810 public: 811 Unprintable() : c_('a') {} 812 813 bool operator==(const Unprintable& /* rhs */) const { return true; } 814 // -Wunused-private-field: dummy accessor for `c_`. 815 char dummy_c() { return c_; } 816 817 private: 818 char c_; 819 }; 820 821 TEST(EqTest, CanDescribeSelf) { 822 Matcher<Unprintable> m = Eq(Unprintable()); 823 EXPECT_EQ("is equal to 1-byte object <61>", Describe(m)); 824 } 825 826 // Tests that Eq(v) can be used to match any type that supports 827 // comparing with type T, where T is v's type. 828 TEST(EqTest, IsPolymorphic) { 829 Matcher<int> m1 = Eq(1); 830 EXPECT_TRUE(m1.Matches(1)); 831 EXPECT_FALSE(m1.Matches(2)); 832 833 Matcher<char> m2 = Eq(1); 834 EXPECT_TRUE(m2.Matches('\1')); 835 EXPECT_FALSE(m2.Matches('a')); 836 } 837 838 // Tests that TypedEq<T>(v) matches values of type T that's equal to v. 839 TEST(TypedEqTest, ChecksEqualityForGivenType) { 840 Matcher<char> m1 = TypedEq<char>('a'); 841 EXPECT_TRUE(m1.Matches('a')); 842 EXPECT_FALSE(m1.Matches('b')); 843 844 Matcher<int> m2 = TypedEq<int>(6); 845 EXPECT_TRUE(m2.Matches(6)); 846 EXPECT_FALSE(m2.Matches(7)); 847 } 848 849 // Tests that TypedEq(v) describes itself properly. 850 TEST(TypedEqTest, CanDescribeSelf) { 851 EXPECT_EQ("is equal to 2", Describe(TypedEq<int>(2))); 852 } 853 854 // Tests that TypedEq<T>(v) has type Matcher<T>. 855 856 // Type<T>::IsTypeOf(v) compiles if and only if the type of value v is T, where 857 // T is a "bare" type (i.e. not in the form of const U or U&). If v's type is 858 // not T, the compiler will generate a message about "undefined reference". 859 template <typename T> 860 struct Type { 861 static bool IsTypeOf(const T& /* v */) { return true; } 862 863 template <typename T2> 864 static void IsTypeOf(T2 v); 865 }; 866 867 TEST(TypedEqTest, HasSpecifiedType) { 868 // Verifies that the type of TypedEq<T>(v) is Matcher<T>. 869 Type<Matcher<int>>::IsTypeOf(TypedEq<int>(5)); 870 Type<Matcher<double>>::IsTypeOf(TypedEq<double>(5)); 871 } 872 873 // Tests that Ge(v) matches anything >= v. 874 TEST(GeTest, ImplementsGreaterThanOrEqual) { 875 Matcher<int> m1 = Ge(0); 876 EXPECT_TRUE(m1.Matches(1)); 877 EXPECT_TRUE(m1.Matches(0)); 878 EXPECT_FALSE(m1.Matches(-1)); 879 } 880 881 // Tests that Ge(v) describes itself properly. 882 TEST(GeTest, CanDescribeSelf) { 883 Matcher<int> m = Ge(5); 884 EXPECT_EQ("is >= 5", Describe(m)); 885 } 886 887 // Tests that Gt(v) matches anything > v. 888 TEST(GtTest, ImplementsGreaterThan) { 889 Matcher<double> m1 = Gt(0); 890 EXPECT_TRUE(m1.Matches(1.0)); 891 EXPECT_FALSE(m1.Matches(0.0)); 892 EXPECT_FALSE(m1.Matches(-1.0)); 893 } 894 895 // Tests that Gt(v) describes itself properly. 896 TEST(GtTest, CanDescribeSelf) { 897 Matcher<int> m = Gt(5); 898 EXPECT_EQ("is > 5", Describe(m)); 899 } 900 901 // Tests that Le(v) matches anything <= v. 902 TEST(LeTest, ImplementsLessThanOrEqual) { 903 Matcher<char> m1 = Le('b'); 904 EXPECT_TRUE(m1.Matches('a')); 905 EXPECT_TRUE(m1.Matches('b')); 906 EXPECT_FALSE(m1.Matches('c')); 907 } 908 909 // Tests that Le(v) describes itself properly. 910 TEST(LeTest, CanDescribeSelf) { 911 Matcher<int> m = Le(5); 912 EXPECT_EQ("is <= 5", Describe(m)); 913 } 914 915 // Tests that Lt(v) matches anything < v. 916 TEST(LtTest, ImplementsLessThan) { 917 Matcher<const std::string&> m1 = Lt("Hello"); 918 EXPECT_TRUE(m1.Matches("Abc")); 919 EXPECT_FALSE(m1.Matches("Hello")); 920 EXPECT_FALSE(m1.Matches("Hello, world!")); 921 } 922 923 // Tests that Lt(v) describes itself properly. 924 TEST(LtTest, CanDescribeSelf) { 925 Matcher<int> m = Lt(5); 926 EXPECT_EQ("is < 5", Describe(m)); 927 } 928 929 // Tests that Ne(v) matches anything != v. 930 TEST(NeTest, ImplementsNotEqual) { 931 Matcher<int> m1 = Ne(0); 932 EXPECT_TRUE(m1.Matches(1)); 933 EXPECT_TRUE(m1.Matches(-1)); 934 EXPECT_FALSE(m1.Matches(0)); 935 } 936 937 // Tests that Ne(v) describes itself properly. 938 TEST(NeTest, CanDescribeSelf) { 939 Matcher<int> m = Ne(5); 940 EXPECT_EQ("isn't equal to 5", Describe(m)); 941 } 942 943 class MoveOnly { 944 public: 945 explicit MoveOnly(int i) : i_(i) {} 946 MoveOnly(const MoveOnly&) = delete; 947 MoveOnly(MoveOnly&&) = default; 948 MoveOnly& operator=(const MoveOnly&) = delete; 949 MoveOnly& operator=(MoveOnly&&) = default; 950 951 bool operator==(const MoveOnly& other) const { return i_ == other.i_; } 952 bool operator!=(const MoveOnly& other) const { return i_ != other.i_; } 953 bool operator<(const MoveOnly& other) const { return i_ < other.i_; } 954 bool operator<=(const MoveOnly& other) const { return i_ <= other.i_; } 955 bool operator>(const MoveOnly& other) const { return i_ > other.i_; } 956 bool operator>=(const MoveOnly& other) const { return i_ >= other.i_; } 957 958 private: 959 int i_; 960 }; 961 962 struct MoveHelper { 963 MOCK_METHOD1(Call, void(MoveOnly)); 964 }; 965 966 // Disable this test in VS 2015 (version 14), where it fails when SEH is enabled 967 #if defined(_MSC_VER) && (_MSC_VER < 1910) 968 TEST(ComparisonBaseTest, DISABLED_WorksWithMoveOnly) { 969 #else 970 TEST(ComparisonBaseTest, WorksWithMoveOnly) { 971 #endif 972 MoveOnly m{0}; 973 MoveHelper helper; 974 975 EXPECT_CALL(helper, Call(Eq(ByRef(m)))); 976 helper.Call(MoveOnly(0)); 977 EXPECT_CALL(helper, Call(Ne(ByRef(m)))); 978 helper.Call(MoveOnly(1)); 979 EXPECT_CALL(helper, Call(Le(ByRef(m)))); 980 helper.Call(MoveOnly(0)); 981 EXPECT_CALL(helper, Call(Lt(ByRef(m)))); 982 helper.Call(MoveOnly(-1)); 983 EXPECT_CALL(helper, Call(Ge(ByRef(m)))); 984 helper.Call(MoveOnly(0)); 985 EXPECT_CALL(helper, Call(Gt(ByRef(m)))); 986 helper.Call(MoveOnly(1)); 987 } 988 989 TEST(IsEmptyTest, MatchesContainer) { 990 const Matcher<std::vector<int>> m = IsEmpty(); 991 std::vector<int> a = {}; 992 std::vector<int> b = {1}; 993 EXPECT_TRUE(m.Matches(a)); 994 EXPECT_FALSE(m.Matches(b)); 995 } 996 997 TEST(IsEmptyTest, MatchesStdString) { 998 const Matcher<std::string> m = IsEmpty(); 999 std::string a = "z"; 1000 std::string b = ""; 1001 EXPECT_FALSE(m.Matches(a)); 1002 EXPECT_TRUE(m.Matches(b)); 1003 } 1004 1005 TEST(IsEmptyTest, MatchesCString) { 1006 const Matcher<const char*> m = IsEmpty(); 1007 const char a[] = ""; 1008 const char b[] = "x"; 1009 EXPECT_TRUE(m.Matches(a)); 1010 EXPECT_FALSE(m.Matches(b)); 1011 } 1012 1013 // Tests that IsNull() matches any NULL pointer of any type. 1014 TEST(IsNullTest, MatchesNullPointer) { 1015 Matcher<int*> m1 = IsNull(); 1016 int* p1 = nullptr; 1017 int n = 0; 1018 EXPECT_TRUE(m1.Matches(p1)); 1019 EXPECT_FALSE(m1.Matches(&n)); 1020 1021 Matcher<const char*> m2 = IsNull(); 1022 const char* p2 = nullptr; 1023 EXPECT_TRUE(m2.Matches(p2)); 1024 EXPECT_FALSE(m2.Matches("hi")); 1025 1026 Matcher<void*> m3 = IsNull(); 1027 void* p3 = nullptr; 1028 EXPECT_TRUE(m3.Matches(p3)); 1029 EXPECT_FALSE(m3.Matches(reinterpret_cast<void*>(0xbeef))); 1030 } 1031 1032 TEST(IsNullTest, StdFunction) { 1033 const Matcher<std::function<void()>> m = IsNull(); 1034 1035 EXPECT_TRUE(m.Matches(std::function<void()>())); 1036 EXPECT_FALSE(m.Matches([] {})); 1037 } 1038 1039 // Tests that IsNull() describes itself properly. 1040 TEST(IsNullTest, CanDescribeSelf) { 1041 Matcher<int*> m = IsNull(); 1042 EXPECT_EQ("is NULL", Describe(m)); 1043 EXPECT_EQ("isn't NULL", DescribeNegation(m)); 1044 } 1045 1046 // Tests that NotNull() matches any non-NULL pointer of any type. 1047 TEST(NotNullTest, MatchesNonNullPointer) { 1048 Matcher<int*> m1 = NotNull(); 1049 int* p1 = nullptr; 1050 int n = 0; 1051 EXPECT_FALSE(m1.Matches(p1)); 1052 EXPECT_TRUE(m1.Matches(&n)); 1053 1054 Matcher<const char*> m2 = NotNull(); 1055 const char* p2 = nullptr; 1056 EXPECT_FALSE(m2.Matches(p2)); 1057 EXPECT_TRUE(m2.Matches("hi")); 1058 } 1059 1060 TEST(NotNullTest, LinkedPtr) { 1061 const Matcher<std::shared_ptr<int>> m = NotNull(); 1062 const std::shared_ptr<int> null_p; 1063 const std::shared_ptr<int> non_null_p(new int); 1064 1065 EXPECT_FALSE(m.Matches(null_p)); 1066 EXPECT_TRUE(m.Matches(non_null_p)); 1067 } 1068 1069 TEST(NotNullTest, ReferenceToConstLinkedPtr) { 1070 const Matcher<const std::shared_ptr<double>&> m = NotNull(); 1071 const std::shared_ptr<double> null_p; 1072 const std::shared_ptr<double> non_null_p(new double); 1073 1074 EXPECT_FALSE(m.Matches(null_p)); 1075 EXPECT_TRUE(m.Matches(non_null_p)); 1076 } 1077 1078 TEST(NotNullTest, StdFunction) { 1079 const Matcher<std::function<void()>> m = NotNull(); 1080 1081 EXPECT_TRUE(m.Matches([] {})); 1082 EXPECT_FALSE(m.Matches(std::function<void()>())); 1083 } 1084 1085 // Tests that NotNull() describes itself properly. 1086 TEST(NotNullTest, CanDescribeSelf) { 1087 Matcher<int*> m = NotNull(); 1088 EXPECT_EQ("isn't NULL", Describe(m)); 1089 } 1090 1091 // Tests that Ref(variable) matches an argument that references 1092 // 'variable'. 1093 TEST(RefTest, MatchesSameVariable) { 1094 int a = 0; 1095 int b = 0; 1096 Matcher<int&> m = Ref(a); 1097 EXPECT_TRUE(m.Matches(a)); 1098 EXPECT_FALSE(m.Matches(b)); 1099 } 1100 1101 // Tests that Ref(variable) describes itself properly. 1102 TEST(RefTest, CanDescribeSelf) { 1103 int n = 5; 1104 Matcher<int&> m = Ref(n); 1105 stringstream ss; 1106 ss << "references the variable @" << &n << " 5"; 1107 EXPECT_EQ(ss.str(), Describe(m)); 1108 } 1109 1110 // Test that Ref(non_const_varialbe) can be used as a matcher for a 1111 // const reference. 1112 TEST(RefTest, CanBeUsedAsMatcherForConstReference) { 1113 int a = 0; 1114 int b = 0; 1115 Matcher<const int&> m = Ref(a); 1116 EXPECT_TRUE(m.Matches(a)); 1117 EXPECT_FALSE(m.Matches(b)); 1118 } 1119 1120 // Tests that Ref(variable) is covariant, i.e. Ref(derived) can be 1121 // used wherever Ref(base) can be used (Ref(derived) is a sub-type 1122 // of Ref(base), but not vice versa. 1123 1124 TEST(RefTest, IsCovariant) { 1125 Base base, base2; 1126 Derived derived; 1127 Matcher<const Base&> m1 = Ref(base); 1128 EXPECT_TRUE(m1.Matches(base)); 1129 EXPECT_FALSE(m1.Matches(base2)); 1130 EXPECT_FALSE(m1.Matches(derived)); 1131 1132 m1 = Ref(derived); 1133 EXPECT_TRUE(m1.Matches(derived)); 1134 EXPECT_FALSE(m1.Matches(base)); 1135 EXPECT_FALSE(m1.Matches(base2)); 1136 } 1137 1138 TEST(RefTest, ExplainsResult) { 1139 int n = 0; 1140 EXPECT_THAT(Explain(Matcher<const int&>(Ref(n)), n), 1141 StartsWith("which is located @")); 1142 1143 int m = 0; 1144 EXPECT_THAT(Explain(Matcher<const int&>(Ref(n)), m), 1145 StartsWith("which is located @")); 1146 } 1147 1148 // Tests string comparison matchers. 1149 1150 template <typename T = std::string> 1151 std::string FromStringLike(internal::StringLike<T> str) { 1152 return std::string(str); 1153 } 1154 1155 TEST(StringLike, TestConversions) { 1156 EXPECT_EQ("foo", FromStringLike("foo")); 1157 EXPECT_EQ("foo", FromStringLike(std::string("foo"))); 1158 #if GTEST_INTERNAL_HAS_STRING_VIEW 1159 EXPECT_EQ("foo", FromStringLike(internal::StringView("foo"))); 1160 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1161 1162 // Non deducible types. 1163 EXPECT_EQ("", FromStringLike({})); 1164 EXPECT_EQ("foo", FromStringLike({'f', 'o', 'o'})); 1165 const char buf[] = "foo"; 1166 EXPECT_EQ("foo", FromStringLike({buf, buf + 3})); 1167 } 1168 1169 TEST(StrEqTest, MatchesEqualString) { 1170 Matcher<const char*> m = StrEq(std::string("Hello")); 1171 EXPECT_TRUE(m.Matches("Hello")); 1172 EXPECT_FALSE(m.Matches("hello")); 1173 EXPECT_FALSE(m.Matches(nullptr)); 1174 1175 Matcher<const std::string&> m2 = StrEq("Hello"); 1176 EXPECT_TRUE(m2.Matches("Hello")); 1177 EXPECT_FALSE(m2.Matches("Hi")); 1178 1179 #if GTEST_INTERNAL_HAS_STRING_VIEW 1180 Matcher<const internal::StringView&> m3 = 1181 StrEq(internal::StringView("Hello")); 1182 EXPECT_TRUE(m3.Matches(internal::StringView("Hello"))); 1183 EXPECT_FALSE(m3.Matches(internal::StringView("hello"))); 1184 EXPECT_FALSE(m3.Matches(internal::StringView())); 1185 1186 Matcher<const internal::StringView&> m_empty = StrEq(""); 1187 EXPECT_TRUE(m_empty.Matches(internal::StringView(""))); 1188 EXPECT_TRUE(m_empty.Matches(internal::StringView())); 1189 EXPECT_FALSE(m_empty.Matches(internal::StringView("hello"))); 1190 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1191 } 1192 1193 TEST(StrEqTest, CanDescribeSelf) { 1194 Matcher<std::string> m = StrEq("Hi-\'\"?\\\a\b\f\n\r\t\v\xD3"); 1195 EXPECT_EQ("is equal to \"Hi-\'\\\"?\\\\\\a\\b\\f\\n\\r\\t\\v\\xD3\"", 1196 Describe(m)); 1197 1198 std::string str("01204500800"); 1199 str[3] = '\0'; 1200 Matcher<std::string> m2 = StrEq(str); 1201 EXPECT_EQ("is equal to \"012\\04500800\"", Describe(m2)); 1202 str[0] = str[6] = str[7] = str[9] = str[10] = '\0'; 1203 Matcher<std::string> m3 = StrEq(str); 1204 EXPECT_EQ("is equal to \"\\012\\045\\0\\08\\0\\0\"", Describe(m3)); 1205 } 1206 1207 TEST(StrNeTest, MatchesUnequalString) { 1208 Matcher<const char*> m = StrNe("Hello"); 1209 EXPECT_TRUE(m.Matches("")); 1210 EXPECT_TRUE(m.Matches(nullptr)); 1211 EXPECT_FALSE(m.Matches("Hello")); 1212 1213 Matcher<std::string> m2 = StrNe(std::string("Hello")); 1214 EXPECT_TRUE(m2.Matches("hello")); 1215 EXPECT_FALSE(m2.Matches("Hello")); 1216 1217 #if GTEST_INTERNAL_HAS_STRING_VIEW 1218 Matcher<const internal::StringView> m3 = StrNe(internal::StringView("Hello")); 1219 EXPECT_TRUE(m3.Matches(internal::StringView(""))); 1220 EXPECT_TRUE(m3.Matches(internal::StringView())); 1221 EXPECT_FALSE(m3.Matches(internal::StringView("Hello"))); 1222 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1223 } 1224 1225 TEST(StrNeTest, CanDescribeSelf) { 1226 Matcher<const char*> m = StrNe("Hi"); 1227 EXPECT_EQ("isn't equal to \"Hi\"", Describe(m)); 1228 } 1229 1230 TEST(StrCaseEqTest, MatchesEqualStringIgnoringCase) { 1231 Matcher<const char*> m = StrCaseEq(std::string("Hello")); 1232 EXPECT_TRUE(m.Matches("Hello")); 1233 EXPECT_TRUE(m.Matches("hello")); 1234 EXPECT_FALSE(m.Matches("Hi")); 1235 EXPECT_FALSE(m.Matches(nullptr)); 1236 1237 Matcher<const std::string&> m2 = StrCaseEq("Hello"); 1238 EXPECT_TRUE(m2.Matches("hello")); 1239 EXPECT_FALSE(m2.Matches("Hi")); 1240 1241 #if GTEST_INTERNAL_HAS_STRING_VIEW 1242 Matcher<const internal::StringView&> m3 = 1243 StrCaseEq(internal::StringView("Hello")); 1244 EXPECT_TRUE(m3.Matches(internal::StringView("Hello"))); 1245 EXPECT_TRUE(m3.Matches(internal::StringView("hello"))); 1246 EXPECT_FALSE(m3.Matches(internal::StringView("Hi"))); 1247 EXPECT_FALSE(m3.Matches(internal::StringView())); 1248 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1249 } 1250 1251 TEST(StrCaseEqTest, MatchesEqualStringWith0IgnoringCase) { 1252 std::string str1("oabocdooeoo"); 1253 std::string str2("OABOCDOOEOO"); 1254 Matcher<const std::string&> m0 = StrCaseEq(str1); 1255 EXPECT_FALSE(m0.Matches(str2 + std::string(1, '\0'))); 1256 1257 str1[3] = str2[3] = '\0'; 1258 Matcher<const std::string&> m1 = StrCaseEq(str1); 1259 EXPECT_TRUE(m1.Matches(str2)); 1260 1261 str1[0] = str1[6] = str1[7] = str1[10] = '\0'; 1262 str2[0] = str2[6] = str2[7] = str2[10] = '\0'; 1263 Matcher<const std::string&> m2 = StrCaseEq(str1); 1264 str1[9] = str2[9] = '\0'; 1265 EXPECT_FALSE(m2.Matches(str2)); 1266 1267 Matcher<const std::string&> m3 = StrCaseEq(str1); 1268 EXPECT_TRUE(m3.Matches(str2)); 1269 1270 EXPECT_FALSE(m3.Matches(str2 + "x")); 1271 str2.append(1, '\0'); 1272 EXPECT_FALSE(m3.Matches(str2)); 1273 EXPECT_FALSE(m3.Matches(std::string(str2, 0, 9))); 1274 } 1275 1276 TEST(StrCaseEqTest, CanDescribeSelf) { 1277 Matcher<std::string> m = StrCaseEq("Hi"); 1278 EXPECT_EQ("is equal to (ignoring case) \"Hi\"", Describe(m)); 1279 } 1280 1281 TEST(StrCaseNeTest, MatchesUnequalStringIgnoringCase) { 1282 Matcher<const char*> m = StrCaseNe("Hello"); 1283 EXPECT_TRUE(m.Matches("Hi")); 1284 EXPECT_TRUE(m.Matches(nullptr)); 1285 EXPECT_FALSE(m.Matches("Hello")); 1286 EXPECT_FALSE(m.Matches("hello")); 1287 1288 Matcher<std::string> m2 = StrCaseNe(std::string("Hello")); 1289 EXPECT_TRUE(m2.Matches("")); 1290 EXPECT_FALSE(m2.Matches("Hello")); 1291 1292 #if GTEST_INTERNAL_HAS_STRING_VIEW 1293 Matcher<const internal::StringView> m3 = 1294 StrCaseNe(internal::StringView("Hello")); 1295 EXPECT_TRUE(m3.Matches(internal::StringView("Hi"))); 1296 EXPECT_TRUE(m3.Matches(internal::StringView())); 1297 EXPECT_FALSE(m3.Matches(internal::StringView("Hello"))); 1298 EXPECT_FALSE(m3.Matches(internal::StringView("hello"))); 1299 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1300 } 1301 1302 TEST(StrCaseNeTest, CanDescribeSelf) { 1303 Matcher<const char*> m = StrCaseNe("Hi"); 1304 EXPECT_EQ("isn't equal to (ignoring case) \"Hi\"", Describe(m)); 1305 } 1306 1307 // Tests that HasSubstr() works for matching string-typed values. 1308 TEST(HasSubstrTest, WorksForStringClasses) { 1309 const Matcher<std::string> m1 = HasSubstr("foo"); 1310 EXPECT_TRUE(m1.Matches(std::string("I love food."))); 1311 EXPECT_FALSE(m1.Matches(std::string("tofo"))); 1312 1313 const Matcher<const std::string&> m2 = HasSubstr("foo"); 1314 EXPECT_TRUE(m2.Matches(std::string("I love food."))); 1315 EXPECT_FALSE(m2.Matches(std::string("tofo"))); 1316 1317 const Matcher<std::string> m_empty = HasSubstr(""); 1318 EXPECT_TRUE(m_empty.Matches(std::string())); 1319 EXPECT_TRUE(m_empty.Matches(std::string("not empty"))); 1320 } 1321 1322 // Tests that HasSubstr() works for matching C-string-typed values. 1323 TEST(HasSubstrTest, WorksForCStrings) { 1324 const Matcher<char*> m1 = HasSubstr("foo"); 1325 EXPECT_TRUE(m1.Matches(const_cast<char*>("I love food."))); 1326 EXPECT_FALSE(m1.Matches(const_cast<char*>("tofo"))); 1327 EXPECT_FALSE(m1.Matches(nullptr)); 1328 1329 const Matcher<const char*> m2 = HasSubstr("foo"); 1330 EXPECT_TRUE(m2.Matches("I love food.")); 1331 EXPECT_FALSE(m2.Matches("tofo")); 1332 EXPECT_FALSE(m2.Matches(nullptr)); 1333 1334 const Matcher<const char*> m_empty = HasSubstr(""); 1335 EXPECT_TRUE(m_empty.Matches("not empty")); 1336 EXPECT_TRUE(m_empty.Matches("")); 1337 EXPECT_FALSE(m_empty.Matches(nullptr)); 1338 } 1339 1340 #if GTEST_INTERNAL_HAS_STRING_VIEW 1341 // Tests that HasSubstr() works for matching StringView-typed values. 1342 TEST(HasSubstrTest, WorksForStringViewClasses) { 1343 const Matcher<internal::StringView> m1 = 1344 HasSubstr(internal::StringView("foo")); 1345 EXPECT_TRUE(m1.Matches(internal::StringView("I love food."))); 1346 EXPECT_FALSE(m1.Matches(internal::StringView("tofo"))); 1347 EXPECT_FALSE(m1.Matches(internal::StringView())); 1348 1349 const Matcher<const internal::StringView&> m2 = HasSubstr("foo"); 1350 EXPECT_TRUE(m2.Matches(internal::StringView("I love food."))); 1351 EXPECT_FALSE(m2.Matches(internal::StringView("tofo"))); 1352 EXPECT_FALSE(m2.Matches(internal::StringView())); 1353 1354 const Matcher<const internal::StringView&> m3 = HasSubstr(""); 1355 EXPECT_TRUE(m3.Matches(internal::StringView("foo"))); 1356 EXPECT_TRUE(m3.Matches(internal::StringView(""))); 1357 EXPECT_TRUE(m3.Matches(internal::StringView())); 1358 } 1359 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1360 1361 // Tests that HasSubstr(s) describes itself properly. 1362 TEST(HasSubstrTest, CanDescribeSelf) { 1363 Matcher<std::string> m = HasSubstr("foo\n\""); 1364 EXPECT_EQ("has substring \"foo\\n\\\"\"", Describe(m)); 1365 } 1366 1367 INSTANTIATE_GTEST_MATCHER_TEST_P(KeyTest); 1368 1369 TEST(KeyTest, CanDescribeSelf) { 1370 Matcher<const pair<std::string, int>&> m = Key("foo"); 1371 EXPECT_EQ("has a key that is equal to \"foo\"", Describe(m)); 1372 EXPECT_EQ("doesn't have a key that is equal to \"foo\"", DescribeNegation(m)); 1373 } 1374 1375 TEST_P(KeyTestP, ExplainsResult) { 1376 Matcher<pair<int, bool>> m = Key(GreaterThan(10)); 1377 EXPECT_EQ("whose first field is a value which is 5 less than 10", 1378 Explain(m, make_pair(5, true))); 1379 EXPECT_EQ("whose first field is a value which is 5 more than 10", 1380 Explain(m, make_pair(15, true))); 1381 } 1382 1383 TEST(KeyTest, MatchesCorrectly) { 1384 pair<int, std::string> p(25, "foo"); 1385 EXPECT_THAT(p, Key(25)); 1386 EXPECT_THAT(p, Not(Key(42))); 1387 EXPECT_THAT(p, Key(Ge(20))); 1388 EXPECT_THAT(p, Not(Key(Lt(25)))); 1389 } 1390 1391 TEST(KeyTest, WorksWithMoveOnly) { 1392 pair<std::unique_ptr<int>, std::unique_ptr<int>> p; 1393 EXPECT_THAT(p, Key(Eq(nullptr))); 1394 } 1395 1396 INSTANTIATE_GTEST_MATCHER_TEST_P(PairTest); 1397 1398 template <size_t I> 1399 struct Tag {}; 1400 1401 struct PairWithGet { 1402 int member_1; 1403 std::string member_2; 1404 using first_type = int; 1405 using second_type = std::string; 1406 1407 const int& GetImpl(Tag<0>) const { return member_1; } 1408 const std::string& GetImpl(Tag<1>) const { return member_2; } 1409 }; 1410 template <size_t I> 1411 auto get(const PairWithGet& value) -> decltype(value.GetImpl(Tag<I>())) { 1412 return value.GetImpl(Tag<I>()); 1413 } 1414 TEST(PairTest, MatchesPairWithGetCorrectly) { 1415 PairWithGet p{25, "foo"}; 1416 EXPECT_THAT(p, Key(25)); 1417 EXPECT_THAT(p, Not(Key(42))); 1418 EXPECT_THAT(p, Key(Ge(20))); 1419 EXPECT_THAT(p, Not(Key(Lt(25)))); 1420 1421 std::vector<PairWithGet> v = {{11, "Foo"}, {29, "gMockIsBestMock"}}; 1422 EXPECT_THAT(v, Contains(Key(29))); 1423 } 1424 1425 TEST(KeyTest, SafelyCastsInnerMatcher) { 1426 Matcher<int> is_positive = Gt(0); 1427 Matcher<int> is_negative = Lt(0); 1428 pair<char, bool> p('a', true); 1429 EXPECT_THAT(p, Key(is_positive)); 1430 EXPECT_THAT(p, Not(Key(is_negative))); 1431 } 1432 1433 TEST(KeyTest, InsideContainsUsingMap) { 1434 map<int, char> container; 1435 container.insert(make_pair(1, 'a')); 1436 container.insert(make_pair(2, 'b')); 1437 container.insert(make_pair(4, 'c')); 1438 EXPECT_THAT(container, Contains(Key(1))); 1439 EXPECT_THAT(container, Not(Contains(Key(3)))); 1440 } 1441 1442 TEST(KeyTest, InsideContainsUsingMultimap) { 1443 multimap<int, char> container; 1444 container.insert(make_pair(1, 'a')); 1445 container.insert(make_pair(2, 'b')); 1446 container.insert(make_pair(4, 'c')); 1447 1448 EXPECT_THAT(container, Not(Contains(Key(25)))); 1449 container.insert(make_pair(25, 'd')); 1450 EXPECT_THAT(container, Contains(Key(25))); 1451 container.insert(make_pair(25, 'e')); 1452 EXPECT_THAT(container, Contains(Key(25))); 1453 1454 EXPECT_THAT(container, Contains(Key(1))); 1455 EXPECT_THAT(container, Not(Contains(Key(3)))); 1456 } 1457 1458 TEST(PairTest, Typing) { 1459 // Test verifies the following type conversions can be compiled. 1460 Matcher<const pair<const char*, int>&> m1 = Pair("foo", 42); 1461 Matcher<const pair<const char*, int>> m2 = Pair("foo", 42); 1462 Matcher<pair<const char*, int>> m3 = Pair("foo", 42); 1463 1464 Matcher<pair<int, const std::string>> m4 = Pair(25, "42"); 1465 Matcher<pair<const std::string, int>> m5 = Pair("25", 42); 1466 } 1467 1468 TEST(PairTest, CanDescribeSelf) { 1469 Matcher<const pair<std::string, int>&> m1 = Pair("foo", 42); 1470 EXPECT_EQ( 1471 "has a first field that is equal to \"foo\"" 1472 ", and has a second field that is equal to 42", 1473 Describe(m1)); 1474 EXPECT_EQ( 1475 "has a first field that isn't equal to \"foo\"" 1476 ", or has a second field that isn't equal to 42", 1477 DescribeNegation(m1)); 1478 // Double and triple negation (1 or 2 times not and description of negation). 1479 Matcher<const pair<int, int>&> m2 = Not(Pair(Not(13), 42)); 1480 EXPECT_EQ( 1481 "has a first field that isn't equal to 13" 1482 ", and has a second field that is equal to 42", 1483 DescribeNegation(m2)); 1484 } 1485 1486 TEST_P(PairTestP, CanExplainMatchResultTo) { 1487 // If neither field matches, Pair() should explain about the first 1488 // field. 1489 const Matcher<pair<int, int>> m = Pair(GreaterThan(0), GreaterThan(0)); 1490 EXPECT_EQ("whose first field does not match, which is 1 less than 0", 1491 Explain(m, make_pair(-1, -2))); 1492 1493 // If the first field matches but the second doesn't, Pair() should 1494 // explain about the second field. 1495 EXPECT_EQ("whose second field does not match, which is 2 less than 0", 1496 Explain(m, make_pair(1, -2))); 1497 1498 // If the first field doesn't match but the second does, Pair() 1499 // should explain about the first field. 1500 EXPECT_EQ("whose first field does not match, which is 1 less than 0", 1501 Explain(m, make_pair(-1, 2))); 1502 1503 // If both fields match, Pair() should explain about them both. 1504 EXPECT_EQ( 1505 "whose both fields match, where the first field is a value " 1506 "which is 1 more than 0, and the second field is a value " 1507 "which is 2 more than 0", 1508 Explain(m, make_pair(1, 2))); 1509 1510 // If only the first match has an explanation, only this explanation should 1511 // be printed. 1512 const Matcher<pair<int, int>> explain_first = Pair(GreaterThan(0), 0); 1513 EXPECT_EQ( 1514 "whose both fields match, where the first field is a value " 1515 "which is 1 more than 0", 1516 Explain(explain_first, make_pair(1, 0))); 1517 1518 // If only the second match has an explanation, only this explanation should 1519 // be printed. 1520 const Matcher<pair<int, int>> explain_second = Pair(0, GreaterThan(0)); 1521 EXPECT_EQ( 1522 "whose both fields match, where the second field is a value " 1523 "which is 1 more than 0", 1524 Explain(explain_second, make_pair(0, 1))); 1525 } 1526 1527 TEST(PairTest, MatchesCorrectly) { 1528 pair<int, std::string> p(25, "foo"); 1529 1530 // Both fields match. 1531 EXPECT_THAT(p, Pair(25, "foo")); 1532 EXPECT_THAT(p, Pair(Ge(20), HasSubstr("o"))); 1533 1534 // 'first' doesn't match, but 'second' matches. 1535 EXPECT_THAT(p, Not(Pair(42, "foo"))); 1536 EXPECT_THAT(p, Not(Pair(Lt(25), "foo"))); 1537 1538 // 'first' matches, but 'second' doesn't match. 1539 EXPECT_THAT(p, Not(Pair(25, "bar"))); 1540 EXPECT_THAT(p, Not(Pair(25, Not("foo")))); 1541 1542 // Neither field matches. 1543 EXPECT_THAT(p, Not(Pair(13, "bar"))); 1544 EXPECT_THAT(p, Not(Pair(Lt(13), HasSubstr("a")))); 1545 } 1546 1547 TEST(PairTest, WorksWithMoveOnly) { 1548 pair<std::unique_ptr<int>, std::unique_ptr<int>> p; 1549 p.second = std::make_unique<int>(7); 1550 EXPECT_THAT(p, Pair(Eq(nullptr), Ne(nullptr))); 1551 } 1552 1553 TEST(PairTest, SafelyCastsInnerMatchers) { 1554 Matcher<int> is_positive = Gt(0); 1555 Matcher<int> is_negative = Lt(0); 1556 pair<char, bool> p('a', true); 1557 EXPECT_THAT(p, Pair(is_positive, _)); 1558 EXPECT_THAT(p, Not(Pair(is_negative, _))); 1559 EXPECT_THAT(p, Pair(_, is_positive)); 1560 EXPECT_THAT(p, Not(Pair(_, is_negative))); 1561 } 1562 1563 TEST(PairTest, InsideContainsUsingMap) { 1564 map<int, char> container; 1565 container.insert(make_pair(1, 'a')); 1566 container.insert(make_pair(2, 'b')); 1567 container.insert(make_pair(4, 'c')); 1568 EXPECT_THAT(container, Contains(Pair(1, 'a'))); 1569 EXPECT_THAT(container, Contains(Pair(1, _))); 1570 EXPECT_THAT(container, Contains(Pair(_, 'a'))); 1571 EXPECT_THAT(container, Not(Contains(Pair(3, _)))); 1572 } 1573 1574 INSTANTIATE_GTEST_MATCHER_TEST_P(FieldsAreTest); 1575 1576 TEST(FieldsAreTest, MatchesCorrectly) { 1577 std::tuple<int, std::string, double> p(25, "foo", .5); 1578 1579 // All fields match. 1580 EXPECT_THAT(p, FieldsAre(25, "foo", .5)); 1581 EXPECT_THAT(p, FieldsAre(Ge(20), HasSubstr("o"), DoubleEq(.5))); 1582 1583 // Some don't match. 1584 EXPECT_THAT(p, Not(FieldsAre(26, "foo", .5))); 1585 EXPECT_THAT(p, Not(FieldsAre(25, "fo", .5))); 1586 EXPECT_THAT(p, Not(FieldsAre(25, "foo", .6))); 1587 } 1588 1589 TEST(FieldsAreTest, CanDescribeSelf) { 1590 Matcher<const pair<std::string, int>&> m1 = FieldsAre("foo", 42); 1591 EXPECT_EQ( 1592 "has field #0 that is equal to \"foo\"" 1593 ", and has field #1 that is equal to 42", 1594 Describe(m1)); 1595 EXPECT_EQ( 1596 "has field #0 that isn't equal to \"foo\"" 1597 ", or has field #1 that isn't equal to 42", 1598 DescribeNegation(m1)); 1599 } 1600 1601 TEST_P(FieldsAreTestP, CanExplainMatchResultTo) { 1602 // The first one that fails is the one that gives the error. 1603 Matcher<std::tuple<int, int, int>> m = 1604 FieldsAre(GreaterThan(0), GreaterThan(0), GreaterThan(0)); 1605 1606 EXPECT_EQ("whose field #0 does not match, which is 1 less than 0", 1607 Explain(m, std::make_tuple(-1, -2, -3))); 1608 EXPECT_EQ("whose field #1 does not match, which is 2 less than 0", 1609 Explain(m, std::make_tuple(1, -2, -3))); 1610 EXPECT_EQ("whose field #2 does not match, which is 3 less than 0", 1611 Explain(m, std::make_tuple(1, 2, -3))); 1612 1613 // If they all match, we get a long explanation of success. 1614 EXPECT_EQ( 1615 "whose all elements match, " 1616 "where field #0 is a value which is 1 more than 0" 1617 ", and field #1 is a value which is 2 more than 0" 1618 ", and field #2 is a value which is 3 more than 0", 1619 Explain(m, std::make_tuple(1, 2, 3))); 1620 1621 // Only print those that have an explanation. 1622 m = FieldsAre(GreaterThan(0), 0, GreaterThan(0)); 1623 EXPECT_EQ( 1624 "whose all elements match, " 1625 "where field #0 is a value which is 1 more than 0" 1626 ", and field #2 is a value which is 3 more than 0", 1627 Explain(m, std::make_tuple(1, 0, 3))); 1628 1629 // If only one has an explanation, then print that one. 1630 m = FieldsAre(0, GreaterThan(0), 0); 1631 EXPECT_EQ( 1632 "whose all elements match, " 1633 "where field #1 is a value which is 1 more than 0", 1634 Explain(m, std::make_tuple(0, 1, 0))); 1635 } 1636 1637 #if defined(__cpp_structured_bindings) && __cpp_structured_bindings >= 201606 1638 TEST(FieldsAreTest, StructuredBindings) { 1639 // testing::FieldsAre can also match aggregates and such with C++17 and up. 1640 struct MyType { 1641 int i; 1642 std::string str; 1643 }; 1644 EXPECT_THAT((MyType{17, "foo"}), FieldsAre(Eq(17), HasSubstr("oo"))); 1645 1646 // Test all the supported arities. 1647 struct MyVarType1 { 1648 int a; 1649 }; 1650 EXPECT_THAT(MyVarType1{}, FieldsAre(0)); 1651 struct MyVarType2 { 1652 int a, b; 1653 }; 1654 EXPECT_THAT(MyVarType2{}, FieldsAre(0, 0)); 1655 struct MyVarType3 { 1656 int a, b, c; 1657 }; 1658 EXPECT_THAT(MyVarType3{}, FieldsAre(0, 0, 0)); 1659 struct MyVarType4 { 1660 int a, b, c, d; 1661 }; 1662 EXPECT_THAT(MyVarType4{}, FieldsAre(0, 0, 0, 0)); 1663 struct MyVarType5 { 1664 int a, b, c, d, e; 1665 }; 1666 EXPECT_THAT(MyVarType5{}, FieldsAre(0, 0, 0, 0, 0)); 1667 struct MyVarType6 { 1668 int a, b, c, d, e, f; 1669 }; 1670 EXPECT_THAT(MyVarType6{}, FieldsAre(0, 0, 0, 0, 0, 0)); 1671 struct MyVarType7 { 1672 int a, b, c, d, e, f, g; 1673 }; 1674 EXPECT_THAT(MyVarType7{}, FieldsAre(0, 0, 0, 0, 0, 0, 0)); 1675 struct MyVarType8 { 1676 int a, b, c, d, e, f, g, h; 1677 }; 1678 EXPECT_THAT(MyVarType8{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0)); 1679 struct MyVarType9 { 1680 int a, b, c, d, e, f, g, h, i; 1681 }; 1682 EXPECT_THAT(MyVarType9{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0)); 1683 struct MyVarType10 { 1684 int a, b, c, d, e, f, g, h, i, j; 1685 }; 1686 EXPECT_THAT(MyVarType10{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1687 struct MyVarType11 { 1688 int a, b, c, d, e, f, g, h, i, j, k; 1689 }; 1690 EXPECT_THAT(MyVarType11{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1691 struct MyVarType12 { 1692 int a, b, c, d, e, f, g, h, i, j, k, l; 1693 }; 1694 EXPECT_THAT(MyVarType12{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1695 struct MyVarType13 { 1696 int a, b, c, d, e, f, g, h, i, j, k, l, m; 1697 }; 1698 EXPECT_THAT(MyVarType13{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1699 struct MyVarType14 { 1700 int a, b, c, d, e, f, g, h, i, j, k, l, m, n; 1701 }; 1702 EXPECT_THAT(MyVarType14{}, 1703 FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1704 struct MyVarType15 { 1705 int a, b, c, d, e, f, g, h, i, j, k, l, m, n, o; 1706 }; 1707 EXPECT_THAT(MyVarType15{}, 1708 FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1709 struct MyVarType16 { 1710 int a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p; 1711 }; 1712 EXPECT_THAT(MyVarType16{}, 1713 FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1714 struct MyVarType17 { 1715 int a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q; 1716 }; 1717 EXPECT_THAT(MyVarType17{}, 1718 FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1719 struct MyVarType18 { 1720 int a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r; 1721 }; 1722 EXPECT_THAT(MyVarType18{}, 1723 FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0)); 1724 struct MyVarType19 { 1725 int a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s; 1726 }; 1727 EXPECT_THAT(MyVarType19{}, FieldsAre(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1728 0, 0, 0, 0, 0)); 1729 } 1730 #endif 1731 1732 TEST(PairTest, UseGetInsteadOfMembers) { 1733 PairWithGet pair{7, "ABC"}; 1734 EXPECT_THAT(pair, Pair(7, "ABC")); 1735 EXPECT_THAT(pair, Pair(Ge(7), HasSubstr("AB"))); 1736 EXPECT_THAT(pair, Not(Pair(Lt(7), "ABC"))); 1737 1738 std::vector<PairWithGet> v = {{11, "Foo"}, {29, "gMockIsBestMock"}}; 1739 EXPECT_THAT(v, 1740 ElementsAre(Pair(11, std::string("Foo")), Pair(Ge(10), Not("")))); 1741 } 1742 1743 // Tests StartsWith(s). 1744 1745 TEST(StartsWithTest, MatchesStringWithGivenPrefix) { 1746 const Matcher<const char*> m1 = StartsWith(std::string("")); 1747 EXPECT_TRUE(m1.Matches("Hi")); 1748 EXPECT_TRUE(m1.Matches("")); 1749 EXPECT_FALSE(m1.Matches(nullptr)); 1750 1751 const Matcher<const std::string&> m2 = StartsWith("Hi"); 1752 EXPECT_TRUE(m2.Matches("Hi")); 1753 EXPECT_TRUE(m2.Matches("Hi Hi!")); 1754 EXPECT_TRUE(m2.Matches("High")); 1755 EXPECT_FALSE(m2.Matches("H")); 1756 EXPECT_FALSE(m2.Matches(" Hi")); 1757 1758 #if GTEST_INTERNAL_HAS_STRING_VIEW 1759 const Matcher<internal::StringView> m_empty = 1760 StartsWith(internal::StringView("")); 1761 EXPECT_TRUE(m_empty.Matches(internal::StringView())); 1762 EXPECT_TRUE(m_empty.Matches(internal::StringView(""))); 1763 EXPECT_TRUE(m_empty.Matches(internal::StringView("not empty"))); 1764 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1765 } 1766 1767 TEST(StartsWithTest, CanDescribeSelf) { 1768 Matcher<const std::string> m = StartsWith("Hi"); 1769 EXPECT_EQ("starts with \"Hi\"", Describe(m)); 1770 } 1771 1772 // Tests EndsWith(s). 1773 1774 TEST(EndsWithTest, MatchesStringWithGivenSuffix) { 1775 const Matcher<const char*> m1 = EndsWith(""); 1776 EXPECT_TRUE(m1.Matches("Hi")); 1777 EXPECT_TRUE(m1.Matches("")); 1778 EXPECT_FALSE(m1.Matches(nullptr)); 1779 1780 const Matcher<const std::string&> m2 = EndsWith(std::string("Hi")); 1781 EXPECT_TRUE(m2.Matches("Hi")); 1782 EXPECT_TRUE(m2.Matches("Wow Hi Hi")); 1783 EXPECT_TRUE(m2.Matches("Super Hi")); 1784 EXPECT_FALSE(m2.Matches("i")); 1785 EXPECT_FALSE(m2.Matches("Hi ")); 1786 1787 #if GTEST_INTERNAL_HAS_STRING_VIEW 1788 const Matcher<const internal::StringView&> m4 = 1789 EndsWith(internal::StringView("")); 1790 EXPECT_TRUE(m4.Matches("Hi")); 1791 EXPECT_TRUE(m4.Matches("")); 1792 EXPECT_TRUE(m4.Matches(internal::StringView())); 1793 EXPECT_TRUE(m4.Matches(internal::StringView(""))); 1794 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1795 } 1796 1797 TEST(EndsWithTest, CanDescribeSelf) { 1798 Matcher<const std::string> m = EndsWith("Hi"); 1799 EXPECT_EQ("ends with \"Hi\"", Describe(m)); 1800 } 1801 1802 // Tests WhenBase64Unescaped. 1803 1804 TEST(WhenBase64UnescapedTest, MatchesUnescapedBase64Strings) { 1805 const Matcher<const char*> m1 = WhenBase64Unescaped(EndsWith("!")); 1806 EXPECT_FALSE(m1.Matches("invalid base64")); 1807 EXPECT_FALSE(m1.Matches("aGVsbG8gd29ybGQ=")); // hello world 1808 EXPECT_TRUE(m1.Matches("aGVsbG8gd29ybGQh")); // hello world! 1809 EXPECT_TRUE(m1.Matches("+/-_IQ")); // \xfb\xff\xbf! 1810 1811 const Matcher<const std::string&> m2 = WhenBase64Unescaped(EndsWith("!")); 1812 EXPECT_FALSE(m2.Matches("invalid base64")); 1813 EXPECT_FALSE(m2.Matches("aGVsbG8gd29ybGQ=")); // hello world 1814 EXPECT_TRUE(m2.Matches("aGVsbG8gd29ybGQh")); // hello world! 1815 EXPECT_TRUE(m2.Matches("+/-_IQ")); // \xfb\xff\xbf! 1816 1817 #if GTEST_INTERNAL_HAS_STRING_VIEW 1818 const Matcher<const internal::StringView&> m3 = 1819 WhenBase64Unescaped(EndsWith("!")); 1820 EXPECT_FALSE(m3.Matches("invalid base64")); 1821 EXPECT_FALSE(m3.Matches("aGVsbG8gd29ybGQ=")); // hello world 1822 EXPECT_TRUE(m3.Matches("aGVsbG8gd29ybGQh")); // hello world! 1823 EXPECT_TRUE(m3.Matches("+/-_IQ")); // \xfb\xff\xbf! 1824 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1825 } 1826 1827 TEST(WhenBase64UnescapedTest, CanDescribeSelf) { 1828 const Matcher<const char*> m = WhenBase64Unescaped(EndsWith("!")); 1829 EXPECT_EQ("matches after Base64Unescape ends with \"!\"", Describe(m)); 1830 } 1831 1832 // Tests MatchesRegex(). 1833 1834 TEST(MatchesRegexTest, MatchesStringMatchingGivenRegex) { 1835 const Matcher<const char*> m1 = MatchesRegex("a.*z"); 1836 EXPECT_TRUE(m1.Matches("az")); 1837 EXPECT_TRUE(m1.Matches("abcz")); 1838 EXPECT_FALSE(m1.Matches(nullptr)); 1839 1840 const Matcher<const std::string&> m2 = MatchesRegex(new RE("a.*z")); 1841 EXPECT_TRUE(m2.Matches("azbz")); 1842 EXPECT_FALSE(m2.Matches("az1")); 1843 EXPECT_FALSE(m2.Matches("1az")); 1844 1845 #if GTEST_INTERNAL_HAS_STRING_VIEW 1846 const Matcher<const internal::StringView&> m3 = MatchesRegex("a.*z"); 1847 EXPECT_TRUE(m3.Matches(internal::StringView("az"))); 1848 EXPECT_TRUE(m3.Matches(internal::StringView("abcz"))); 1849 EXPECT_FALSE(m3.Matches(internal::StringView("1az"))); 1850 EXPECT_FALSE(m3.Matches(internal::StringView())); 1851 const Matcher<const internal::StringView&> m4 = 1852 MatchesRegex(internal::StringView("")); 1853 EXPECT_TRUE(m4.Matches(internal::StringView(""))); 1854 EXPECT_TRUE(m4.Matches(internal::StringView())); 1855 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1856 } 1857 1858 TEST(MatchesRegexTest, CanDescribeSelf) { 1859 Matcher<const std::string> m1 = MatchesRegex(std::string("Hi.*")); 1860 EXPECT_EQ("matches regular expression \"Hi.*\"", Describe(m1)); 1861 1862 Matcher<const char*> m2 = MatchesRegex(new RE("a.*")); 1863 EXPECT_EQ("matches regular expression \"a.*\"", Describe(m2)); 1864 1865 #if GTEST_INTERNAL_HAS_STRING_VIEW 1866 Matcher<const internal::StringView> m3 = MatchesRegex(new RE("0.*")); 1867 EXPECT_EQ("matches regular expression \"0.*\"", Describe(m3)); 1868 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1869 } 1870 1871 // Tests ContainsRegex(). 1872 1873 TEST(ContainsRegexTest, MatchesStringContainingGivenRegex) { 1874 const Matcher<const char*> m1 = ContainsRegex(std::string("a.*z")); 1875 EXPECT_TRUE(m1.Matches("az")); 1876 EXPECT_TRUE(m1.Matches("0abcz1")); 1877 EXPECT_FALSE(m1.Matches(nullptr)); 1878 1879 const Matcher<const std::string&> m2 = ContainsRegex(new RE("a.*z")); 1880 EXPECT_TRUE(m2.Matches("azbz")); 1881 EXPECT_TRUE(m2.Matches("az1")); 1882 EXPECT_FALSE(m2.Matches("1a")); 1883 1884 #if GTEST_INTERNAL_HAS_STRING_VIEW 1885 const Matcher<const internal::StringView&> m3 = ContainsRegex(new RE("a.*z")); 1886 EXPECT_TRUE(m3.Matches(internal::StringView("azbz"))); 1887 EXPECT_TRUE(m3.Matches(internal::StringView("az1"))); 1888 EXPECT_FALSE(m3.Matches(internal::StringView("1a"))); 1889 EXPECT_FALSE(m3.Matches(internal::StringView())); 1890 const Matcher<const internal::StringView&> m4 = 1891 ContainsRegex(internal::StringView("")); 1892 EXPECT_TRUE(m4.Matches(internal::StringView(""))); 1893 EXPECT_TRUE(m4.Matches(internal::StringView())); 1894 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1895 } 1896 1897 TEST(ContainsRegexTest, CanDescribeSelf) { 1898 Matcher<const std::string> m1 = ContainsRegex("Hi.*"); 1899 EXPECT_EQ("contains regular expression \"Hi.*\"", Describe(m1)); 1900 1901 Matcher<const char*> m2 = ContainsRegex(new RE("a.*")); 1902 EXPECT_EQ("contains regular expression \"a.*\"", Describe(m2)); 1903 1904 #if GTEST_INTERNAL_HAS_STRING_VIEW 1905 Matcher<const internal::StringView> m3 = ContainsRegex(new RE("0.*")); 1906 EXPECT_EQ("contains regular expression \"0.*\"", Describe(m3)); 1907 #endif // GTEST_INTERNAL_HAS_STRING_VIEW 1908 } 1909 1910 // Tests for wide strings. 1911 #if GTEST_HAS_STD_WSTRING 1912 TEST(StdWideStrEqTest, MatchesEqual) { 1913 Matcher<const wchar_t*> m = StrEq(::std::wstring(L"Hello")); 1914 EXPECT_TRUE(m.Matches(L"Hello")); 1915 EXPECT_FALSE(m.Matches(L"hello")); 1916 EXPECT_FALSE(m.Matches(nullptr)); 1917 1918 Matcher<const ::std::wstring&> m2 = StrEq(L"Hello"); 1919 EXPECT_TRUE(m2.Matches(L"Hello")); 1920 EXPECT_FALSE(m2.Matches(L"Hi")); 1921 1922 Matcher<const ::std::wstring&> m3 = StrEq(L"\xD3\x576\x8D3\xC74D"); 1923 EXPECT_TRUE(m3.Matches(L"\xD3\x576\x8D3\xC74D")); 1924 EXPECT_FALSE(m3.Matches(L"\xD3\x576\x8D3\xC74E")); 1925 1926 ::std::wstring str(L"01204500800"); 1927 str[3] = L'\0'; 1928 Matcher<const ::std::wstring&> m4 = StrEq(str); 1929 EXPECT_TRUE(m4.Matches(str)); 1930 str[0] = str[6] = str[7] = str[9] = str[10] = L'\0'; 1931 Matcher<const ::std::wstring&> m5 = StrEq(str); 1932 EXPECT_TRUE(m5.Matches(str)); 1933 } 1934 1935 TEST(StdWideStrEqTest, CanDescribeSelf) { 1936 Matcher<::std::wstring> m = StrEq(L"Hi-\'\"?\\\a\b\f\n\r\t\v"); 1937 EXPECT_EQ("is equal to L\"Hi-\'\\\"?\\\\\\a\\b\\f\\n\\r\\t\\v\"", 1938 Describe(m)); 1939 1940 Matcher<::std::wstring> m2 = StrEq(L"\xD3\x576\x8D3\xC74D"); 1941 EXPECT_EQ("is equal to L\"\\xD3\\x576\\x8D3\\xC74D\"", Describe(m2)); 1942 1943 ::std::wstring str(L"01204500800"); 1944 str[3] = L'\0'; 1945 Matcher<const ::std::wstring&> m4 = StrEq(str); 1946 EXPECT_EQ("is equal to L\"012\\04500800\"", Describe(m4)); 1947 str[0] = str[6] = str[7] = str[9] = str[10] = L'\0'; 1948 Matcher<const ::std::wstring&> m5 = StrEq(str); 1949 EXPECT_EQ("is equal to L\"\\012\\045\\0\\08\\0\\0\"", Describe(m5)); 1950 } 1951 1952 TEST(StdWideStrNeTest, MatchesUnequalString) { 1953 Matcher<const wchar_t*> m = StrNe(L"Hello"); 1954 EXPECT_TRUE(m.Matches(L"")); 1955 EXPECT_TRUE(m.Matches(nullptr)); 1956 EXPECT_FALSE(m.Matches(L"Hello")); 1957 1958 Matcher<::std::wstring> m2 = StrNe(::std::wstring(L"Hello")); 1959 EXPECT_TRUE(m2.Matches(L"hello")); 1960 EXPECT_FALSE(m2.Matches(L"Hello")); 1961 } 1962 1963 TEST(StdWideStrNeTest, CanDescribeSelf) { 1964 Matcher<const wchar_t*> m = StrNe(L"Hi"); 1965 EXPECT_EQ("isn't equal to L\"Hi\"", Describe(m)); 1966 } 1967 1968 TEST(StdWideStrCaseEqTest, MatchesEqualStringIgnoringCase) { 1969 Matcher<const wchar_t*> m = StrCaseEq(::std::wstring(L"Hello")); 1970 EXPECT_TRUE(m.Matches(L"Hello")); 1971 EXPECT_TRUE(m.Matches(L"hello")); 1972 EXPECT_FALSE(m.Matches(L"Hi")); 1973 EXPECT_FALSE(m.Matches(nullptr)); 1974 1975 Matcher<const ::std::wstring&> m2 = StrCaseEq(L"Hello"); 1976 EXPECT_TRUE(m2.Matches(L"hello")); 1977 EXPECT_FALSE(m2.Matches(L"Hi")); 1978 } 1979 1980 TEST(StdWideStrCaseEqTest, MatchesEqualStringWith0IgnoringCase) { 1981 ::std::wstring str1(L"oabocdooeoo"); 1982 ::std::wstring str2(L"OABOCDOOEOO"); 1983 Matcher<const ::std::wstring&> m0 = StrCaseEq(str1); 1984 EXPECT_FALSE(m0.Matches(str2 + ::std::wstring(1, L'\0'))); 1985 1986 str1[3] = str2[3] = L'\0'; 1987 Matcher<const ::std::wstring&> m1 = StrCaseEq(str1); 1988 EXPECT_TRUE(m1.Matches(str2)); 1989 1990 str1[0] = str1[6] = str1[7] = str1[10] = L'\0'; 1991 str2[0] = str2[6] = str2[7] = str2[10] = L'\0'; 1992 Matcher<const ::std::wstring&> m2 = StrCaseEq(str1); 1993 str1[9] = str2[9] = L'\0'; 1994 EXPECT_FALSE(m2.Matches(str2)); 1995 1996 Matcher<const ::std::wstring&> m3 = StrCaseEq(str1); 1997 EXPECT_TRUE(m3.Matches(str2)); 1998 1999 EXPECT_FALSE(m3.Matches(str2 + L"x")); 2000 str2.append(1, L'\0'); 2001 EXPECT_FALSE(m3.Matches(str2)); 2002 EXPECT_FALSE(m3.Matches(::std::wstring(str2, 0, 9))); 2003 } 2004 2005 TEST(StdWideStrCaseEqTest, CanDescribeSelf) { 2006 Matcher<::std::wstring> m = StrCaseEq(L"Hi"); 2007 EXPECT_EQ("is equal to (ignoring case) L\"Hi\"", Describe(m)); 2008 } 2009 2010 TEST(StdWideStrCaseNeTest, MatchesUnequalStringIgnoringCase) { 2011 Matcher<const wchar_t*> m = StrCaseNe(L"Hello"); 2012 EXPECT_TRUE(m.Matches(L"Hi")); 2013 EXPECT_TRUE(m.Matches(nullptr)); 2014 EXPECT_FALSE(m.Matches(L"Hello")); 2015 EXPECT_FALSE(m.Matches(L"hello")); 2016 2017 Matcher<::std::wstring> m2 = StrCaseNe(::std::wstring(L"Hello")); 2018 EXPECT_TRUE(m2.Matches(L"")); 2019 EXPECT_FALSE(m2.Matches(L"Hello")); 2020 } 2021 2022 TEST(StdWideStrCaseNeTest, CanDescribeSelf) { 2023 Matcher<const wchar_t*> m = StrCaseNe(L"Hi"); 2024 EXPECT_EQ("isn't equal to (ignoring case) L\"Hi\"", Describe(m)); 2025 } 2026 2027 // Tests that HasSubstr() works for matching wstring-typed values. 2028 TEST(StdWideHasSubstrTest, WorksForStringClasses) { 2029 const Matcher<::std::wstring> m1 = HasSubstr(L"foo"); 2030 EXPECT_TRUE(m1.Matches(::std::wstring(L"I love food."))); 2031 EXPECT_FALSE(m1.Matches(::std::wstring(L"tofo"))); 2032 2033 const Matcher<const ::std::wstring&> m2 = HasSubstr(L"foo"); 2034 EXPECT_TRUE(m2.Matches(::std::wstring(L"I love food."))); 2035 EXPECT_FALSE(m2.Matches(::std::wstring(L"tofo"))); 2036 } 2037 2038 // Tests that HasSubstr() works for matching C-wide-string-typed values. 2039 TEST(StdWideHasSubstrTest, WorksForCStrings) { 2040 const Matcher<wchar_t*> m1 = HasSubstr(L"foo"); 2041 EXPECT_TRUE(m1.Matches(const_cast<wchar_t*>(L"I love food."))); 2042 EXPECT_FALSE(m1.Matches(const_cast<wchar_t*>(L"tofo"))); 2043 EXPECT_FALSE(m1.Matches(nullptr)); 2044 2045 const Matcher<const wchar_t*> m2 = HasSubstr(L"foo"); 2046 EXPECT_TRUE(m2.Matches(L"I love food.")); 2047 EXPECT_FALSE(m2.Matches(L"tofo")); 2048 EXPECT_FALSE(m2.Matches(nullptr)); 2049 } 2050 2051 // Tests that HasSubstr(s) describes itself properly. 2052 TEST(StdWideHasSubstrTest, CanDescribeSelf) { 2053 Matcher<::std::wstring> m = HasSubstr(L"foo\n\""); 2054 EXPECT_EQ("has substring L\"foo\\n\\\"\"", Describe(m)); 2055 } 2056 2057 // Tests StartsWith(s). 2058 2059 TEST(StdWideStartsWithTest, MatchesStringWithGivenPrefix) { 2060 const Matcher<const wchar_t*> m1 = StartsWith(::std::wstring(L"")); 2061 EXPECT_TRUE(m1.Matches(L"Hi")); 2062 EXPECT_TRUE(m1.Matches(L"")); 2063 EXPECT_FALSE(m1.Matches(nullptr)); 2064 2065 const Matcher<const ::std::wstring&> m2 = StartsWith(L"Hi"); 2066 EXPECT_TRUE(m2.Matches(L"Hi")); 2067 EXPECT_TRUE(m2.Matches(L"Hi Hi!")); 2068 EXPECT_TRUE(m2.Matches(L"High")); 2069 EXPECT_FALSE(m2.Matches(L"H")); 2070 EXPECT_FALSE(m2.Matches(L" Hi")); 2071 } 2072 2073 TEST(StdWideStartsWithTest, CanDescribeSelf) { 2074 Matcher<const ::std::wstring> m = StartsWith(L"Hi"); 2075 EXPECT_EQ("starts with L\"Hi\"", Describe(m)); 2076 } 2077 2078 // Tests EndsWith(s). 2079 2080 TEST(StdWideEndsWithTest, MatchesStringWithGivenSuffix) { 2081 const Matcher<const wchar_t*> m1 = EndsWith(L""); 2082 EXPECT_TRUE(m1.Matches(L"Hi")); 2083 EXPECT_TRUE(m1.Matches(L"")); 2084 EXPECT_FALSE(m1.Matches(nullptr)); 2085 2086 const Matcher<const ::std::wstring&> m2 = EndsWith(::std::wstring(L"Hi")); 2087 EXPECT_TRUE(m2.Matches(L"Hi")); 2088 EXPECT_TRUE(m2.Matches(L"Wow Hi Hi")); 2089 EXPECT_TRUE(m2.Matches(L"Super Hi")); 2090 EXPECT_FALSE(m2.Matches(L"i")); 2091 EXPECT_FALSE(m2.Matches(L"Hi ")); 2092 } 2093 2094 TEST(StdWideEndsWithTest, CanDescribeSelf) { 2095 Matcher<const ::std::wstring> m = EndsWith(L"Hi"); 2096 EXPECT_EQ("ends with L\"Hi\"", Describe(m)); 2097 } 2098 2099 #endif // GTEST_HAS_STD_WSTRING 2100 2101 TEST(ExplainMatchResultTest, WorksWithPolymorphicMatcher) { 2102 StringMatchResultListener listener1; 2103 EXPECT_TRUE(ExplainMatchResult(PolymorphicIsEven(), 42, &listener1)); 2104 EXPECT_EQ("% 2 == 0", listener1.str()); 2105 2106 StringMatchResultListener listener2; 2107 EXPECT_FALSE(ExplainMatchResult(Ge(42), 1.5, &listener2)); 2108 EXPECT_EQ("", listener2.str()); 2109 } 2110 2111 TEST(ExplainMatchResultTest, WorksWithMonomorphicMatcher) { 2112 const Matcher<int> is_even = PolymorphicIsEven(); 2113 StringMatchResultListener listener1; 2114 EXPECT_TRUE(ExplainMatchResult(is_even, 42, &listener1)); 2115 EXPECT_EQ("% 2 == 0", listener1.str()); 2116 2117 const Matcher<const double&> is_zero = Eq(0); 2118 StringMatchResultListener listener2; 2119 EXPECT_FALSE(ExplainMatchResult(is_zero, 1.5, &listener2)); 2120 EXPECT_EQ("", listener2.str()); 2121 } 2122 2123 MATCHER(ConstructNoArg, "") { return true; } 2124 MATCHER_P(Construct1Arg, arg1, "") { return true; } 2125 MATCHER_P2(Construct2Args, arg1, arg2, "") { return true; } 2126 2127 TEST(MatcherConstruct, ExplicitVsImplicit) { 2128 { 2129 // No arg constructor can be constructed with empty brace. 2130 ConstructNoArgMatcher m = {}; 2131 (void)m; 2132 // And with no args 2133 ConstructNoArgMatcher m2; 2134 (void)m2; 2135 } 2136 { 2137 // The one arg constructor has an explicit constructor. 2138 // This is to prevent the implicit conversion. 2139 using M = Construct1ArgMatcherP<int>; 2140 EXPECT_TRUE((std::is_constructible<M, int>::value)); 2141 EXPECT_FALSE((std::is_convertible<int, M>::value)); 2142 } 2143 { 2144 // Multiple arg matchers can be constructed with an implicit construction. 2145 Construct2ArgsMatcherP2<int, double> m = {1, 2.2}; 2146 (void)m; 2147 } 2148 } 2149 2150 MATCHER_P(Really, inner_matcher, "") { 2151 return ExplainMatchResult(inner_matcher, arg, result_listener); 2152 } 2153 2154 TEST(ExplainMatchResultTest, WorksInsideMATCHER) { 2155 EXPECT_THAT(0, Really(Eq(0))); 2156 } 2157 2158 TEST(DescribeMatcherTest, WorksWithValue) { 2159 EXPECT_EQ("is equal to 42", DescribeMatcher<int>(42)); 2160 EXPECT_EQ("isn't equal to 42", DescribeMatcher<int>(42, true)); 2161 } 2162 2163 TEST(DescribeMatcherTest, WorksWithMonomorphicMatcher) { 2164 const Matcher<int> monomorphic = Le(0); 2165 EXPECT_EQ("is <= 0", DescribeMatcher<int>(monomorphic)); 2166 EXPECT_EQ("isn't <= 0", DescribeMatcher<int>(monomorphic, true)); 2167 } 2168 2169 TEST(DescribeMatcherTest, WorksWithPolymorphicMatcher) { 2170 EXPECT_EQ("is even", DescribeMatcher<int>(PolymorphicIsEven())); 2171 EXPECT_EQ("is odd", DescribeMatcher<int>(PolymorphicIsEven(), true)); 2172 } 2173 2174 MATCHER_P(FieldIIs, inner_matcher, "") { 2175 return ExplainMatchResult(inner_matcher, arg.i, result_listener); 2176 } 2177 2178 #if GTEST_HAS_RTTI 2179 TEST(WhenDynamicCastToTest, SameType) { 2180 Derived derived; 2181 derived.i = 4; 2182 2183 // Right type. A pointer is passed down. 2184 Base* as_base_ptr = &derived; 2185 EXPECT_THAT(as_base_ptr, WhenDynamicCastTo<Derived*>(Not(IsNull()))); 2186 EXPECT_THAT(as_base_ptr, WhenDynamicCastTo<Derived*>(Pointee(FieldIIs(4)))); 2187 EXPECT_THAT(as_base_ptr, 2188 Not(WhenDynamicCastTo<Derived*>(Pointee(FieldIIs(5))))); 2189 } 2190 2191 TEST(WhenDynamicCastToTest, WrongTypes) { 2192 Base base; 2193 Derived derived; 2194 OtherDerived other_derived; 2195 2196 // Wrong types. NULL is passed. 2197 EXPECT_THAT(&base, Not(WhenDynamicCastTo<Derived*>(Pointee(_)))); 2198 EXPECT_THAT(&base, WhenDynamicCastTo<Derived*>(IsNull())); 2199 Base* as_base_ptr = &derived; 2200 EXPECT_THAT(as_base_ptr, Not(WhenDynamicCastTo<OtherDerived*>(Pointee(_)))); 2201 EXPECT_THAT(as_base_ptr, WhenDynamicCastTo<OtherDerived*>(IsNull())); 2202 as_base_ptr = &other_derived; 2203 EXPECT_THAT(as_base_ptr, Not(WhenDynamicCastTo<Derived*>(Pointee(_)))); 2204 EXPECT_THAT(as_base_ptr, WhenDynamicCastTo<Derived*>(IsNull())); 2205 } 2206 2207 TEST(WhenDynamicCastToTest, AlreadyNull) { 2208 // Already NULL. 2209 Base* as_base_ptr = nullptr; 2210 EXPECT_THAT(as_base_ptr, WhenDynamicCastTo<Derived*>(IsNull())); 2211 } 2212 2213 struct AmbiguousCastTypes { 2214 class VirtualDerived : public virtual Base {}; 2215 class DerivedSub1 : public VirtualDerived {}; 2216 class DerivedSub2 : public VirtualDerived {}; 2217 class ManyDerivedInHierarchy : public DerivedSub1, public DerivedSub2 {}; 2218 }; 2219 2220 TEST(WhenDynamicCastToTest, AmbiguousCast) { 2221 AmbiguousCastTypes::DerivedSub1 sub1; 2222 AmbiguousCastTypes::ManyDerivedInHierarchy many_derived; 2223 2224 // This testcase fails on FreeBSD. See this GitHub issue for more details: 2225 // https://github.com/google/googletest/issues/2172 2226 #ifdef __FreeBSD__ 2227 EXPECT_NONFATAL_FAILURE({ 2228 #endif 2229 // Multiply derived from Base. dynamic_cast<> returns NULL. 2230 Base* as_base_ptr = 2231 static_cast<AmbiguousCastTypes::DerivedSub1*>(&many_derived); 2232 2233 EXPECT_THAT(as_base_ptr, 2234 WhenDynamicCastTo<AmbiguousCastTypes::VirtualDerived*>(IsNull())); 2235 as_base_ptr = &sub1; 2236 EXPECT_THAT( 2237 as_base_ptr, 2238 WhenDynamicCastTo<AmbiguousCastTypes::VirtualDerived*>(Not(IsNull()))); 2239 #ifdef __FreeBSD__ 2240 }, ""); 2241 #endif 2242 } 2243 2244 TEST(WhenDynamicCastToTest, Describe) { 2245 Matcher<Base*> matcher = WhenDynamicCastTo<Derived*>(Pointee(_)); 2246 const std::string prefix = 2247 "when dynamic_cast to " + internal::GetTypeName<Derived*>() + ", "; 2248 EXPECT_EQ(prefix + "points to a value that is anything", Describe(matcher)); 2249 EXPECT_EQ(prefix + "does not point to a value that is anything", 2250 DescribeNegation(matcher)); 2251 } 2252 2253 TEST(WhenDynamicCastToTest, Explain) { 2254 Matcher<Base*> matcher = WhenDynamicCastTo<Derived*>(Pointee(_)); 2255 Base* null = nullptr; 2256 EXPECT_THAT(Explain(matcher, null), HasSubstr("NULL")); 2257 Derived derived; 2258 EXPECT_TRUE(matcher.Matches(&derived)); 2259 EXPECT_THAT(Explain(matcher, &derived), HasSubstr("which points to ")); 2260 2261 // With references, the matcher itself can fail. Test for that one. 2262 Matcher<const Base&> ref_matcher = WhenDynamicCastTo<const OtherDerived&>(_); 2263 EXPECT_THAT(Explain(ref_matcher, derived), 2264 HasSubstr("which cannot be dynamic_cast")); 2265 } 2266 2267 TEST(WhenDynamicCastToTest, GoodReference) { 2268 Derived derived; 2269 derived.i = 4; 2270 Base& as_base_ref = derived; 2271 EXPECT_THAT(as_base_ref, WhenDynamicCastTo<const Derived&>(FieldIIs(4))); 2272 EXPECT_THAT(as_base_ref, WhenDynamicCastTo<const Derived&>(Not(FieldIIs(5)))); 2273 } 2274 2275 TEST(WhenDynamicCastToTest, BadReference) { 2276 Derived derived; 2277 Base& as_base_ref = derived; 2278 EXPECT_THAT(as_base_ref, Not(WhenDynamicCastTo<const OtherDerived&>(_))); 2279 } 2280 #endif // GTEST_HAS_RTTI 2281 2282 class DivisibleByImpl { 2283 public: 2284 explicit DivisibleByImpl(int a_divider) : divider_(a_divider) {} 2285 2286 // For testing using ExplainMatchResultTo() with polymorphic matchers. 2287 template <typename T> 2288 bool MatchAndExplain(const T& n, MatchResultListener* listener) const { 2289 *listener << "which is " << (n % divider_) << " modulo " << divider_; 2290 return (n % divider_) == 0; 2291 } 2292 2293 void DescribeTo(ostream* os) const { *os << "is divisible by " << divider_; } 2294 2295 void DescribeNegationTo(ostream* os) const { 2296 *os << "is not divisible by " << divider_; 2297 } 2298 2299 void set_divider(int a_divider) { divider_ = a_divider; } 2300 int divider() const { return divider_; } 2301 2302 private: 2303 int divider_; 2304 }; 2305 2306 PolymorphicMatcher<DivisibleByImpl> DivisibleBy(int n) { 2307 return MakePolymorphicMatcher(DivisibleByImpl(n)); 2308 } 2309 2310 // Tests that when AllOf() fails, only the first failing matcher is 2311 // asked to explain why. 2312 TEST(ExplainMatchResultTest, AllOf_False_False) { 2313 const Matcher<int> m = AllOf(DivisibleBy(4), DivisibleBy(3)); 2314 EXPECT_EQ("which is 1 modulo 4", Explain(m, 5)); 2315 } 2316 2317 // Tests that when AllOf() fails, only the first failing matcher is 2318 // asked to explain why. 2319 TEST(ExplainMatchResultTest, AllOf_False_True) { 2320 const Matcher<int> m = AllOf(DivisibleBy(4), DivisibleBy(3)); 2321 EXPECT_EQ("which is 2 modulo 4", Explain(m, 6)); 2322 } 2323 2324 // Tests that when AllOf() fails, only the first failing matcher is 2325 // asked to explain why. 2326 TEST(ExplainMatchResultTest, AllOf_True_False) { 2327 const Matcher<int> m = AllOf(Ge(1), DivisibleBy(3)); 2328 EXPECT_EQ("which is 2 modulo 3", Explain(m, 5)); 2329 } 2330 2331 // Tests that when AllOf() succeeds, all matchers are asked to explain 2332 // why. 2333 TEST(ExplainMatchResultTest, AllOf_True_True) { 2334 const Matcher<int> m = AllOf(DivisibleBy(2), DivisibleBy(3)); 2335 EXPECT_EQ("which is 0 modulo 2, and which is 0 modulo 3", Explain(m, 6)); 2336 } 2337 2338 TEST(ExplainMatchResultTest, AllOf_True_True_2) { 2339 const Matcher<int> m = AllOf(Ge(2), Le(3)); 2340 EXPECT_EQ("", Explain(m, 2)); 2341 } 2342 2343 INSTANTIATE_GTEST_MATCHER_TEST_P(ExplainmatcherResultTest); 2344 2345 TEST_P(ExplainmatcherResultTestP, MonomorphicMatcher) { 2346 const Matcher<int> m = GreaterThan(5); 2347 EXPECT_EQ("which is 1 more than 5", Explain(m, 6)); 2348 } 2349 2350 // Tests PolymorphicMatcher::mutable_impl(). 2351 TEST(PolymorphicMatcherTest, CanAccessMutableImpl) { 2352 PolymorphicMatcher<DivisibleByImpl> m(DivisibleByImpl(42)); 2353 DivisibleByImpl& impl = m.mutable_impl(); 2354 EXPECT_EQ(42, impl.divider()); 2355 2356 impl.set_divider(0); 2357 EXPECT_EQ(0, m.mutable_impl().divider()); 2358 } 2359 2360 // Tests PolymorphicMatcher::impl(). 2361 TEST(PolymorphicMatcherTest, CanAccessImpl) { 2362 const PolymorphicMatcher<DivisibleByImpl> m(DivisibleByImpl(42)); 2363 const DivisibleByImpl& impl = m.impl(); 2364 EXPECT_EQ(42, impl.divider()); 2365 } 2366 2367 } // namespace 2368 } // namespace gmock_matchers_test 2369 } // namespace testing 2370 2371 GTEST_DISABLE_MSC_WARNINGS_POP_() // 4244 4100 2372