Home | History | Annotate | Download | only in test
      1 // Copyright 2008, 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 the built-in matchers generated by a script.
     33 
     34 #include "gmock/gmock-generated-matchers.h"
     35 
     36 #include <list>
     37 #include <map>
     38 #include <set>
     39 #include <sstream>
     40 #include <string>
     41 #include <utility>
     42 #include <vector>
     43 
     44 #include "gmock/gmock.h"
     45 #include "gtest/gtest.h"
     46 #include "gtest/gtest-spi.h"
     47 
     48 namespace {
     49 
     50 using std::list;
     51 using std::map;
     52 using std::pair;
     53 using std::set;
     54 using std::stringstream;
     55 using std::vector;
     56 using testing::get;
     57 using testing::make_tuple;
     58 using testing::tuple;
     59 using testing::_;
     60 using testing::Args;
     61 using testing::Contains;
     62 using testing::ElementsAre;
     63 using testing::ElementsAreArray;
     64 using testing::Eq;
     65 using testing::Ge;
     66 using testing::Gt;
     67 using testing::Le;
     68 using testing::Lt;
     69 using testing::MakeMatcher;
     70 using testing::Matcher;
     71 using testing::MatcherInterface;
     72 using testing::MatchResultListener;
     73 using testing::Ne;
     74 using testing::Not;
     75 using testing::Pointee;
     76 using testing::PrintToString;
     77 using testing::Ref;
     78 using testing::StaticAssertTypeEq;
     79 using testing::StrEq;
     80 using testing::Value;
     81 using testing::internal::ElementsAreArrayMatcher;
     82 
     83 // Returns the description of the given matcher.
     84 template <typename T>
     85 std::string Describe(const Matcher<T>& m) {
     86   stringstream ss;
     87   m.DescribeTo(&ss);
     88   return ss.str();
     89 }
     90 
     91 // Returns the description of the negation of the given matcher.
     92 template <typename T>
     93 std::string DescribeNegation(const Matcher<T>& m) {
     94   stringstream ss;
     95   m.DescribeNegationTo(&ss);
     96   return ss.str();
     97 }
     98 
     99 // Returns the reason why x matches, or doesn't match, m.
    100 template <typename MatcherType, typename Value>
    101 std::string Explain(const MatcherType& m, const Value& x) {
    102   stringstream ss;
    103   m.ExplainMatchResultTo(x, &ss);
    104   return ss.str();
    105 }
    106 
    107 // Tests Args<k0, ..., kn>(m).
    108 
    109 TEST(ArgsTest, AcceptsZeroTemplateArg) {
    110   const tuple<int, bool> t(5, true);
    111   EXPECT_THAT(t, Args<>(Eq(tuple<>())));
    112   EXPECT_THAT(t, Not(Args<>(Ne(tuple<>()))));
    113 }
    114 
    115 TEST(ArgsTest, AcceptsOneTemplateArg) {
    116   const tuple<int, bool> t(5, true);
    117   EXPECT_THAT(t, Args<0>(Eq(make_tuple(5))));
    118   EXPECT_THAT(t, Args<1>(Eq(make_tuple(true))));
    119   EXPECT_THAT(t, Not(Args<1>(Eq(make_tuple(false)))));
    120 }
    121 
    122 TEST(ArgsTest, AcceptsTwoTemplateArgs) {
    123   const tuple<short, int, long> t(4, 5, 6L);  // NOLINT
    124 
    125   EXPECT_THAT(t, (Args<0, 1>(Lt())));
    126   EXPECT_THAT(t, (Args<1, 2>(Lt())));
    127   EXPECT_THAT(t, Not(Args<0, 2>(Gt())));
    128 }
    129 
    130 TEST(ArgsTest, AcceptsRepeatedTemplateArgs) {
    131   const tuple<short, int, long> t(4, 5, 6L);  // NOLINT
    132   EXPECT_THAT(t, (Args<0, 0>(Eq())));
    133   EXPECT_THAT(t, Not(Args<1, 1>(Ne())));
    134 }
    135 
    136 TEST(ArgsTest, AcceptsDecreasingTemplateArgs) {
    137   const tuple<short, int, long> t(4, 5, 6L);  // NOLINT
    138   EXPECT_THAT(t, (Args<2, 0>(Gt())));
    139   EXPECT_THAT(t, Not(Args<2, 1>(Lt())));
    140 }
    141 
    142 // The MATCHER*() macros trigger warning C4100 (unreferenced formal
    143 // parameter) in MSVC with -W4.  Unfortunately they cannot be fixed in
    144 // the macro definition, as the warnings are generated when the macro
    145 // is expanded and macro expansion cannot contain #pragma.  Therefore
    146 // we suppress them here.
    147 #ifdef _MSC_VER
    148 # pragma warning(push)
    149 # pragma warning(disable:4100)
    150 #endif
    151 
    152 MATCHER(SumIsZero, "") {
    153   return get<0>(arg) + get<1>(arg) + get<2>(arg) == 0;
    154 }
    155 
    156 TEST(ArgsTest, AcceptsMoreTemplateArgsThanArityOfOriginalTuple) {
    157   EXPECT_THAT(make_tuple(-1, 2), (Args<0, 0, 1>(SumIsZero())));
    158   EXPECT_THAT(make_tuple(1, 2), Not(Args<0, 0, 1>(SumIsZero())));
    159 }
    160 
    161 TEST(ArgsTest, CanBeNested) {
    162   const tuple<short, int, long, int> t(4, 5, 6L, 6);  // NOLINT
    163   EXPECT_THAT(t, (Args<1, 2, 3>(Args<1, 2>(Eq()))));
    164   EXPECT_THAT(t, (Args<0, 1, 3>(Args<0, 2>(Lt()))));
    165 }
    166 
    167 TEST(ArgsTest, CanMatchTupleByValue) {
    168   typedef tuple<char, int, int> Tuple3;
    169   const Matcher<Tuple3> m = Args<1, 2>(Lt());
    170   EXPECT_TRUE(m.Matches(Tuple3('a', 1, 2)));
    171   EXPECT_FALSE(m.Matches(Tuple3('b', 2, 2)));
    172 }
    173 
    174 TEST(ArgsTest, CanMatchTupleByReference) {
    175   typedef tuple<char, char, int> Tuple3;
    176   const Matcher<const Tuple3&> m = Args<0, 1>(Lt());
    177   EXPECT_TRUE(m.Matches(Tuple3('a', 'b', 2)));
    178   EXPECT_FALSE(m.Matches(Tuple3('b', 'b', 2)));
    179 }
    180 
    181 // Validates that arg is printed as str.
    182 MATCHER_P(PrintsAs, str, "") {
    183   return testing::PrintToString(arg) == str;
    184 }
    185 
    186 TEST(ArgsTest, AcceptsTenTemplateArgs) {
    187   EXPECT_THAT(make_tuple(0, 1L, 2, 3L, 4, 5, 6, 7, 8, 9),
    188               (Args<9, 8, 7, 6, 5, 4, 3, 2, 1, 0>(
    189                   PrintsAs("(9, 8, 7, 6, 5, 4, 3, 2, 1, 0)"))));
    190   EXPECT_THAT(make_tuple(0, 1L, 2, 3L, 4, 5, 6, 7, 8, 9),
    191               Not(Args<9, 8, 7, 6, 5, 4, 3, 2, 1, 0>(
    192                       PrintsAs("(0, 8, 7, 6, 5, 4, 3, 2, 1, 0)"))));
    193 }
    194 
    195 TEST(ArgsTest, DescirbesSelfCorrectly) {
    196   const Matcher<tuple<int, bool, char> > m = Args<2, 0>(Lt());
    197   EXPECT_EQ("are a tuple whose fields (#2, #0) are a pair where "
    198             "the first < the second",
    199             Describe(m));
    200 }
    201 
    202 TEST(ArgsTest, DescirbesNestedArgsCorrectly) {
    203   const Matcher<const tuple<int, bool, char, int>&> m =
    204       Args<0, 2, 3>(Args<2, 0>(Lt()));
    205   EXPECT_EQ("are a tuple whose fields (#0, #2, #3) are a tuple "
    206             "whose fields (#2, #0) are a pair where the first < the second",
    207             Describe(m));
    208 }
    209 
    210 TEST(ArgsTest, DescribesNegationCorrectly) {
    211   const Matcher<tuple<int, char> > m = Args<1, 0>(Gt());
    212   EXPECT_EQ("are a tuple whose fields (#1, #0) aren't a pair "
    213             "where the first > the second",
    214             DescribeNegation(m));
    215 }
    216 
    217 TEST(ArgsTest, ExplainsMatchResultWithoutInnerExplanation) {
    218   const Matcher<tuple<bool, int, int> > m = Args<1, 2>(Eq());
    219   EXPECT_EQ("whose fields (#1, #2) are (42, 42)",
    220             Explain(m, make_tuple(false, 42, 42)));
    221   EXPECT_EQ("whose fields (#1, #2) are (42, 43)",
    222             Explain(m, make_tuple(false, 42, 43)));
    223 }
    224 
    225 // For testing Args<>'s explanation.
    226 class LessThanMatcher : public MatcherInterface<tuple<char, int> > {
    227  public:
    228   virtual void DescribeTo(::std::ostream* os) const {}
    229 
    230   virtual bool MatchAndExplain(tuple<char, int> value,
    231                                MatchResultListener* listener) const {
    232     const int diff = get<0>(value) - get<1>(value);
    233     if (diff > 0) {
    234       *listener << "where the first value is " << diff
    235                 << " more than the second";
    236     }
    237     return diff < 0;
    238   }
    239 };
    240 
    241 Matcher<tuple<char, int> > LessThan() {
    242   return MakeMatcher(new LessThanMatcher);
    243 }
    244 
    245 TEST(ArgsTest, ExplainsMatchResultWithInnerExplanation) {
    246   const Matcher<tuple<char, int, int> > m = Args<0, 2>(LessThan());
    247   EXPECT_EQ("whose fields (#0, #2) are ('a' (97, 0x61), 42), "
    248             "where the first value is 55 more than the second",
    249             Explain(m, make_tuple('a', 42, 42)));
    250   EXPECT_EQ("whose fields (#0, #2) are ('\\0', 43)",
    251             Explain(m, make_tuple('\0', 42, 43)));
    252 }
    253 
    254 // For testing ExplainMatchResultTo().
    255 class GreaterThanMatcher : public MatcherInterface<int> {
    256  public:
    257   explicit GreaterThanMatcher(int rhs) : rhs_(rhs) {}
    258 
    259   virtual void DescribeTo(::std::ostream* os) const {
    260     *os << "is greater than " << rhs_;
    261   }
    262 
    263   virtual bool MatchAndExplain(int lhs,
    264                                MatchResultListener* listener) const {
    265     const int diff = lhs - rhs_;
    266     if (diff > 0) {
    267       *listener << "which is " << diff << " more than " << rhs_;
    268     } else if (diff == 0) {
    269       *listener << "which is the same as " << rhs_;
    270     } else {
    271       *listener << "which is " << -diff << " less than " << rhs_;
    272     }
    273 
    274     return lhs > rhs_;
    275   }
    276 
    277  private:
    278   int rhs_;
    279 };
    280 
    281 Matcher<int> GreaterThan(int n) {
    282   return MakeMatcher(new GreaterThanMatcher(n));
    283 }
    284 
    285 // Tests for ElementsAre().
    286 
    287 TEST(ElementsAreTest, CanDescribeExpectingNoElement) {
    288   Matcher<const vector<int>&> m = ElementsAre();
    289   EXPECT_EQ("is empty", Describe(m));
    290 }
    291 
    292 TEST(ElementsAreTest, CanDescribeExpectingOneElement) {
    293   Matcher<vector<int> > m = ElementsAre(Gt(5));
    294   EXPECT_EQ("has 1 element that is > 5", Describe(m));
    295 }
    296 
    297 TEST(ElementsAreTest, CanDescribeExpectingManyElements) {
    298   Matcher<list<std::string> > m = ElementsAre(StrEq("one"), "two");
    299   EXPECT_EQ("has 2 elements where\n"
    300             "element #0 is equal to \"one\",\n"
    301             "element #1 is equal to \"two\"", Describe(m));
    302 }
    303 
    304 TEST(ElementsAreTest, CanDescribeNegationOfExpectingNoElement) {
    305   Matcher<vector<int> > m = ElementsAre();
    306   EXPECT_EQ("isn't empty", DescribeNegation(m));
    307 }
    308 
    309 TEST(ElementsAreTest, CanDescribeNegationOfExpectingOneElment) {
    310   Matcher<const list<int>& > m = ElementsAre(Gt(5));
    311   EXPECT_EQ("doesn't have 1 element, or\n"
    312             "element #0 isn't > 5", DescribeNegation(m));
    313 }
    314 
    315 TEST(ElementsAreTest, CanDescribeNegationOfExpectingManyElements) {
    316   Matcher<const list<std::string>&> m = ElementsAre("one", "two");
    317   EXPECT_EQ("doesn't have 2 elements, or\n"
    318             "element #0 isn't equal to \"one\", or\n"
    319             "element #1 isn't equal to \"two\"", DescribeNegation(m));
    320 }
    321 
    322 TEST(ElementsAreTest, DoesNotExplainTrivialMatch) {
    323   Matcher<const list<int>& > m = ElementsAre(1, Ne(2));
    324 
    325   list<int> test_list;
    326   test_list.push_back(1);
    327   test_list.push_back(3);
    328   EXPECT_EQ("", Explain(m, test_list));  // No need to explain anything.
    329 }
    330 
    331 TEST(ElementsAreTest, ExplainsNonTrivialMatch) {
    332   Matcher<const vector<int>& > m =
    333       ElementsAre(GreaterThan(1), 0, GreaterThan(2));
    334 
    335   const int a[] = { 10, 0, 100 };
    336   vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    337   EXPECT_EQ("whose element #0 matches, which is 9 more than 1,\n"
    338             "and whose element #2 matches, which is 98 more than 2",
    339             Explain(m, test_vector));
    340 }
    341 
    342 TEST(ElementsAreTest, CanExplainMismatchWrongSize) {
    343   Matcher<const list<int>& > m = ElementsAre(1, 3);
    344 
    345   list<int> test_list;
    346   // No need to explain when the container is empty.
    347   EXPECT_EQ("", Explain(m, test_list));
    348 
    349   test_list.push_back(1);
    350   EXPECT_EQ("which has 1 element", Explain(m, test_list));
    351 }
    352 
    353 TEST(ElementsAreTest, CanExplainMismatchRightSize) {
    354   Matcher<const vector<int>& > m = ElementsAre(1, GreaterThan(5));
    355 
    356   vector<int> v;
    357   v.push_back(2);
    358   v.push_back(1);
    359   EXPECT_EQ("whose element #0 doesn't match", Explain(m, v));
    360 
    361   v[0] = 1;
    362   EXPECT_EQ("whose element #1 doesn't match, which is 4 less than 5",
    363             Explain(m, v));
    364 }
    365 
    366 TEST(ElementsAreTest, MatchesOneElementVector) {
    367   vector<std::string> test_vector;
    368   test_vector.push_back("test string");
    369 
    370   EXPECT_THAT(test_vector, ElementsAre(StrEq("test string")));
    371 }
    372 
    373 TEST(ElementsAreTest, MatchesOneElementList) {
    374   list<std::string> test_list;
    375   test_list.push_back("test string");
    376 
    377   EXPECT_THAT(test_list, ElementsAre("test string"));
    378 }
    379 
    380 TEST(ElementsAreTest, MatchesThreeElementVector) {
    381   vector<std::string> test_vector;
    382   test_vector.push_back("one");
    383   test_vector.push_back("two");
    384   test_vector.push_back("three");
    385 
    386   EXPECT_THAT(test_vector, ElementsAre("one", StrEq("two"), _));
    387 }
    388 
    389 TEST(ElementsAreTest, MatchesOneElementEqMatcher) {
    390   vector<int> test_vector;
    391   test_vector.push_back(4);
    392 
    393   EXPECT_THAT(test_vector, ElementsAre(Eq(4)));
    394 }
    395 
    396 TEST(ElementsAreTest, MatchesOneElementAnyMatcher) {
    397   vector<int> test_vector;
    398   test_vector.push_back(4);
    399 
    400   EXPECT_THAT(test_vector, ElementsAre(_));
    401 }
    402 
    403 TEST(ElementsAreTest, MatchesOneElementValue) {
    404   vector<int> test_vector;
    405   test_vector.push_back(4);
    406 
    407   EXPECT_THAT(test_vector, ElementsAre(4));
    408 }
    409 
    410 TEST(ElementsAreTest, MatchesThreeElementsMixedMatchers) {
    411   vector<int> test_vector;
    412   test_vector.push_back(1);
    413   test_vector.push_back(2);
    414   test_vector.push_back(3);
    415 
    416   EXPECT_THAT(test_vector, ElementsAre(1, Eq(2), _));
    417 }
    418 
    419 TEST(ElementsAreTest, MatchesTenElementVector) {
    420   const int a[] = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 };
    421   vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    422 
    423   EXPECT_THAT(test_vector,
    424               // The element list can contain values and/or matchers
    425               // of different types.
    426               ElementsAre(0, Ge(0), _, 3, 4, Ne(2), Eq(6), 7, 8, _));
    427 }
    428 
    429 TEST(ElementsAreTest, DoesNotMatchWrongSize) {
    430   vector<std::string> test_vector;
    431   test_vector.push_back("test string");
    432   test_vector.push_back("test string");
    433 
    434   Matcher<vector<std::string> > m = ElementsAre(StrEq("test string"));
    435   EXPECT_FALSE(m.Matches(test_vector));
    436 }
    437 
    438 TEST(ElementsAreTest, DoesNotMatchWrongValue) {
    439   vector<std::string> test_vector;
    440   test_vector.push_back("other string");
    441 
    442   Matcher<vector<std::string> > m = ElementsAre(StrEq("test string"));
    443   EXPECT_FALSE(m.Matches(test_vector));
    444 }
    445 
    446 TEST(ElementsAreTest, DoesNotMatchWrongOrder) {
    447   vector<std::string> test_vector;
    448   test_vector.push_back("one");
    449   test_vector.push_back("three");
    450   test_vector.push_back("two");
    451 
    452   Matcher<vector<std::string> > m =
    453       ElementsAre(StrEq("one"), StrEq("two"), StrEq("three"));
    454   EXPECT_FALSE(m.Matches(test_vector));
    455 }
    456 
    457 TEST(ElementsAreTest, WorksForNestedContainer) {
    458   const char* strings[] = {
    459     "Hi",
    460     "world"
    461   };
    462 
    463   vector<list<char> > nested;
    464   for (size_t i = 0; i < GTEST_ARRAY_SIZE_(strings); i++) {
    465     nested.push_back(list<char>(strings[i], strings[i] + strlen(strings[i])));
    466   }
    467 
    468   EXPECT_THAT(nested, ElementsAre(ElementsAre('H', Ne('e')),
    469                                   ElementsAre('w', 'o', _, _, 'd')));
    470   EXPECT_THAT(nested, Not(ElementsAre(ElementsAre('H', 'e'),
    471                                       ElementsAre('w', 'o', _, _, 'd'))));
    472 }
    473 
    474 TEST(ElementsAreTest, WorksWithByRefElementMatchers) {
    475   int a[] = { 0, 1, 2 };
    476   vector<int> v(a, a + GTEST_ARRAY_SIZE_(a));
    477 
    478   EXPECT_THAT(v, ElementsAre(Ref(v[0]), Ref(v[1]), Ref(v[2])));
    479   EXPECT_THAT(v, Not(ElementsAre(Ref(v[0]), Ref(v[1]), Ref(a[2]))));
    480 }
    481 
    482 TEST(ElementsAreTest, WorksWithContainerPointerUsingPointee) {
    483   int a[] = { 0, 1, 2 };
    484   vector<int> v(a, a + GTEST_ARRAY_SIZE_(a));
    485 
    486   EXPECT_THAT(&v, Pointee(ElementsAre(0, 1, _)));
    487   EXPECT_THAT(&v, Not(Pointee(ElementsAre(0, _, 3))));
    488 }
    489 
    490 TEST(ElementsAreTest, WorksWithNativeArrayPassedByReference) {
    491   int array[] = { 0, 1, 2 };
    492   EXPECT_THAT(array, ElementsAre(0, 1, _));
    493   EXPECT_THAT(array, Not(ElementsAre(1, _, _)));
    494   EXPECT_THAT(array, Not(ElementsAre(0, _)));
    495 }
    496 
    497 class NativeArrayPassedAsPointerAndSize {
    498  public:
    499   NativeArrayPassedAsPointerAndSize() {}
    500 
    501   MOCK_METHOD2(Helper, void(int* array, int size));
    502 
    503  private:
    504   GTEST_DISALLOW_COPY_AND_ASSIGN_(NativeArrayPassedAsPointerAndSize);
    505 };
    506 
    507 TEST(ElementsAreTest, WorksWithNativeArrayPassedAsPointerAndSize) {
    508   int array[] = { 0, 1 };
    509   ::testing::tuple<int*, size_t> array_as_tuple(array, 2);
    510   EXPECT_THAT(array_as_tuple, ElementsAre(0, 1));
    511   EXPECT_THAT(array_as_tuple, Not(ElementsAre(0)));
    512 
    513   NativeArrayPassedAsPointerAndSize helper;
    514   EXPECT_CALL(helper, Helper(_, _))
    515       .With(ElementsAre(0, 1));
    516   helper.Helper(array, 2);
    517 }
    518 
    519 TEST(ElementsAreTest, WorksWithTwoDimensionalNativeArray) {
    520   const char a2[][3] = { "hi", "lo" };
    521   EXPECT_THAT(a2, ElementsAre(ElementsAre('h', 'i', '\0'),
    522                               ElementsAre('l', 'o', '\0')));
    523   EXPECT_THAT(a2, ElementsAre(StrEq("hi"), StrEq("lo")));
    524   EXPECT_THAT(a2, ElementsAre(Not(ElementsAre('h', 'o', '\0')),
    525                               ElementsAre('l', 'o', '\0')));
    526 }
    527 
    528 TEST(ElementsAreTest, AcceptsStringLiteral) {
    529   std::string array[] = {"hi", "one", "two"};
    530   EXPECT_THAT(array, ElementsAre("hi", "one", "two"));
    531   EXPECT_THAT(array, Not(ElementsAre("hi", "one", "too")));
    532 }
    533 
    534 #ifndef _MSC_VER
    535 
    536 // The following test passes a value of type const char[] to a
    537 // function template that expects const T&.  Some versions of MSVC
    538 // generates a compiler error C2665 for that.  We believe it's a bug
    539 // in MSVC.  Therefore this test is #if-ed out for MSVC.
    540 
    541 // Declared here with the size unknown.  Defined AFTER the following test.
    542 extern const char kHi[];
    543 
    544 TEST(ElementsAreTest, AcceptsArrayWithUnknownSize) {
    545   // The size of kHi is not known in this test, but ElementsAre() should
    546   // still accept it.
    547 
    548   std::string array1[] = {"hi"};
    549   EXPECT_THAT(array1, ElementsAre(kHi));
    550 
    551   std::string array2[] = {"ho"};
    552   EXPECT_THAT(array2, Not(ElementsAre(kHi)));
    553 }
    554 
    555 const char kHi[] = "hi";
    556 
    557 #endif  // _MSC_VER
    558 
    559 TEST(ElementsAreTest, MakesCopyOfArguments) {
    560   int x = 1;
    561   int y = 2;
    562   // This should make a copy of x and y.
    563   ::testing::internal::ElementsAreMatcher<testing::tuple<int, int> >
    564           polymorphic_matcher = ElementsAre(x, y);
    565   // Changing x and y now shouldn't affect the meaning of the above matcher.
    566   x = y = 0;
    567   const int array1[] = { 1, 2 };
    568   EXPECT_THAT(array1, polymorphic_matcher);
    569   const int array2[] = { 0, 0 };
    570   EXPECT_THAT(array2, Not(polymorphic_matcher));
    571 }
    572 
    573 
    574 // Tests for ElementsAreArray().  Since ElementsAreArray() shares most
    575 // of the implementation with ElementsAre(), we don't test it as
    576 // thoroughly here.
    577 
    578 TEST(ElementsAreArrayTest, CanBeCreatedWithValueArray) {
    579   const int a[] = { 1, 2, 3 };
    580 
    581   vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    582   EXPECT_THAT(test_vector, ElementsAreArray(a));
    583 
    584   test_vector[2] = 0;
    585   EXPECT_THAT(test_vector, Not(ElementsAreArray(a)));
    586 }
    587 
    588 TEST(ElementsAreArrayTest, CanBeCreatedWithArraySize) {
    589   const char* a[] = { "one", "two", "three" };
    590 
    591   vector<std::string> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    592   EXPECT_THAT(test_vector, ElementsAreArray(a, GTEST_ARRAY_SIZE_(a)));
    593 
    594   const char** p = a;
    595   test_vector[0] = "1";
    596   EXPECT_THAT(test_vector, Not(ElementsAreArray(p, GTEST_ARRAY_SIZE_(a))));
    597 }
    598 
    599 TEST(ElementsAreArrayTest, CanBeCreatedWithoutArraySize) {
    600   const char* a[] = { "one", "two", "three" };
    601 
    602   vector<std::string> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    603   EXPECT_THAT(test_vector, ElementsAreArray(a));
    604 
    605   test_vector[0] = "1";
    606   EXPECT_THAT(test_vector, Not(ElementsAreArray(a)));
    607 }
    608 
    609 TEST(ElementsAreArrayTest, CanBeCreatedWithMatcherArray) {
    610   const Matcher<std::string> kMatcherArray[] = {StrEq("one"), StrEq("two"),
    611                                                 StrEq("three")};
    612 
    613   vector<std::string> test_vector;
    614   test_vector.push_back("one");
    615   test_vector.push_back("two");
    616   test_vector.push_back("three");
    617   EXPECT_THAT(test_vector, ElementsAreArray(kMatcherArray));
    618 
    619   test_vector.push_back("three");
    620   EXPECT_THAT(test_vector, Not(ElementsAreArray(kMatcherArray)));
    621 }
    622 
    623 TEST(ElementsAreArrayTest, CanBeCreatedWithVector) {
    624   const int a[] = { 1, 2, 3 };
    625   vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    626   const vector<int> expected(a, a + GTEST_ARRAY_SIZE_(a));
    627   EXPECT_THAT(test_vector, ElementsAreArray(expected));
    628   test_vector.push_back(4);
    629   EXPECT_THAT(test_vector, Not(ElementsAreArray(expected)));
    630 }
    631 
    632 #if GTEST_HAS_STD_INITIALIZER_LIST_
    633 
    634 TEST(ElementsAreArrayTest, TakesInitializerList) {
    635   const int a[5] = { 1, 2, 3, 4, 5 };
    636   EXPECT_THAT(a, ElementsAreArray({ 1, 2, 3, 4, 5 }));
    637   EXPECT_THAT(a, Not(ElementsAreArray({ 1, 2, 3, 5, 4 })));
    638   EXPECT_THAT(a, Not(ElementsAreArray({ 1, 2, 3, 4, 6 })));
    639 }
    640 
    641 TEST(ElementsAreArrayTest, TakesInitializerListOfCStrings) {
    642   const std::string a[5] = {"a", "b", "c", "d", "e"};
    643   EXPECT_THAT(a, ElementsAreArray({ "a", "b", "c", "d", "e" }));
    644   EXPECT_THAT(a, Not(ElementsAreArray({ "a", "b", "c", "e", "d" })));
    645   EXPECT_THAT(a, Not(ElementsAreArray({ "a", "b", "c", "d", "ef" })));
    646 }
    647 
    648 TEST(ElementsAreArrayTest, TakesInitializerListOfSameTypedMatchers) {
    649   const int a[5] = { 1, 2, 3, 4, 5 };
    650   EXPECT_THAT(a, ElementsAreArray(
    651       { Eq(1), Eq(2), Eq(3), Eq(4), Eq(5) }));
    652   EXPECT_THAT(a, Not(ElementsAreArray(
    653       { Eq(1), Eq(2), Eq(3), Eq(4), Eq(6) })));
    654 }
    655 
    656 TEST(ElementsAreArrayTest,
    657      TakesInitializerListOfDifferentTypedMatchers) {
    658   const int a[5] = { 1, 2, 3, 4, 5 };
    659   // The compiler cannot infer the type of the initializer list if its
    660   // elements have different types.  We must explicitly specify the
    661   // unified element type in this case.
    662   EXPECT_THAT(a, ElementsAreArray<Matcher<int> >(
    663       { Eq(1), Ne(-2), Ge(3), Le(4), Eq(5) }));
    664   EXPECT_THAT(a, Not(ElementsAreArray<Matcher<int> >(
    665       { Eq(1), Ne(-2), Ge(3), Le(4), Eq(6) })));
    666 }
    667 
    668 #endif  // GTEST_HAS_STD_INITIALIZER_LIST_
    669 
    670 TEST(ElementsAreArrayTest, CanBeCreatedWithMatcherVector) {
    671   const int a[] = { 1, 2, 3 };
    672   const Matcher<int> kMatchers[] = { Eq(1), Eq(2), Eq(3) };
    673   vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    674   const vector<Matcher<int> > expected(
    675       kMatchers, kMatchers + GTEST_ARRAY_SIZE_(kMatchers));
    676   EXPECT_THAT(test_vector, ElementsAreArray(expected));
    677   test_vector.push_back(4);
    678   EXPECT_THAT(test_vector, Not(ElementsAreArray(expected)));
    679 }
    680 
    681 TEST(ElementsAreArrayTest, CanBeCreatedWithIteratorRange) {
    682   const int a[] = { 1, 2, 3 };
    683   const vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    684   const vector<int> expected(a, a + GTEST_ARRAY_SIZE_(a));
    685   EXPECT_THAT(test_vector, ElementsAreArray(expected.begin(), expected.end()));
    686   // Pointers are iterators, too.
    687   EXPECT_THAT(test_vector, ElementsAreArray(a, a + GTEST_ARRAY_SIZE_(a)));
    688   // The empty range of NULL pointers should also be okay.
    689   int* const null_int = NULL;
    690   EXPECT_THAT(test_vector, Not(ElementsAreArray(null_int, null_int)));
    691   EXPECT_THAT((vector<int>()), ElementsAreArray(null_int, null_int));
    692 }
    693 
    694 // Since ElementsAre() and ElementsAreArray() share much of the
    695 // implementation, we only do a sanity test for native arrays here.
    696 TEST(ElementsAreArrayTest, WorksWithNativeArray) {
    697   ::std::string a[] = { "hi", "ho" };
    698   ::std::string b[] = { "hi", "ho" };
    699 
    700   EXPECT_THAT(a, ElementsAreArray(b));
    701   EXPECT_THAT(a, ElementsAreArray(b, 2));
    702   EXPECT_THAT(a, Not(ElementsAreArray(b, 1)));
    703 }
    704 
    705 TEST(ElementsAreArrayTest, SourceLifeSpan) {
    706   const int a[] = { 1, 2, 3 };
    707   vector<int> test_vector(a, a + GTEST_ARRAY_SIZE_(a));
    708   vector<int> expect(a, a + GTEST_ARRAY_SIZE_(a));
    709   ElementsAreArrayMatcher<int> matcher_maker =
    710       ElementsAreArray(expect.begin(), expect.end());
    711   EXPECT_THAT(test_vector, matcher_maker);
    712   // Changing in place the values that initialized matcher_maker should not
    713   // affect matcher_maker anymore. It should have made its own copy of them.
    714   typedef vector<int>::iterator Iter;
    715   for (Iter it = expect.begin(); it != expect.end(); ++it) { *it += 10; }
    716   EXPECT_THAT(test_vector, matcher_maker);
    717   test_vector.push_back(3);
    718   EXPECT_THAT(test_vector, Not(matcher_maker));
    719 }
    720 
    721 // Tests for the MATCHER*() macro family.
    722 
    723 // Tests that a simple MATCHER() definition works.
    724 
    725 MATCHER(IsEven, "") { return (arg % 2) == 0; }
    726 
    727 TEST(MatcherMacroTest, Works) {
    728   const Matcher<int> m = IsEven();
    729   EXPECT_TRUE(m.Matches(6));
    730   EXPECT_FALSE(m.Matches(7));
    731 
    732   EXPECT_EQ("is even", Describe(m));
    733   EXPECT_EQ("not (is even)", DescribeNegation(m));
    734   EXPECT_EQ("", Explain(m, 6));
    735   EXPECT_EQ("", Explain(m, 7));
    736 }
    737 
    738 // This also tests that the description string can reference 'negation'.
    739 MATCHER(IsEven2, negation ? "is odd" : "is even") {
    740   if ((arg % 2) == 0) {
    741     // Verifies that we can stream to result_listener, a listener
    742     // supplied by the MATCHER macro implicitly.
    743     *result_listener << "OK";
    744     return true;
    745   } else {
    746     *result_listener << "% 2 == " << (arg % 2);
    747     return false;
    748   }
    749 }
    750 
    751 // This also tests that the description string can reference matcher
    752 // parameters.
    753 MATCHER_P2(EqSumOf, x, y, std::string(negation ? "doesn't equal" : "equals") +
    754                               " the sum of " + PrintToString(x) + " and " +
    755                               PrintToString(y)) {
    756   if (arg == (x + y)) {
    757     *result_listener << "OK";
    758     return true;
    759   } else {
    760     // Verifies that we can stream to the underlying stream of
    761     // result_listener.
    762     if (result_listener->stream() != NULL) {
    763       *result_listener->stream() << "diff == " << (x + y - arg);
    764     }
    765     return false;
    766   }
    767 }
    768 
    769 // Tests that the matcher description can reference 'negation' and the
    770 // matcher parameters.
    771 TEST(MatcherMacroTest, DescriptionCanReferenceNegationAndParameters) {
    772   const Matcher<int> m1 = IsEven2();
    773   EXPECT_EQ("is even", Describe(m1));
    774   EXPECT_EQ("is odd", DescribeNegation(m1));
    775 
    776   const Matcher<int> m2 = EqSumOf(5, 9);
    777   EXPECT_EQ("equals the sum of 5 and 9", Describe(m2));
    778   EXPECT_EQ("doesn't equal the sum of 5 and 9", DescribeNegation(m2));
    779 }
    780 
    781 // Tests explaining match result in a MATCHER* macro.
    782 TEST(MatcherMacroTest, CanExplainMatchResult) {
    783   const Matcher<int> m1 = IsEven2();
    784   EXPECT_EQ("OK", Explain(m1, 4));
    785   EXPECT_EQ("% 2 == 1", Explain(m1, 5));
    786 
    787   const Matcher<int> m2 = EqSumOf(1, 2);
    788   EXPECT_EQ("OK", Explain(m2, 3));
    789   EXPECT_EQ("diff == -1", Explain(m2, 4));
    790 }
    791 
    792 // Tests that the body of MATCHER() can reference the type of the
    793 // value being matched.
    794 
    795 MATCHER(IsEmptyString, "") {
    796   StaticAssertTypeEq< ::std::string, arg_type>();
    797   return arg == "";
    798 }
    799 
    800 MATCHER(IsEmptyStringByRef, "") {
    801   StaticAssertTypeEq<const ::std::string&, arg_type>();
    802   return arg == "";
    803 }
    804 
    805 TEST(MatcherMacroTest, CanReferenceArgType) {
    806   const Matcher< ::std::string> m1 = IsEmptyString();
    807   EXPECT_TRUE(m1.Matches(""));
    808 
    809   const Matcher<const ::std::string&> m2 = IsEmptyStringByRef();
    810   EXPECT_TRUE(m2.Matches(""));
    811 }
    812 
    813 // Tests that MATCHER() can be used in a namespace.
    814 
    815 namespace matcher_test {
    816 MATCHER(IsOdd, "") { return (arg % 2) != 0; }
    817 }  // namespace matcher_test
    818 
    819 TEST(MatcherMacroTest, WorksInNamespace) {
    820   Matcher<int> m = matcher_test::IsOdd();
    821   EXPECT_FALSE(m.Matches(4));
    822   EXPECT_TRUE(m.Matches(5));
    823 }
    824 
    825 // Tests that Value() can be used to compose matchers.
    826 MATCHER(IsPositiveOdd, "") {
    827   return Value(arg, matcher_test::IsOdd()) && arg > 0;
    828 }
    829 
    830 TEST(MatcherMacroTest, CanBeComposedUsingValue) {
    831   EXPECT_THAT(3, IsPositiveOdd());
    832   EXPECT_THAT(4, Not(IsPositiveOdd()));
    833   EXPECT_THAT(-1, Not(IsPositiveOdd()));
    834 }
    835 
    836 // Tests that a simple MATCHER_P() definition works.
    837 
    838 MATCHER_P(IsGreaterThan32And, n, "") { return arg > 32 && arg > n; }
    839 
    840 TEST(MatcherPMacroTest, Works) {
    841   const Matcher<int> m = IsGreaterThan32And(5);
    842   EXPECT_TRUE(m.Matches(36));
    843   EXPECT_FALSE(m.Matches(5));
    844 
    845   EXPECT_EQ("is greater than 32 and 5", Describe(m));
    846   EXPECT_EQ("not (is greater than 32 and 5)", DescribeNegation(m));
    847   EXPECT_EQ("", Explain(m, 36));
    848   EXPECT_EQ("", Explain(m, 5));
    849 }
    850 
    851 // Tests that the description is calculated correctly from the matcher name.
    852 MATCHER_P(_is_Greater_Than32and_, n, "") { return arg > 32 && arg > n; }
    853 
    854 TEST(MatcherPMacroTest, GeneratesCorrectDescription) {
    855   const Matcher<int> m = _is_Greater_Than32and_(5);
    856 
    857   EXPECT_EQ("is greater than 32 and 5", Describe(m));
    858   EXPECT_EQ("not (is greater than 32 and 5)", DescribeNegation(m));
    859   EXPECT_EQ("", Explain(m, 36));
    860   EXPECT_EQ("", Explain(m, 5));
    861 }
    862 
    863 // Tests that a MATCHER_P matcher can be explicitly instantiated with
    864 // a reference parameter type.
    865 
    866 class UncopyableFoo {
    867  public:
    868   explicit UncopyableFoo(char value) : value_(value) {}
    869  private:
    870   UncopyableFoo(const UncopyableFoo&);
    871   void operator=(const UncopyableFoo&);
    872 
    873   char value_;
    874 };
    875 
    876 MATCHER_P(ReferencesUncopyable, variable, "") { return &arg == &variable; }
    877 
    878 TEST(MatcherPMacroTest, WorksWhenExplicitlyInstantiatedWithReference) {
    879   UncopyableFoo foo1('1'), foo2('2');
    880   const Matcher<const UncopyableFoo&> m =
    881       ReferencesUncopyable<const UncopyableFoo&>(foo1);
    882 
    883   EXPECT_TRUE(m.Matches(foo1));
    884   EXPECT_FALSE(m.Matches(foo2));
    885 
    886   // We don't want the address of the parameter printed, as most
    887   // likely it will just annoy the user.  If the address is
    888   // interesting, the user should consider passing the parameter by
    889   // pointer instead.
    890   EXPECT_EQ("references uncopyable 1-byte object <31>", Describe(m));
    891 }
    892 
    893 
    894 // Tests that the body of MATCHER_Pn() can reference the parameter
    895 // types.
    896 
    897 MATCHER_P3(ParamTypesAreIntLongAndChar, foo, bar, baz, "") {
    898   StaticAssertTypeEq<int, foo_type>();
    899   StaticAssertTypeEq<long, bar_type>();  // NOLINT
    900   StaticAssertTypeEq<char, baz_type>();
    901   return arg == 0;
    902 }
    903 
    904 TEST(MatcherPnMacroTest, CanReferenceParamTypes) {
    905   EXPECT_THAT(0, ParamTypesAreIntLongAndChar(10, 20L, 'a'));
    906 }
    907 
    908 // Tests that a MATCHER_Pn matcher can be explicitly instantiated with
    909 // reference parameter types.
    910 
    911 MATCHER_P2(ReferencesAnyOf, variable1, variable2, "") {
    912   return &arg == &variable1 || &arg == &variable2;
    913 }
    914 
    915 TEST(MatcherPnMacroTest, WorksWhenExplicitlyInstantiatedWithReferences) {
    916   UncopyableFoo foo1('1'), foo2('2'), foo3('3');
    917   const Matcher<const UncopyableFoo&> m =
    918       ReferencesAnyOf<const UncopyableFoo&, const UncopyableFoo&>(foo1, foo2);
    919 
    920   EXPECT_TRUE(m.Matches(foo1));
    921   EXPECT_TRUE(m.Matches(foo2));
    922   EXPECT_FALSE(m.Matches(foo3));
    923 }
    924 
    925 TEST(MatcherPnMacroTest,
    926      GeneratesCorretDescriptionWhenExplicitlyInstantiatedWithReferences) {
    927   UncopyableFoo foo1('1'), foo2('2');
    928   const Matcher<const UncopyableFoo&> m =
    929       ReferencesAnyOf<const UncopyableFoo&, const UncopyableFoo&>(foo1, foo2);
    930 
    931   // We don't want the addresses of the parameters printed, as most
    932   // likely they will just annoy the user.  If the addresses are
    933   // interesting, the user should consider passing the parameters by
    934   // pointers instead.
    935   EXPECT_EQ("references any of (1-byte object <31>, 1-byte object <32>)",
    936             Describe(m));
    937 }
    938 
    939 // Tests that a simple MATCHER_P2() definition works.
    940 
    941 MATCHER_P2(IsNotInClosedRange, low, hi, "") { return arg < low || arg > hi; }
    942 
    943 TEST(MatcherPnMacroTest, Works) {
    944   const Matcher<const long&> m = IsNotInClosedRange(10, 20);  // NOLINT
    945   EXPECT_TRUE(m.Matches(36L));
    946   EXPECT_FALSE(m.Matches(15L));
    947 
    948   EXPECT_EQ("is not in closed range (10, 20)", Describe(m));
    949   EXPECT_EQ("not (is not in closed range (10, 20))", DescribeNegation(m));
    950   EXPECT_EQ("", Explain(m, 36L));
    951   EXPECT_EQ("", Explain(m, 15L));
    952 }
    953 
    954 // Tests that MATCHER*() definitions can be overloaded on the number
    955 // of parameters; also tests MATCHER_Pn() where n >= 3.
    956 
    957 MATCHER(EqualsSumOf, "") { return arg == 0; }
    958 MATCHER_P(EqualsSumOf, a, "") { return arg == a; }
    959 MATCHER_P2(EqualsSumOf, a, b, "") { return arg == a + b; }
    960 MATCHER_P3(EqualsSumOf, a, b, c, "") { return arg == a + b + c; }
    961 MATCHER_P4(EqualsSumOf, a, b, c, d, "") { return arg == a + b + c + d; }
    962 MATCHER_P5(EqualsSumOf, a, b, c, d, e, "") { return arg == a + b + c + d + e; }
    963 MATCHER_P6(EqualsSumOf, a, b, c, d, e, f, "") {
    964   return arg == a + b + c + d + e + f;
    965 }
    966 MATCHER_P7(EqualsSumOf, a, b, c, d, e, f, g, "") {
    967   return arg == a + b + c + d + e + f + g;
    968 }
    969 MATCHER_P8(EqualsSumOf, a, b, c, d, e, f, g, h, "") {
    970   return arg == a + b + c + d + e + f + g + h;
    971 }
    972 MATCHER_P9(EqualsSumOf, a, b, c, d, e, f, g, h, i, "") {
    973   return arg == a + b + c + d + e + f + g + h + i;
    974 }
    975 MATCHER_P10(EqualsSumOf, a, b, c, d, e, f, g, h, i, j, "") {
    976   return arg == a + b + c + d + e + f + g + h + i + j;
    977 }
    978 
    979 TEST(MatcherPnMacroTest, CanBeOverloadedOnNumberOfParameters) {
    980   EXPECT_THAT(0, EqualsSumOf());
    981   EXPECT_THAT(1, EqualsSumOf(1));
    982   EXPECT_THAT(12, EqualsSumOf(10, 2));
    983   EXPECT_THAT(123, EqualsSumOf(100, 20, 3));
    984   EXPECT_THAT(1234, EqualsSumOf(1000, 200, 30, 4));
    985   EXPECT_THAT(12345, EqualsSumOf(10000, 2000, 300, 40, 5));
    986   EXPECT_THAT("abcdef",
    987               EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f'));
    988   EXPECT_THAT("abcdefg",
    989               EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g'));
    990   EXPECT_THAT("abcdefgh",
    991               EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g',
    992                           "h"));
    993   EXPECT_THAT("abcdefghi",
    994               EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g',
    995                           "h", 'i'));
    996   EXPECT_THAT("abcdefghij",
    997               EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g',
    998                           "h", 'i', ::std::string("j")));
    999 
   1000   EXPECT_THAT(1, Not(EqualsSumOf()));
   1001   EXPECT_THAT(-1, Not(EqualsSumOf(1)));
   1002   EXPECT_THAT(-12, Not(EqualsSumOf(10, 2)));
   1003   EXPECT_THAT(-123, Not(EqualsSumOf(100, 20, 3)));
   1004   EXPECT_THAT(-1234, Not(EqualsSumOf(1000, 200, 30, 4)));
   1005   EXPECT_THAT(-12345, Not(EqualsSumOf(10000, 2000, 300, 40, 5)));
   1006   EXPECT_THAT("abcdef ",
   1007               Not(EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f')));
   1008   EXPECT_THAT("abcdefg ",
   1009               Not(EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f',
   1010                               'g')));
   1011   EXPECT_THAT("abcdefgh ",
   1012               Not(EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g',
   1013                               "h")));
   1014   EXPECT_THAT("abcdefghi ",
   1015               Not(EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g',
   1016                               "h", 'i')));
   1017   EXPECT_THAT("abcdefghij ",
   1018               Not(EqualsSumOf(::std::string("a"), 'b', 'c', "d", "e", 'f', 'g',
   1019                               "h", 'i', ::std::string("j"))));
   1020 }
   1021 
   1022 // Tests that a MATCHER_Pn() definition can be instantiated with any
   1023 // compatible parameter types.
   1024 TEST(MatcherPnMacroTest, WorksForDifferentParameterTypes) {
   1025   EXPECT_THAT(123, EqualsSumOf(100L, 20, static_cast<char>(3)));
   1026   EXPECT_THAT("abcd", EqualsSumOf(::std::string("a"), "b", 'c', "d"));
   1027 
   1028   EXPECT_THAT(124, Not(EqualsSumOf(100L, 20, static_cast<char>(3))));
   1029   EXPECT_THAT("abcde", Not(EqualsSumOf(::std::string("a"), "b", 'c', "d")));
   1030 }
   1031 
   1032 // Tests that the matcher body can promote the parameter types.
   1033 
   1034 MATCHER_P2(EqConcat, prefix, suffix, "") {
   1035   // The following lines promote the two parameters to desired types.
   1036   std::string prefix_str(prefix);
   1037   char suffix_char = static_cast<char>(suffix);
   1038   return arg == prefix_str + suffix_char;
   1039 }
   1040 
   1041 TEST(MatcherPnMacroTest, SimpleTypePromotion) {
   1042   Matcher<std::string> no_promo =
   1043       EqConcat(std::string("foo"), 't');
   1044   Matcher<const std::string&> promo =
   1045       EqConcat("foo", static_cast<int>('t'));
   1046   EXPECT_FALSE(no_promo.Matches("fool"));
   1047   EXPECT_FALSE(promo.Matches("fool"));
   1048   EXPECT_TRUE(no_promo.Matches("foot"));
   1049   EXPECT_TRUE(promo.Matches("foot"));
   1050 }
   1051 
   1052 // Verifies the type of a MATCHER*.
   1053 
   1054 TEST(MatcherPnMacroTest, TypesAreCorrect) {
   1055   // EqualsSumOf() must be assignable to a EqualsSumOfMatcher variable.
   1056   EqualsSumOfMatcher a0 = EqualsSumOf();
   1057 
   1058   // EqualsSumOf(1) must be assignable to a EqualsSumOfMatcherP variable.
   1059   EqualsSumOfMatcherP<int> a1 = EqualsSumOf(1);
   1060 
   1061   // EqualsSumOf(p1, ..., pk) must be assignable to a EqualsSumOfMatcherPk
   1062   // variable, and so on.
   1063   EqualsSumOfMatcherP2<int, char> a2 = EqualsSumOf(1, '2');
   1064   EqualsSumOfMatcherP3<int, int, char> a3 = EqualsSumOf(1, 2, '3');
   1065   EqualsSumOfMatcherP4<int, int, int, char> a4 = EqualsSumOf(1, 2, 3, '4');
   1066   EqualsSumOfMatcherP5<int, int, int, int, char> a5 =
   1067       EqualsSumOf(1, 2, 3, 4, '5');
   1068   EqualsSumOfMatcherP6<int, int, int, int, int, char> a6 =
   1069       EqualsSumOf(1, 2, 3, 4, 5, '6');
   1070   EqualsSumOfMatcherP7<int, int, int, int, int, int, char> a7 =
   1071       EqualsSumOf(1, 2, 3, 4, 5, 6, '7');
   1072   EqualsSumOfMatcherP8<int, int, int, int, int, int, int, char> a8 =
   1073       EqualsSumOf(1, 2, 3, 4, 5, 6, 7, '8');
   1074   EqualsSumOfMatcherP9<int, int, int, int, int, int, int, int, char> a9 =
   1075       EqualsSumOf(1, 2, 3, 4, 5, 6, 7, 8, '9');
   1076   EqualsSumOfMatcherP10<int, int, int, int, int, int, int, int, int, char> a10 =
   1077       EqualsSumOf(1, 2, 3, 4, 5, 6, 7, 8, 9, '0');
   1078 
   1079   // Avoid "unused variable" warnings.
   1080   (void)a0;
   1081   (void)a1;
   1082   (void)a2;
   1083   (void)a3;
   1084   (void)a4;
   1085   (void)a5;
   1086   (void)a6;
   1087   (void)a7;
   1088   (void)a8;
   1089   (void)a9;
   1090   (void)a10;
   1091 }
   1092 
   1093 // Tests that matcher-typed parameters can be used in Value() inside a
   1094 // MATCHER_Pn definition.
   1095 
   1096 // Succeeds if arg matches exactly 2 of the 3 matchers.
   1097 MATCHER_P3(TwoOf, m1, m2, m3, "") {
   1098   const int count = static_cast<int>(Value(arg, m1))
   1099       + static_cast<int>(Value(arg, m2)) + static_cast<int>(Value(arg, m3));
   1100   return count == 2;
   1101 }
   1102 
   1103 TEST(MatcherPnMacroTest, CanUseMatcherTypedParameterInValue) {
   1104   EXPECT_THAT(42, TwoOf(Gt(0), Lt(50), Eq(10)));
   1105   EXPECT_THAT(0, Not(TwoOf(Gt(-1), Lt(1), Eq(0))));
   1106 }
   1107 
   1108 // Tests Contains().
   1109 
   1110 TEST(ContainsTest, ListMatchesWhenElementIsInContainer) {
   1111   list<int> some_list;
   1112   some_list.push_back(3);
   1113   some_list.push_back(1);
   1114   some_list.push_back(2);
   1115   EXPECT_THAT(some_list, Contains(1));
   1116   EXPECT_THAT(some_list, Contains(Gt(2.5)));
   1117   EXPECT_THAT(some_list, Contains(Eq(2.0f)));
   1118 
   1119   list<std::string> another_list;
   1120   another_list.push_back("fee");
   1121   another_list.push_back("fie");
   1122   another_list.push_back("foe");
   1123   another_list.push_back("fum");
   1124   EXPECT_THAT(another_list, Contains(std::string("fee")));
   1125 }
   1126 
   1127 TEST(ContainsTest, ListDoesNotMatchWhenElementIsNotInContainer) {
   1128   list<int> some_list;
   1129   some_list.push_back(3);
   1130   some_list.push_back(1);
   1131   EXPECT_THAT(some_list, Not(Contains(4)));
   1132 }
   1133 
   1134 TEST(ContainsTest, SetMatchesWhenElementIsInContainer) {
   1135   set<int> some_set;
   1136   some_set.insert(3);
   1137   some_set.insert(1);
   1138   some_set.insert(2);
   1139   EXPECT_THAT(some_set, Contains(Eq(1.0)));
   1140   EXPECT_THAT(some_set, Contains(Eq(3.0f)));
   1141   EXPECT_THAT(some_set, Contains(2));
   1142 
   1143   set<const char*> another_set;
   1144   another_set.insert("fee");
   1145   another_set.insert("fie");
   1146   another_set.insert("foe");
   1147   another_set.insert("fum");
   1148   EXPECT_THAT(another_set, Contains(Eq(std::string("fum"))));
   1149 }
   1150 
   1151 TEST(ContainsTest, SetDoesNotMatchWhenElementIsNotInContainer) {
   1152   set<int> some_set;
   1153   some_set.insert(3);
   1154   some_set.insert(1);
   1155   EXPECT_THAT(some_set, Not(Contains(4)));
   1156 
   1157   set<const char*> c_string_set;
   1158   c_string_set.insert("hello");
   1159   EXPECT_THAT(c_string_set, Not(Contains(std::string("hello").c_str())));
   1160 }
   1161 
   1162 TEST(ContainsTest, ExplainsMatchResultCorrectly) {
   1163   const int a[2] = { 1, 2 };
   1164   Matcher<const int (&)[2]> m = Contains(2);
   1165   EXPECT_EQ("whose element #1 matches", Explain(m, a));
   1166 
   1167   m = Contains(3);
   1168   EXPECT_EQ("", Explain(m, a));
   1169 
   1170   m = Contains(GreaterThan(0));
   1171   EXPECT_EQ("whose element #0 matches, which is 1 more than 0", Explain(m, a));
   1172 
   1173   m = Contains(GreaterThan(10));
   1174   EXPECT_EQ("", Explain(m, a));
   1175 }
   1176 
   1177 TEST(ContainsTest, DescribesItselfCorrectly) {
   1178   Matcher<vector<int> > m = Contains(1);
   1179   EXPECT_EQ("contains at least one element that is equal to 1", Describe(m));
   1180 
   1181   Matcher<vector<int> > m2 = Not(m);
   1182   EXPECT_EQ("doesn't contain any element that is equal to 1", Describe(m2));
   1183 }
   1184 
   1185 TEST(ContainsTest, MapMatchesWhenElementIsInContainer) {
   1186   map<const char*, int> my_map;
   1187   const char* bar = "a string";
   1188   my_map[bar] = 2;
   1189   EXPECT_THAT(my_map, Contains(pair<const char* const, int>(bar, 2)));
   1190 
   1191   map<std::string, int> another_map;
   1192   another_map["fee"] = 1;
   1193   another_map["fie"] = 2;
   1194   another_map["foe"] = 3;
   1195   another_map["fum"] = 4;
   1196   EXPECT_THAT(another_map,
   1197               Contains(pair<const std::string, int>(std::string("fee"), 1)));
   1198   EXPECT_THAT(another_map, Contains(pair<const std::string, int>("fie", 2)));
   1199 }
   1200 
   1201 TEST(ContainsTest, MapDoesNotMatchWhenElementIsNotInContainer) {
   1202   map<int, int> some_map;
   1203   some_map[1] = 11;
   1204   some_map[2] = 22;
   1205   EXPECT_THAT(some_map, Not(Contains(pair<const int, int>(2, 23))));
   1206 }
   1207 
   1208 TEST(ContainsTest, ArrayMatchesWhenElementIsInContainer) {
   1209   const char* string_array[] = { "fee", "fie", "foe", "fum" };
   1210   EXPECT_THAT(string_array, Contains(Eq(std::string("fum"))));
   1211 }
   1212 
   1213 TEST(ContainsTest, ArrayDoesNotMatchWhenElementIsNotInContainer) {
   1214   int int_array[] = { 1, 2, 3, 4 };
   1215   EXPECT_THAT(int_array, Not(Contains(5)));
   1216 }
   1217 
   1218 TEST(ContainsTest, AcceptsMatcher) {
   1219   const int a[] = { 1, 2, 3 };
   1220   EXPECT_THAT(a, Contains(Gt(2)));
   1221   EXPECT_THAT(a, Not(Contains(Gt(4))));
   1222 }
   1223 
   1224 TEST(ContainsTest, WorksForNativeArrayAsTuple) {
   1225   const int a[] = { 1, 2 };
   1226   const int* const pointer = a;
   1227   EXPECT_THAT(make_tuple(pointer, 2), Contains(1));
   1228   EXPECT_THAT(make_tuple(pointer, 2), Not(Contains(Gt(3))));
   1229 }
   1230 
   1231 TEST(ContainsTest, WorksForTwoDimensionalNativeArray) {
   1232   int a[][3] = { { 1, 2, 3 }, { 4, 5, 6 } };
   1233   EXPECT_THAT(a, Contains(ElementsAre(4, 5, 6)));
   1234   EXPECT_THAT(a, Contains(Contains(5)));
   1235   EXPECT_THAT(a, Not(Contains(ElementsAre(3, 4, 5))));
   1236   EXPECT_THAT(a, Contains(Not(Contains(5))));
   1237 }
   1238 
   1239 TEST(AllOfTest, HugeMatcher) {
   1240   // Verify that using AllOf with many arguments doesn't cause
   1241   // the compiler to exceed template instantiation depth limit.
   1242   EXPECT_THAT(0, testing::AllOf(_, _, _, _, _, _, _, _, _,
   1243                                 testing::AllOf(_, _, _, _, _, _, _, _, _, _)));
   1244 }
   1245 
   1246 TEST(AnyOfTest, HugeMatcher) {
   1247   // Verify that using AnyOf with many arguments doesn't cause
   1248   // the compiler to exceed template instantiation depth limit.
   1249   EXPECT_THAT(0, testing::AnyOf(_, _, _, _, _, _, _, _, _,
   1250                                 testing::AnyOf(_, _, _, _, _, _, _, _, _, _)));
   1251 }
   1252 
   1253 namespace adl_test {
   1254 
   1255 // Verifies that the implementation of ::testing::AllOf and ::testing::AnyOf
   1256 // don't issue unqualified recursive calls.  If they do, the argument dependent
   1257 // name lookup will cause AllOf/AnyOf in the 'adl_test' namespace to be found
   1258 // as a candidate and the compilation will break due to an ambiguous overload.
   1259 
   1260 // The matcher must be in the same namespace as AllOf/AnyOf to make argument
   1261 // dependent lookup find those.
   1262 MATCHER(M, "") { return true; }
   1263 
   1264 template <typename T1, typename T2>
   1265 bool AllOf(const T1& t1, const T2& t2) { return true; }
   1266 
   1267 TEST(AllOfTest, DoesNotCallAllOfUnqualified) {
   1268   EXPECT_THAT(42, testing::AllOf(
   1269       M(), M(), M(), M(), M(), M(), M(), M(), M(), M()));
   1270 }
   1271 
   1272 template <typename T1, typename T2> bool
   1273 AnyOf(const T1& t1, const T2& t2) { return true; }
   1274 
   1275 TEST(AnyOfTest, DoesNotCallAnyOfUnqualified) {
   1276   EXPECT_THAT(42, testing::AnyOf(
   1277       M(), M(), M(), M(), M(), M(), M(), M(), M(), M()));
   1278 }
   1279 
   1280 }  // namespace adl_test
   1281 
   1282 #ifdef _MSC_VER
   1283 # pragma warning(pop)
   1284 #endif
   1285 
   1286 }  // namespace
   1287