Merge branch 'develop' into task/reader/swar

CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## vx.y.z (Release: aa-bbb-cccc)
 * NEW READER: `swar-4` for reading out files created with Swar version 4.
+* ENHANCEMENT: `Class::getBinaryData` methods return null if field is non-existent
 * BUGFIX: `Player:GetId` returns elo instead of id
 
 ## v1.1.2 (Release: 21-jun-2019)

src/Player.php

@@ -464,11 +464,14 @@ class Player
      * Returns binary data that was read out the pairtwo file but was not needed immediately
      *
      * @param string $Key
-     * @return bool|DateTime|int|string
+     * @return bool|DateTime|int|string|null
      */
     public function getBinaryData(string $Key)
     {
-        return $this->BinaryData[$Key];
+        if (isset($this->BinaryData[$Key])) {
+            return $this->BinaryData[$Key];
+        }
+        return null;
     }
 
     /**

src/Readers/Pairtwo6.php

@@ -103,11 +103,14 @@ class Pairtwo6 implements ReaderInterface
      * Returns binary data that was read out the pairtwo file but was not needed immediately
      *
      * @param string $Key
-     * @return bool|DateTime|int|string
+     * @return bool|DateTime|int|string|null
      */
     public function getBinaryData(string $Key)
     {
-        return $this->BinaryData[$Key];
+        if (isset($this->BinaryData[$Key])) {
+            return $this->BinaryData[$Key];
+        }
+        return null;
     }
 
 
@@ -138,7 +141,7 @@ class Pairtwo6 implements ReaderInterface
         fclose($swshandle);
 
         $offset = 0;
-        
+
 
         $length = 4;
         $this->setRelease($this->readData('String', substr($swscontents, $offset, $length)));