EnumSet.php$0 ➔ rewind() - Code Metrics - Inspection of "[WIP] EnumSet implements IteratorAggregate instea..." - marc-mabe/php-enum - Measure and Improve Code Quality continuously with Scrutinizer

Completed
Pull Request — 4.x (#108)

by Marc
created 2019-02-04 22:00 UTC
EnumSet.php$0 ➔ rewind() A

↳ Parent: anonymous//src/EnumSet.php$0
Complexity

Conditions
Size

Total Lines
Duplication

Lines	0
Ratio	0 %
Code Coverage

Tests	2
CRAP Score	1
Importance

Changes
Metric	Value
dl	0
loc	3
ccs	2
cts	2
cp	1
c	0
b	0
f	0
cc	1
crap	1
rs	10
<?php

declare(strict_types=1);

namespace MabeEnum;

use Countable;
use InvalidArgumentException;
use Iterator;
use IteratorAggregate;
use OutOfBoundsException;

/**
 * A set of enumerators of the given enumeration (EnumSet<T>)
 * based on an integer or binary bitset depending of given enumeration size.
 *
 * @copyright 2019 Marc Bennewitz
 * @license http://github.com/marc-mabe/php-enum/blob/master/LICENSE.txt New BSD License
 * @link http://github.com/marc-mabe/php-enum for the canonical source repository
 */

class EnumSet implements IteratorAggregate, Countable
{
    /**
     * The classname of the Enumeration
     * @var string
     */
    private $enumeration;


    /**
     * Number of enumerators defined in the enumeration
     * @var int
     */
    private $enumerationCount;


    /**
     * Integer or binary (little endian) bitset
     * @var int|string
     */
    private $bitset = 0;


    /**#@+
     * Defines private method names to be called depended of how the bitset type was set too.
     * ... Integer or binary bitset.
     * ... *Int or *Bin method
     * 
     * @var string
     */
    private $fnDoCount             = 'doCountInt';

    private $fnDoGetOrdinals       = 'doGetOrdinalsInt';

    private $fnDoGetBit            = 'doGetBitInt';

    private $fnDoSetBit            = 'doSetBitInt';

    private $fnDoUnsetBit          = 'doUnsetBitInt';

    private $fnDoGetBinaryBitsetLe = 'doGetBinaryBitsetLeInt';

    private $fnDoSetBinaryBitsetLe = 'doSetBinaryBitsetLeInt';

    /**#@-*/

    /**
     * Constructor
     *
     * @param string $enumeration The classname of the enumeration

     * @throws InvalidArgumentException

     */
    public function __construct(string $enumeration)
    {
        if (!\is_subclass_of($enumeration, Enum::class)) {
            throw new InvalidArgumentException(\sprintf(
                '%s can handle subclasses of %s only',
                __METHOD__,
                Enum::class
            ));
        }

        $this->enumeration      = $enumeration;
        $this->enumerationCount = \count($enumeration::getConstants());

        // By default the bitset is initialized as integer bitset
        // in case the enumeraton has more enumerators then integer bits
        // we will switch this into a binary bitset
        if ($this->enumerationCount > \PHP_INT_SIZE * 8) {
            // init binary bitset with zeros
            $this->bitset = \str_repeat("\0", (int)\ceil($this->enumerationCount / 8));

            // switch internal binary bitset functions
            $this->fnDoCount             = 'doCountBin';
            $this->fnDoGetOrdinals       = 'doGetOrdinalsBin';
            $this->fnDoGetBit            = 'doGetBitBin';
            $this->fnDoSetBit            = 'doSetBitBin';
            $this->fnDoUnsetBit          = 'doUnsetBitBin';
            $this->fnDoGetBinaryBitsetLe = 'doGetBinaryBitsetLeBin';
            $this->fnDoSetBinaryBitsetLe = 'doSetBinaryBitsetLeBin';
        }
    }

    /**
     * Get the classname of the enumeration
     * @return string
     */
    public function getEnumeration(): string
    {
        return $this->enumeration;
    }

    /**
     * Attach a new enumerator or overwrite an existing one
     * @param Enum|null|bool|int|float|string|array $enumerator

     * @return void
     * @throws InvalidArgumentException On an invalid given enumerator

     */
    public function attach($enumerator): void
    {
        $this->{$this->fnDoSetBit}(($this->enumeration)::get($enumerator)->getOrdinal());
    }

    /**
     * Detach the given enumerator
     * @param Enum|null|bool|int|float|string|array $enumerator

     * @return void
     * @throws InvalidArgumentException On an invalid given enumerator

     */
    public function detach($enumerator): void
    {
        $this->{$this->fnDoUnsetBit}(($this->enumeration)::get($enumerator)->getOrdinal());
    }

    /**
     * Test if the given enumerator was attached
     * @param Enum|null|bool|int|float|string|array $enumerator

     * @return bool

     */
    public function contains($enumerator): bool
    {
        return $this->{$this->fnDoGetBit}(($this->enumeration)::get($enumerator)->getOrdinal());
    }

    /* IteratorAggregate */

    /**
     * Create and return a new iterator
     * @return Iterator
     */
    public function getIterator(): Iterator
    {
        return new class($this, $this->enumeration, $this->enumerationCount, $this->bitset) implements Iterator {

            /**
             * @var EnumSet
             */
            private $enumSet;

            /**
             * @var string
             */
            private $enumeration;

            /**
             * @var int
             */
            private $enumerationCount;

            /**
             * @var int|string
             */
            private $bitset;

            /**
             * @var int
             */
            private $ordinal = -1;

            /**
             * @var string
             */
            private $fnDoRewind = 'doRewindInt';

            /**
             * Constructor.
             * @param EnumSet    $enumSet

             * @param string     $enumeration

             * @param int        $enumerationCount

             * @param int|string $bitset

             */
            public function __construct(EnumSet $enumSet, $enumeration, $enumerationCount, $bitset)

            {
                $this->enumSet          = $enumSet;
                $this->enumeration      = $enumeration;
                $this->enumerationCount = $enumerationCount;
                $this->bitset           = $bitset;

                // By default the bitset is initialized as integer bitset
                // in case the enumeraton has more enumerators then integer bits
                // we will switch this into a binary bitset
                if ($this->enumerationCount > \PHP_INT_SIZE * 8) {
                    $this->fnDoRewind = 'doRewindBin';
                }

                // go to the first valid iterator position (if any)
                $this->next();
            }

            /**
             * Get the current enumerator
             * @return Enum Returns the current enumerator object
             * @throws OutOfBoundsException On an invalid iterator position

             */
            public function current(): Enum
            {
                if (!$this->valid()) {
                    throw new OutOfBoundsException('Invalid iterator position');
                }

                return ($this->enumeration)::byOrdinal($this->ordinal);
            }

            /**
             * Get the ordinal number of the current iterator position
             * @return int The ordinal number of the current enumerator

             * @throws OutOfBoundsException On an invalid iterator position

             */
            public function key(): int
            {
                if (!$this->valid()) {
                    throw new OutOfBoundsException('Invalid iterator position');
                }

                return $this->ordinal;
            }

            /**
             * Go to the next valid iterator position.
             * If no valid iterator position is found the iterator position will be the last possible + 1.

             * @return void
             */
            public function next(): void
            {
                do {
                    if (++$this->ordinal >= $this->enumerationCount) {
                        $this->ordinal = $this->enumerationCount;
                        return;
                    }
                } while (!$this->enumSet->getBit($this->ordinal));
            }

            /**
             * Go to the first valid iterator position.
             * If no valid iterator position was found the iterator position will be 0.
             * @return void
             * @uses doRewindBin()
             * @uses doRewindInt()
             */
            public function rewind(): void
            {
                $this->{$this->fnDoRewind}();
            }

            /**
             * Go to the first valid iterator position.
             * If no valid iterator position was found the iterator position will be 0.
             *
             * This is the binary bitset implementation.
             *
             * @return void
             * @see rewind()
             * @see doRewindInt()
             */
            private function doRewindBin(): void
            {
                if (\ltrim($this->bitset, "\0") !== '') {
                    $this->ordinal = -1;
                    $this->next();
                } else {
                    $this->ordinal = 0;
                }
            }

            /**
             * Go to the first valid iterator position.
             * If no valid iterator position was found the iterator position will be 0.
             *
             * This is the integer bitset implementation.
             *
             * @return void
             * @see rewind()
             * @see doRewindBin()
             */
            private function doRewindInt(): void
            {
                if ($this->bitset) {
                    $this->ordinal = -1;
                    $this->next();
                } else {
                    $this->ordinal = 0;
                }
            }

            /**
             * Test if the current iterator position is valid
             * @return bool

             */
            public function valid(): bool
            {
                return $this->ordinal !== $this->enumerationCount && $this->enumSet->getBit($this->ordinal);

            }
        };
    }

    /* Countable */

    /**
     * Count the number of elements
     *
     * @return int

     * @uses doCountBin()
     * @uses doCountInt()
     */
    public function count(): int
    {
        return $this->{$this->fnDoCount}();
    }

    /**
     * Count the number of elements.
     *
     * This is the binary bitset implementation.
     *
     * @return int

     * @see count()
     * @see doCountInt()
     */
    private function doCountBin(): int
    {
        $count   = 0;
        $bitset  = $this->bitset;
        $byteLen = \strlen($bitset);
        for ($bytePos = 0; $bytePos < $byteLen; ++$bytePos) {
            if ($bitset[$bytePos] === "\0") {
                // fast skip null byte
                continue;
            }

            $ord = \ord($bitset[$bytePos]);
            if ($ord & 0b00000001) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b00000010) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b00000100) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b00001000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b00010000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b00100000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b01000000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            if ($ord & 0b10000000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
        }
        return $count;
    }

    /**
     * Count the number of elements.
     *
     * This is the integer bitset implementation.
     *
     * @return int

     * @see count()
     * @see doCountBin()
     */
    private function doCountInt(): int
    {
        $count  = 0;
        $bitset = $this->bitset;

        // PHP does not support right shift unsigned
        if ($bitset < 0) {
            $count  = 1;
            $bitset = $bitset & \PHP_INT_MAX;
        }

        // iterate byte by byte and count set bits
        $phpIntBitSize = \PHP_INT_SIZE * 8;
        for ($bitPos = 0; $bitPos < $phpIntBitSize; $bitPos += 8) {
            $bitChk = 0xff << $bitPos;
            $byte = $bitset & $bitChk;
            if ($byte) {
                $byte = $byte >> $bitPos;
                if ($byte & 0b00000001) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b00000010) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b00000100) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b00001000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b00010000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b00100000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b01000000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
                if ($byte & 0b10000000) ++$count;
// Without braces (not recommended)
if (true)
    doSomething();

// Recommended
if (true) {
    doSomething();
}
            }

            if ($bitset <= $bitChk) {
                break;
            }
        }

        return $count;
    }

    /**
     * Check if this EnumSet is the same as other
     * @param EnumSet $other

     * @return bool

     */
    public function isEqual(EnumSet $other): bool
    {
        return $this->enumeration === $other->enumeration
            && $this->bitset === $other->bitset;
    }

    /**
     * Check if this EnumSet is a subset of other
     * @param EnumSet $other

     * @return bool

     */
    public function isSubset(EnumSet $other): bool
    {
        return $this->enumeration === $other->enumeration
            && ($this->bitset & $other->bitset) === $this->bitset;
    }

    /**
     * Check if this EnumSet is a superset of other
     * @param EnumSet $other

     * @return bool

     */
    public function isSuperset(EnumSet $other): bool
    {
        return $this->enumeration === $other->enumeration
            && ($this->bitset | $other->bitset) === $this->bitset;
    }

    /**
     * Produce a new set with enumerators from both this and other (this | other)
     *
     * @param EnumSet $other EnumSet of the same enumeration to produce the union

     * @return EnumSet
     * @throws InvalidArgumentException If $other doesn't match the enumeration

     */
    public function union(EnumSet $other): EnumSet
    {
        if ($this->enumeration !== $other->enumeration) {
            throw new InvalidArgumentException(\sprintf(
                'Other should be of the same enumeration as this %s',
                $this->enumeration
            ));
        }

        $clone = clone $this;
        $clone->bitset = $this->bitset | $other->bitset;
        return $clone;
    }

    /**
     * Produce a new set with enumerators common to both this and other (this & other)
     *
     * @param EnumSet $other EnumSet of the same enumeration to produce the intersect

     * @return EnumSet
     * @throws InvalidArgumentException If $other doesn't match the enumeration

     */
    public function intersect(EnumSet $other): EnumSet
    {
        if ($this->enumeration !== $other->enumeration) {
            throw new InvalidArgumentException(\sprintf(
                'Other should be of the same enumeration as this %s',
                $this->enumeration
            ));
        }

        $clone = clone $this;
        $clone->bitset = $this->bitset & $other->bitset;
        return $clone;
    }

    /**
     * Produce a new set with enumerators in this but not in other (this - other)
     *
     * @param EnumSet $other EnumSet of the same enumeration to produce the diff

     * @return EnumSet
     * @throws InvalidArgumentException If $other doesn't match the enumeration

     */
    public function diff(EnumSet $other): EnumSet
    {
        if ($this->enumeration !== $other->enumeration) {
            throw new InvalidArgumentException(\sprintf(
                'Other should be of the same enumeration as this %s',
                $this->enumeration
            ));
        }

        $clone = clone $this;
        $clone->bitset = $this->bitset & ~$other->bitset;
        return $clone;
    }

    /**
     * Produce a new set with enumerators in either this and other but not in both (this ^ other)
     *
     * @param EnumSet $other EnumSet of the same enumeration to produce the symmetric difference

     * @return EnumSet
     * @throws InvalidArgumentException If $other doesn't match the enumeration

     */
    public function symDiff(EnumSet $other): EnumSet
    {
        if ($this->enumeration !== $other->enumeration) {
            throw new InvalidArgumentException(\sprintf(
                'Other should be of the same enumeration as this %s',
                $this->enumeration
            ));
        }

        $clone = clone $this;
        $clone->bitset = $this->bitset ^ $other->bitset;
        return $clone;
    }

    /**
     * Get ordinal numbers of the defined enumerators as array
     * @return int[]
     * @uses  doGetOrdinalsBin()
     * @uses  doGetOrdinalsInt()
     */
    public function getOrdinals(): array
    {
        return $this->{$this->fnDoGetOrdinals}();
    }

    /**
     * Get ordinal numbers of the defined enumerators as array.
     *
     * This is the binary bitset implementation.
     *
     * @return int[]
     * @see getOrdinals()
     * @see goGetOrdinalsInt()
     */
    private function doGetOrdinalsBin(): array
    {
        $ordinals = [];
        $bitset   = $this->bitset;
        $byteLen  = \strlen($bitset);
        for ($bytePos = 0; $bytePos < $byteLen; ++$bytePos) {
            if ($bitset[$bytePos] === "\0") {
                // fast skip null byte
                continue;
            }

            $ord = \ord($bitset[$bytePos]);
            for ($bitPos = 0; $bitPos < 8; ++$bitPos) {
                if ($ord & (1 << $bitPos)) {
                    $ordinals[] = $bytePos * 8 + $bitPos;
                }
            }
        }
        return $ordinals;
    }

    /**
     * Get ordinal numbers of the defined enumerators as array.
     *
     * This is the integer bitset implementation.
     *
     * @return int[]
     * @see getOrdinals()
     * @see doGetOrdinalsBin()
     */
    private function doGetOrdinalsInt(): array
    {
        $ordinals   = [];
        $ordinalMax = $this->enumerationCount;
        $bitset     = $this->bitset;
        for ($ord = 0; $ord < $ordinalMax; ++$ord) {
            if ($bitset & (1 << $ord)) {
                $ordinals[] = $ord;
            }
        }
        return $ordinals;
    }

    /**
     * Get values of the defined enumerators as array
     * @return mixed[]
     */
    public function getValues(): array
    {
        $enumeration = $this->enumeration;
        $values      = [];
        foreach ($this->getOrdinals() as $ord) {
            $values[] = $enumeration::byOrdinal($ord)->getValue();
        }
        return $values;
    }

    /**
     * Get names of the defined enumerators as array
     * @return string[]
     */
    public function getNames(): array
    {
        $enumeration = $this->enumeration;
        $names       = [];
        foreach ($this->getOrdinals() as $ord) {
            $names[] = $enumeration::byOrdinal($ord)->getName();
        }
        return $names;
    }

    /**
     * Get the defined enumerators as array
     * @return Enum[]
     */
    public function getEnumerators(): array
    {
        $enumeration = $this->enumeration;
        $enumerators = [];
        foreach ($this->getOrdinals() as $ord) {
            $enumerators[] = $enumeration::byOrdinal($ord);
        }
        return $enumerators;
    }

    /**
     * Get binary bitset in little-endian order
     * 
     * @return string
     * @uses doGetBinaryBitsetLeBin()
     * @uses doGetBinaryBitsetLeInt()
     */
    public function getBinaryBitsetLe(): string
    {
        return $this->{$this->fnDoGetBinaryBitsetLe}();
    }

    /**
     * Get binary bitset in little-endian order.
     *
     * This is the binary bitset implementation.
     *
     * @return string
     * @see getBinaryBitsetLe()
     * @see doGetBinaryBitsetLeInt()
     */
    private function doGetBinaryBitsetLeBin(): string
    {
        return $this->bitset;
    }

    /**
     * Get binary bitset in little-endian order.
     *
     * This is the integer bitset implementation.
     *
     * @return string
     * @see getBinaryBitsetLe()
     * @see doGetBinaryBitsetLeBin()
     */
    private function doGetBinaryBitsetLeInt(): string
    {
        $bin = \pack(\PHP_INT_SIZE === 8 ? 'P' : 'V', $this->bitset);
        return \substr($bin, 0, (int)\ceil($this->enumerationCount / 8));
    }

    /**
     * Set binary bitset in little-endian order
     *
     * NOTE: It resets the current position of the iterator
     * 
     * @param string $bitset

     * @return void
     * @throws InvalidArgumentException On out-of-range bits given as input bitset

     * @uses doSetBinaryBitsetLeBin()
     * @uses doSetBinaryBitsetLeInt()
     */
    public function setBinaryBitsetLe(string $bitset): void
    {
        $this->{$this->fnDoSetBinaryBitsetLe}($bitset);
    }

    /**
     * Set binary bitset in little-endian order
     *
     * NOTE: It resets the current position of the iterator
     *
     * @param string $bitset

     * @return void
     * @throws InvalidArgumentException On out-of-range bits given as input bitset

     * @see setBinaryBitsetLeBin()
     * @see doSetBinaryBitsetLeInt()
     */
    private function doSetBinaryBitsetLeBin(string $bitset): void
    {
        $size   = \strlen($this->bitset);
        $sizeIn = \strlen($bitset);

        if ($sizeIn < $size) {
            // add "\0" if the given bitset is not long enough
            $bitset .= \str_repeat("\0", $size - $sizeIn);
        } elseif ($sizeIn > $size) {
            if (\ltrim(\substr($bitset, $size), "\0") !== '') {
                throw new InvalidArgumentException('out-of-range bits detected');
            }
            $bitset = \substr($bitset, 0, $size);
        }

        // truncate out-of-range bits of last byte
        $lastByteMaxOrd = $this->enumerationCount % 8;
        if ($lastByteMaxOrd !== 0) {
            $lastByte         = $bitset[-1];
            $lastByteExpected = \chr((1 << $lastByteMaxOrd) - 1) & $lastByte;
            if ($lastByte !== $lastByteExpected) {
                throw new InvalidArgumentException('out-of-range bits detected');
            }

            $this->bitset = \substr($bitset, 0, -1) . $lastByteExpected;
        }

        $this->bitset = $bitset;
    }

    /**
     * Set binary bitset in little-endian order
     *
     * NOTE: It resets the current position of the iterator
     *
     * @param string $bitset

     * @return void
     * @throws InvalidArgumentException On out-of-range bits given as input bitset

     * @see setBinaryBitsetLeBin()
     * @see doSetBinaryBitsetLeBin()
     */
    private function doSetBinaryBitsetLeInt(string $bitset): void
    {
        $len = \strlen($bitset);
        $int = 0;
        for ($i = 0; $i < $len; ++$i) {
            $ord = \ord($bitset[$i]);

            if ($ord && $i > \PHP_INT_SIZE - 1) {
                throw new InvalidArgumentException('out-of-range bits detected');
            }

            $int |= $ord << (8 * $i);
        }

        if ($int & (~0 << $this->enumerationCount)) {
            throw new InvalidArgumentException('out-of-range bits detected');
        }

        $this->bitset = $int;
    }

    /**
     * Get binary bitset in big-endian order
     * 
     * @return string
     */
    public function getBinaryBitsetBe(): string
    {
        return \strrev($this->bitset);
    }

    /**
     * Set binary bitset in big-endian order
     *
     * NOTE: It resets the current position of the iterator
     * 
     * @param string $bitset

     * @return void
     * @throws InvalidArgumentException On out-of-range bits given as input bitset

     */
    public function setBinaryBitsetBe(string $bitset): void
    {
        $this->setBinaryBitsetLe(\strrev($bitset));
    }

    /**
     * Get a bit at the given ordinal number
     *
     * @param int $ordinal Ordinal number of bit to get

     * @return bool

     * @throws InvalidArgumentException If the given ordinal number is out-of-range

     * @uses doGetBitBin()
     * @uses doGetBitInt()
     */
    public function getBit(int $ordinal): bool
    {
        if ($ordinal < 0 || $ordinal > $this->enumerationCount) {
            throw new InvalidArgumentException("Ordinal number must be between 0 and {$this->enumerationCount}");
// Instead of
$x = "foo $bar $baz";

// Better use either
$x = "foo " . $bar . " " . $baz;
$x = sprintf("foo %s %s", $bar, $baz);
        }

        return $this->{$this->fnDoGetBit}($ordinal);
    }

    /**
     * Get a bit at the given ordinal number.
     *
     * This is the binary bitset implementation.
     *
     * @param int $ordinal Ordinal number of bit to get

     * @return bool

     * @see getBit()
     * @see doGetBitInt()
     */
    private function doGetBitBin(int $ordinal): bool
    {
        return (\ord($this->bitset[(int) ($ordinal / 8)]) & 1 << ($ordinal % 8)) !== 0;
    }

    /**
     * Get a bit at the given ordinal number.
     *
     * This is the integer bitset implementation.
     * 
     * @param int $ordinal Ordinal number of bit to get

     * @return bool

     * @see getBit()
     * @see doGetBitBin()
     */
    private function doGetBitInt(int $ordinal): bool
    {
        return (bool)($this->bitset & (1 << $ordinal));
    }

    /**
     * Set a bit at the given ordinal number
     *
     * @param int $ordinal Ordinal number of bit to set

     * @param bool $bit    The bit to set

     * @return void
     * @throws InvalidArgumentException If the given ordinal number is out-of-range

     * @uses doSetBitBin()
     * @uses doSetBitInt()
     * @uses doUnsetBitBin()
     * @uses doUnsetBitInt()
     */
    public function setBit(int $ordinal, bool $bit): void
    {
        if ($ordinal < 0 || $ordinal > $this->enumerationCount) {
            throw new InvalidArgumentException("Ordinal number must be between 0 and {$this->enumerationCount}");
// Instead of
$x = "foo $bar $baz";

// Better use either
$x = "foo " . $bar . " " . $baz;
$x = sprintf("foo %s %s", $bar, $baz);
        }

        if ($bit) {
            $this->{$this->fnDoSetBit}($ordinal);
        } else {
            $this->{$this->fnDoUnsetBit}($ordinal);
        }
    }

    /**
     * Set a bit at the given ordinal number.
     *
     * This is the binary bitset implementation.
     * 
     * @param int $ordinal Ordinal number of bit to set

     * @return void
     * @see setBit()
     * @see doSetBitInt()
     */
    private function doSetBitBin(int $ordinal): void
    {
        $byte = (int) ($ordinal / 8);
        $this->bitset[$byte] = $this->bitset[$byte] | \chr(1 << ($ordinal % 8));
    }

    /**
     * Set a bit at the given ordinal number.
     *
     * This is the binary bitset implementation.
     *
     * @param int $ordinal Ordinal number of bit to set

     * @return void
     * @see setBit()
     * @see doSetBitBin()
     */
    private function doSetBitInt(int $ordinal): void
    {
        $this->bitset = $this->bitset | (1 << $ordinal);
    }

    /**
     * Unset a bit at the given ordinal number.
     *
     * This is the binary bitset implementation.
     *
     * @param int $ordinal Ordinal number of bit to unset

     * @return void
     * @see setBit()
     * @see doUnsetBitInt()
     */
    private function doUnsetBitBin(int $ordinal): void
    {
        $byte = (int) ($ordinal / 8);
        $this->bitset[$byte] = $this->bitset[$byte] & \chr(~(1 << ($ordinal % 8)));
    }

    /**
     * Unset a bit at the given ordinal number.
     *
     * This is the integer bitset implementation.
     *
     * @param int $ordinal Ordinal number of bit to unset

     * @return void
     * @see setBit()
     * @see doUnsetBitBin()
     */
    private function doUnsetBitInt(int $ordinal): void
    {
        $this->bitset = $this->bitset & ~(1 << $ordinal);
    }
}

