TheIconic\NameParser\Mapper\AbstractMapper

Complexity

Total Complexity

10

Size/Duplication

Total Lines	77
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
	map()	0	1	?
A	hasUnmappedPartsBefore()	0	14	4
A	getKey()	0	4	1
A	findFirstMapped()	0	12	3
A	sortArrayDescending()	0	8	2

<?php

namespace TheIconic\NameParser\Mapper;

use TheIconic\NameParser\Part\AbstractPart;
use TheIconic\NameParser\Part\Nickname;

abstract class AbstractMapper
{
    /**
     * implements the mapping of parts
     *
     * @param array $parts - the name parts
     * @return array $parts - the mapped parts
     */
    abstract public function map(array $parts);

    /**
     * checks if there are still unmapped parts left before the given position
     *
     * @param array $parts
     * @param int $index
     * @return bool
     */
    protected function hasUnmappedPartsBefore(array $parts, $index): bool
    {
        foreach ($parts as $k => $part) {
            if ($k === $index) {
                break;
            }

            if (!($part instanceof AbstractPart)) {
                return true;
            }
        }

        return false;
    }

    /**
     * @param string $type
     * @param array $parts
     * @return int|bool
     */
    protected function findFirstMapped(string $type, array $parts)
    {
        $total = count($parts);

        for ($i = 0; $i < $total; $i++) {
            if ($parts[$i] instanceof $type) {
                return $i;
            }
        }

        return false;
    }

    /**
     * get the registry lookup key for the given word
     *
     * @param string $word the word
     * @return string the key
     */
    protected function getKey($word): string
    {
        return strtolower(str_replace('.', '', $word));
    }

    /**
     * sort array by length descending and alphabetically ascending
     * https://stackoverflow.com/questions/44835807/sort-array-by-length-and-then-alphabetically
     *
     * @param array $values
     * @return array
     */
    protected function sortArrayDescending(array $values): array
    {
        uasort($values, function($a, $b) {
            return strlen($b) <=> strlen($a) ?: strcmp($a, $b);;
        });

        return $values;
    }
}