From 47a37b71b2ccd8f71c25799eace7c1cd052baaaa Mon Sep 17 00:00:00 2001
From: Robert Hellmann <r.hellmann@outlook.com>
Date: Thu, 24 Oct 2019 21:11:29 +0200
Subject: [PATCH] -doc

---
 src/Reader/StreamReader.php | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/src/Reader/StreamReader.php b/src/Reader/StreamReader.php
index e9e7637..15e2d63 100644
--- a/src/Reader/StreamReader.php
+++ b/src/Reader/StreamReader.php
@@ -27,12 +27,23 @@ final class StreamReader implements ReaderInterface
      */
     private $nextConsumeLength = 0;
 
+    /**
+     * creates a new streamReader instance.
+     *
+     * @param StreamInterface $stream a PSR-7 stream to read from.
+     * @param int $bufferSize internal buffer size to use.
+     */
     public function __construct(StreamInterface $stream, int $bufferSize = 1024)
     {
         $this->stream = $stream;
         $this->bufferSize = $bufferSize;
     }
 
+    /**
+     * checks if reached end of stream.
+     *
+     * @return bool wheather we´re at the end of the stream or not.
+     */
     public function eof(): bool
     {
         //Expand buffer by one byte, most reliable method I guess (it has an eof check inbuilt)
@@ -40,6 +51,15 @@ public function eof(): bool
         return \strlen($this->buffer) <= 0; //There was no way to expand the buffer, basically
     }
 
+    /**
+     * peeks the specified length from the given stream and returns it´s assert string.
+     *
+     * peek won´t move the internal pointer of the stream forward. To move the pointer forward
+     * use consume() after peeking.
+     *
+     * @param int $length the amount of characters to peek (Default: 1).
+     * @return string the peeked string.
+     */
     public function peek(int $length = 1): string
     {
         $this->expandBuffer($length);
@@ -67,6 +87,11 @@ public function consume(int $length = 0): string
         return $consumedBytes;
     }
 
+    /**
+     * expands the internal buffer by the specified bufferSize if it´s below the specified length.
+     *
+     * @param int $length the amount of characters to expand the buffer by
+     */
     private function expandBuffer(int $length): void
     {
         if (\strlen($this->buffer) >= $length || $this->stream->eof()) {