Garden\Schema\Invalid

Complexity

Total Complexity

5

Size/Duplication

Total Lines	44
Duplicated Lines	0 %

Test Coverage

Coverage

100%

Importance

Changes	1
Bugs	0	Features	0

4 Methods

Rating	Name	Duplication	Size	Complexity
A	isValid()	0	2	1
A	__construct()	0	1	1
A	value()	0	5	2
A	isInvalid()	0	2	1

<?php
/**
 * @author Todd Burry <todd@vanillaforums.com>
 * @copyright 2009-2018 Vanilla Forums Inc.
 * @license MIT
 */

namespace Garden\Schema;


/**
 * A singleton that represents an invalid value.
 *
 * The purpose of this class is to provide an alternative to **null** for invalid values when **null** could be considered
 * valid. This class is not meant to be used outside of this library unless you are extended the schema somehow.
 */
class Invalid {
    private static $value;

    /**
     * Private constructor to enforce singleton.
     *
     * @noinspection PhpUnusedPrivateMethodInspection
     */
    private function __construct() {
        // no-op
    }

    /**
     * Return the invalid value.
     *
     * @return Invalid Returns the invalid value.
     */
    public static function value() {
        if (self::$value === null) {
            self::$value = new Invalid();
        }
        return self::$value;
    }

    /**
     * Tests a value to see if it is invalid.
     *
     * @param mixed $value The value to test.
     * @return bool Returns **true** of the value is invalid or **false** otherwise.
     */
    public static function isInvalid($value) {
        return $value === self::value();
    }

    /**
     * Tests whether a value could be valid.
     *
     * Unlike {@link Invalid::inValid()} a value could still be invalid in some way even if this method returns true.
     *
     * @param mixed $value The value to test.
     * @return bool Returns **true** of the value could be invalid or **false** otherwise.
     */
    public static function isValid($value) {
        return $value !== self::value();
    }
}