: str_replace(): Passing null to parameter #2 ($replace) of type array|string is deprecated in
declare (strict_types=1);
namespace YoastSEO_Vendor\GuzzleHttp\Psr7;
use YoastSEO_Vendor\Psr\Http\Message\StreamInterface;
* Decorator used to return only a subset of a stream.
final class LimitStream implements \YoastSEO_Vendor\Psr\Http\Message\StreamInterface
use StreamDecoratorTrait;
/** @var int Offset to start reading from */
/** @var int Limit the number of bytes that can be read */
/** @var StreamInterface */
* @param StreamInterface $stream Stream to wrap
* @param int $limit Total number of bytes to allow to be read
* from the stream. Pass -1 for no limit.
* @param int $offset Position to seek to before reading (only
* works on seekable streams).
public function __construct(\YoastSEO_Vendor\Psr\Http\Message\StreamInterface $stream, int $limit = -1, int $offset = 0)
$this->setOffset($offset);
public function eof() : bool
// Always return true if the underlying stream is EOF
if ($this->stream->eof()) {
// No limit and the underlying stream is not at EOF
if ($this->limit === -1) {
return $this->stream->tell() >= $this->offset + $this->limit;
* Returns the size of the limited subset of data
public function getSize() : ?int
if (null === ($length = $this->stream->getSize())) {
} elseif ($this->limit === -1) {
return $length - $this->offset;
return \min($this->limit, $length - $this->offset);
* Allow for a bounded seek on the read limited stream
public function seek($offset, $whence = \SEEK_SET) : void
if ($whence !== \SEEK_SET || $offset < 0) {
throw new \RuntimeException(\sprintf('Cannot seek to offset %s with whence %s', $offset, $whence));
$offset += $this->offset;
if ($this->limit !== -1) {
if ($offset > $this->offset + $this->limit) {
$offset = $this->offset + $this->limit;
$this->stream->seek($offset);
public function tell() : int
return $this->stream->tell() - $this->offset;
* Set the offset to start limiting from
* @param int $offset Offset to seek to and begin byte limiting from
* @throws \RuntimeException if the stream cannot be seeked.
public function setOffset(int $offset) : void
$current = $this->stream->tell();
if ($current !== $offset) {
// If the stream cannot seek to the offset position, then read to it
if ($this->stream->isSeekable()) {
$this->stream->seek($offset);
} elseif ($current > $offset) {
throw new \RuntimeException("Could not seek to stream offset {$offset}");
$this->stream->read($offset - $current);
* Set the limit of bytes that the decorator allows to be read from the
* @param int $limit Number of bytes to allow to be read from the stream.
public function setLimit(int $limit) : void
public function read($length) : string
if ($this->limit === -1) {
return $this->stream->read($length);
// Check if the current position is less than the total allowed
// bytes + original offset
$remaining = $this->offset + $this->limit - $this->stream->tell();
// Only return the amount of requested data, ensuring that the byte
return $this->stream->read(\min($remaining, $length));