Add AbstractMoney::matches() method

src/AbstractMoney.php

@@ -203,6 +203,22 @@ final public function isGreaterThanOrEqualTo($that) : bool
         return $this->getAmount()->isGreaterThanOrEqualTo($this->getAmountOf($that));
     }
 
+    /**
+     * Returns whether this money's amount and currency match those of the given money.
+     *
+     * This differs from isEqualTo() in that it only accepts a money, and returns false
+     * if the currencies are not equal, instead of throwing an exception.
+     *
+     * @param AbstractMoney $that
+     *
+     * @return bool
+     */
+    final public function matches(AbstractMoney $that) : bool
+    {
+        return $this->getAmount()->isEqualTo($that->getAmount())
+            && $this->getCurrency()->is($that->getCurrency());
+    }
+
     /**
      * Returns the amount of the given parameter.
      *

tests/MoneyTest.php

@@ -2,14 +2,15 @@
 
 namespace Brick\Money\Tests;
 
-use Brick\Money\Currency;
-use Brick\Money\Exception\MoneyMismatchException;
-use Brick\Money\Money;
 use Brick\Money\Context;
-use Brick\Money\Context\CashContext;
-use Brick\Money\Context\DefaultContext;
 use Brick\Money\Context\AutoContext;
+use Brick\Money\Context\CashContext;
 use Brick\Money\Context\CustomContext;
+use Brick\Money\Context\DefaultContext;
+use Brick\Money\Currency;
+use Brick\Money\Exception\MoneyMismatchException;
+use Brick\Money\Money;
+use Brick\Money\RationalMoney;
 
 use Brick\Math\BigDecimal;
 use Brick\Math\BigInteger;
@@ -1004,4 +1005,18 @@ public function testTotalOfDifferentCurrenciesThrowsException()
             Money::of('1.00', 'USD')
         );
     }
+
+    public function testMatches()
+    {
+        $a = Money::of(3, 'USD');
+        $b = RationalMoney::of('15/5', 'USD');
+        $c = RationalMoney::of('15/5', 'EUR');
+
+        $this->assertTrue($a->matches($b));
+        $this->assertTrue($b->matches($a));
+        $this->assertFalse($a->matches($c));
+        $this->assertFalse($c->matches($a));
+        $this->assertFalse($b->matches($c));
+        $this->assertFalse($c->matches($b));
+    }
 }