Merge pull request #3 from pavog/fix-return-type

Change return types of many functions to static and adjust some phpdocs

Author: KurtThiemann

src/IO/Reader/AbstractReader.php

@@ -31,9 +31,9 @@ public function getFormat(): int
 
     /**
      * @param int $format
-     * @return AbstractReader
+     * @return $this
      */
-    public function setFormat(int $format): AbstractReader
+    public function setFormat(int $format): static
     {
         $this->format = $format;
         $this->deserializer = null;

src/IO/Writer/AbstractWriter.php

@@ -31,9 +31,9 @@ public function getFormat(): int
 
     /**
      * @param int $format
-     * @return AbstractWriter
+     * @return $this
      */
-    public function setFormat(int $format): AbstractWriter
+    public function setFormat(int $format): static
     {
         $this->format = $format;
         $this->serializer = null;

src/Tag/CompoundTag.php

@@ -239,7 +239,7 @@ public function jsonSerialize()
      * @return $this
      * @throws Exception
      */
-    public function set(?string $name, Tag $tag): CompoundTag
+    public function set(?string $name, Tag $tag): static
     {
         $this->offsetSet($name, $tag);
         return $this;
@@ -250,7 +250,7 @@ public function set(?string $name, Tag $tag): CompoundTag
      * @return $this
      * @throws Exception
      */
-    public function delete(string $name): CompoundTag
+    public function delete(string $name): static
     {
         $this->offsetUnset($name);
         return $this;

src/Tag/DoubleTag.php

@@ -46,7 +46,7 @@ protected static function readContentRaw(Reader $reader, TagOptions $options): s
     /**
      * @inheritDoc
      */
-    public function setValue(float $value): FloatValueTag
+    public function setValue(float $value): static
     {
         $this->resetRawValue();
         return parent::setValue($value);

src/Tag/FloatTag.php

@@ -46,7 +46,7 @@ protected static function readContentRaw(Reader $reader, TagOptions $options): s
     /**
      * @inheritDoc
      */
-    public function setValue(float $value): FloatValueTag
+    public function setValue(float $value): static
     {
         $this->resetRawValue();
         return parent::setValue($value);

src/Tag/FloatValueTag.php

@@ -18,7 +18,7 @@ public function getValue(): float
      * @param float $value
      * @return $this
      */
-    public function setValue(float $value): FloatValueTag
+    public function setValue(float $value): static
     {
         $this->value = $value;
         return $this;

src/Tag/IntValueTag.php

@@ -18,7 +18,7 @@ public function getValue(): int
      * @param int $value
      * @return $this
      */
-    public function setValue(int $value): IntValueTag
+    public function setValue(int $value): static
     {
         $this->value = $value;
         return $this;

src/Tag/ListTag.php

@@ -57,10 +57,10 @@ public function getContentTag(): int
 
     /**
      * @param int $contentTagType
-     * @return ListTag
+     * @return $this
      * @throws Exception
      */
-    public function setContentTag(int $contentTagType): ListTag
+    public function setContentTag(int $contentTagType): static
     {
         if ($this->isRaw()) {
             throw new Exception("Raw list tags cannot be modified");
@@ -83,7 +83,7 @@ public function setContentTag(int $contentTagType): ListTag
     protected function readValues(Reader $reader, int $length): array
     {
         $values = [];
-        /** @var Tag $tagClass */
+        /** @var class-string<Tag>|null $tagClass */
         $tagClass = Tag::getTagClass($this->contentTagType);
         if (is_null($tagClass)) {
             throw new Exception("Unknown ListTag content type " . $this->contentTagType);
@@ -153,7 +153,7 @@ protected static function readValueTagsRaw(Reader $reader, TagOptions $options,
     {
         $valueData = "";
 
-        /** @var Tag $tagClass */
+        /** @var class-string<Tag>|null $tagClass */
         $tagClass = Tag::getTagClass($contentType);
         if (is_null($tagClass)) {
             throw new Exception("Unknown ListTag content type " . $contentType);
@@ -198,7 +198,7 @@ public function offsetSet($offset, $value)
             throw new Exception("Raw list tags cannot be modified");
         }
 
-        /** @var Tag $previousValue */
+        /** @var Tag|null $previousValue */
         $previousValue = $this->valueArray[$offset] ?? null;
         parent::offsetSet($offset, $value);
         $value->setParentTag($this);
@@ -207,14 +207,15 @@ public function offsetSet($offset, $value)
 
     /**
      * @inheritDoc
+     * @throws Exception
      */
     public function offsetUnset($offset)
     {
         if ($this->isRaw()) {
             throw new Exception("Raw list tags cannot be modified");
         }
 
-        /** @var Tag $previousValue */
+        /** @var Tag|null $previousValue */
         $previousValue = $this->valueArray[$offset] ?? null;
         $previousValue?->setParentTag(null);
         parent::offsetUnset($offset);

src/Tag/LongTag.php

@@ -48,7 +48,7 @@ protected static function readContentRaw(Reader $reader, TagOptions $options): s
     /**
      * @inheritDoc
      */
-    public function setValue(int $value): IntValueTag
+    public function setValue(int $value): static
     {
         $this->resetRawValue();
         return parent::setValue($value);

src/Tag/StringTag.php

@@ -22,9 +22,9 @@ public function getValue(): string
 
     /**
      * @param string $value
-     * @return StringTag
+     * @return $this
      */
-    public function setValue(string $value): StringTag
+    public function setValue(string $value): static
     {
         $this->value = $value;
         return $this;