Collections\Traits\GuardTrait

Complexity

Total Complexity

8

Size/Duplication

Total Lines	38
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	2

Test Coverage

Coverage

62.5%

Importance

Changes	1
Bugs	0	Features	0

6 Methods

Rating	Name	Duplication	Size	Complexity
	isEmpty()	0	1	?
	count()	0	1	?
A	emptyGuard()	0	8	2
A	validateKeyBounds()	0	6	2
A	isBoundedKey()	0	4	2
A	validateKeyType()	0	6	2

<?php

namespace Collections\Traits;

use Collections\Exception\EmptyException;
use Collections\Exception\TypeException;

trait GuardTrait
{
    abstract function isEmpty();

It is generally recommended to explicitly declare the visibility for methods.

    abstract function count();

It is generally recommended to explicitly declare the visibility for methods.

    protected function emptyGuard($method)
    {
        if ($this->isEmpty()) {
            throw new EmptyException(
                "{$method} cannot be called when the structure is empty"
            );
        }
    }

    protected function validateKeyBounds($k)
    {
        if (!$this->isBoundedKey($k)) {
            throw new \OutOfBoundsException("Integer key $k is out of bounds");
        }
    }

    /**
     * @param int $element
     * @return mixed
     */
    protected function isBoundedKey($element)
    {
        return $element >= 0 && $element < $this->count();
    }

    protected function validateKeyType($element)
    {
        if (filter_var($element, FILTER_VALIDATE_INT) === false) {
            throw new TypeException('Only integer keys may be used with ' . (get_class($this)));
        }
    }
}