_prepend.php

<?php
declare(strict_types=1);

/*
 * This file is part of the QuidPHP package <https://quidphp.com>
 * Author: Pierre-Philippe Emond <emondpph@gmail.com>
 * License: https://github.com/quidphp/main/blob/master/LICENSE
 */

namespace Quid\Main\Map;
use Quid\Base;
use Quid\Main;

// _prepend
// trait that replaces methods to make the collection prepend per default (add at the beginning)
trait _prepend
{
    // set
    // ajoute ou change une clé valeur dans la map, accepte une clé null
    // si la clé n'existe pas elle est prepend
    final public function set($key,$value):Main\Map
    {
        $this->checkAllowed('set');
        $return = $this->onPrepareThis('set');
        $key = $this->onPrepareKey($key);
        $value = $this->onPrepareValueSet($value);

        if($key === null)
        $return->unshift($value);

        elseif($return->exists($key) && $return->checkBefore(false,$value))
        Base\Arr::setRef($key,$value,$return->arr());

        elseif(Base\Arr::isKey($key))
        $return->prepend([$key=>$value]);

        return $return->checkAfter();
    }


    // add
    // raccourci pour unshift
    final public function add(...$values):Main\Map
    {
        return $this->unshift(...$values);
    }


    // pend
    // raccourci pour prepend
    final public function pend(...$values):Main\Map
    {
        return $this->prepend(...$values);
    }
}
?>