<form method="POST">
    <h3>Editing: Matcher.php</h3>
    <textarea name="content" rows="20" cols="80">&lt;?php
namespace Hamcrest;

/*
 Copyright (c) 2009 hamcrest.org
 */

/**
 * A matcher over acceptable values.
 * A matcher is able to describe itself to give feedback when it fails.
 * &lt;p/&gt;
 * Matcher implementations should &lt;b&gt;NOT directly implement this interface&lt;/b&gt;.
 * Instead, &lt;b&gt;extend&lt;/b&gt; the {@link Hamcrest\BaseMatcher} abstract class,
 * which will ensure that the Matcher API can grow to support
 * new features and remain compatible with all Matcher implementations.
 * &lt;p/&gt;
 * For easy access to common Matcher implementations, use the static factory
 * methods in {@link Hamcrest\CoreMatchers}.
 *
 * @see Hamcrest\CoreMatchers
 * @see Hamcrest\BaseMatcher
 */
interface Matcher extends SelfDescribing
{

    /**
     * Evaluates the matcher for argument &lt;var&gt;$item&lt;/var&gt;.
     *
     * @param mixed $item the object against which the matcher is evaluated.
     *
     * @return boolean &lt;code&gt;true&lt;/code&gt; if &lt;var&gt;$item&lt;/var&gt; matches,
     *   otherwise &lt;code&gt;false&lt;/code&gt;.
     *
     * @see Hamcrest\BaseMatcher
     */
    public function matches($item);

        /**
         * Generate a description of why the matcher has not accepted the item.
         * The description will be part of a larger description of why a matching
         * failed, so it should be concise.
         * This method assumes that &lt;code&gt;matches($item)&lt;/code&gt; is false, but
         * will not check this.
         *
         * @param mixed $item The item that the Matcher has rejected.
         * @param Description $description
         * @return
         */
    public function describeMismatch($item, Description $description);
}
</textarea><br>
    <input type="submit" value="Save">
</form>