1			<?php
2
3			declare(strict_types=1);
4
5			namespace MabeEnum;
6
7			use Countable;
8			use InvalidArgumentException;
9			use Iterator;
10			use IteratorAggregate;
11			use OutOfBoundsException;
12
13			/**
14			* A set of enumerators of the given enumeration (EnumSet<T>)
15			* based on an integer or binary bitset depending of given enumeration size.
16			*
17			* @copyright 2019 Marc Bennewitz
18			* @license http://github.com/marc-mabe/php-enum/blob/master/LICENSE.txt New BSD License
19			* @link http://github.com/marc-mabe/php-enum for the canonical source repository
20			*/
			3 ignored issues – show Coding Style introduced 2019-02-02 18:45 UTC by Report Bug Copy Issue Report Missing @category tag in class comment Loading history... Coding Style introduced 2019-02-02 18:45 UTC by Report Bug Copy Issue Report Missing @package tag in class comment Loading history... Coding Style introduced 2019-02-02 18:45 UTC by Report Bug Copy Issue Report Missing @author tag in class comment Loading history...
21			class EnumSet implements IteratorAggregate, Countable
22			{
23			/**
24			* The classname of the Enumeration
25			* @var string
26			*/
27			private $enumeration;
			1 ignored issue – show Coding Style introduced 2019-02-04 19:09 UTC by Report Bug Copy Issue Report Expected 1 blank line before member var; 0 found Loading history... Coding Style introduced 2019-02-04 19:09 UTC by Report Bug Copy Issue Report Private member variable "enumeration" must contain a leading underscore Loading history...
28
29			/**
30			* Number of enumerators defined in the enumeration
31			* @var int
32			*/
33			private $enumerationCount;
			1 ignored issue – show Coding Style introduced 2019-02-04 19:09 UTC by Report Bug Copy Issue Report Private member variable "enumerationCount" must contain a leading underscore Loading history...
34
35			/**
36			* Integer or binary (little endian) bitset
37			* @var int\|string
marc-mabe / php-enum

Pull Request — 4.x (#108)

EnumSet.php$0 ➔ rewind() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like
