void_not_null

void_not_null-workaround.php

<?php

use \stdClass;

/*
```php
<?php

use VoidNotNullWorkaroundTrait;

class MyClass {
  use VoidNotNullWorkaroundTrait;
}

MyClass::fakeVoidAndNullInit();
```
*/

trait VoidNotNullWorkaroundTrait {

  static public function fakeVoidAndNullInit() {
    self::fakeVoidInit();
    self::fakeNullInit();
  }

  protected static $fakeVoid;

  static public function fakeVoidInit() {
    if(!isset(self::$fakeVoid)) {
      self::$fakeVoid = new stdClass();
    }
  }

  static public function &fakeVoid() {
    return self::$fakeVoid;
  }

  static public function isFakeVoid(&$value) {
    return ($value === self::$fakeVoid);
  }

  protected static $fakeNull;

  static public function fakeNullInit() {
    if(!isset(self::$fakeNull)) {
      self::$fakeNull = new stdClass();
    }
  }

  static public function &fakeNull() {
    return self::$fakeNull;
  }

  static public function isFakeNull(&$value) {
    return ($value === self::$fakeNull);
  }

}

void_not_null.php

<?php

// Dear PHP, me not happy:

function a_VOID_NOT_NULL_returning_function() {}

echo empty(a_VOID_NOT_NULL_returning_function())."\n";
  // prints 1
echo is_null(a_VOID_NOT_NULL_returning_function())."\n";
  // prints 1
echo (null === a_VOID_NOT_NULL_returning_function())."\n";
  // prints 1
echo (null !== a_VOID_NOT_NULL_returning_function())."\n";
  // prints
echo (null == a_VOID_NOT_NULL_returning_function())."\n";
  // prints 1
echo (null != a_VOID_NOT_NULL_returning_function())."\n";
  // prints
echo (json_encode(a_VOID_NOT_NULL_returning_function()))."\n";
  // prints null
echo (serialize(null))."\n";
  // prints N;
echo (serialize(a_VOID_NOT_NULL_returning_function()))."\n";
  // prints N;

// Reason: Promises.
// Hello "Workaround"! Hello "Never ending explanations"!