theiconic / name-parser

src/Mapper/AbstractMapper.php

<?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 $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)

This method seems to be duplicated in your project.

    {
        $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));
    }
}