/**
  * merge a single key into our array
  *
  * @param  array &$ours
  *         the array to merge into
  * @param  mixed $key
  *         the array key to merge into
  * @param  mixed $value
  *         the data to merge in
  * @return void
  */
 private static function mergeKeyIntoArray(&$ours, $key, $value)
 {
     // general case - overwrite because merging isn't possible
     if (ShouldOverwrite::intoArray($ours, $key, $value)) {
         $ours[$key] = $value;
         return;
     }
     // special case - we are merging into an object
     if (is_object($ours[$key])) {
         MergeIntoAssignable::from($ours[$key], $value);
         return;
     }
     // at this point, we are merging into an array, using recursion
     // for which I am going to hell
     MergeIntoIndexable::from($ours[$key], $value);
 }
 /**
  * @covers ::from
  * @expectedException GanbaroDigital\DataContainers\Exceptions\E4xx_UnsupportedType
  * @dataProvider provideUnsupportedTypes
  */
 public function testStaticCallThrowsExceptionWhenUnsupportedTypeProvidedAsSecondArg($theirs)
 {
     // ----------------------------------------------------------------
     // setup your test
     $data = (object) [];
     // ----------------------------------------------------------------
     // perform the change
     MergeIntoAssignable::from($data, $theirs);
 }
 /**
  * merge their data into one of our object's properties
  *
  * @param  object &$obj
  *         the object that we want to merge into
  * @param  string $property
  *         the property to merge into
  * @param  mixed $value
  *         the data that we want to merge from
  * @return void
  */
 public static function ofObject($obj, $property, $value)
 {
     // robustness!
     RequireAssignable::check($obj, E4xx_UnsupportedType::class);
     // easiest case - no clash
     if (ShouldOverwrite::intoObject($obj, $property, $value)) {
         $obj->{$property} = $value;
         return;
     }
     // special case - we are merging into an object
     if (is_object($obj->{$property})) {
         MergeIntoAssignable::from($obj->{$property}, $value);
         return;
     }
     // if we get here, then we must be merging into an array
     MergeIntoIndexable::from($obj->{$property}, $value);
 }