feat: add more string handle methods, class

Author: inhere

src/Obj/ConfigObject.php renamed to src/Obj/DataObject.php

@@ -10,13 +10,16 @@
 namespace Toolkit\Stdlib\Obj;
 
 use ArrayObject;
+use JsonSerializable;
+use Toolkit\Stdlib\Helper\JsonHelper;
+use UnexpectedValueException;
 
 /**
  * Class ConfigObject
  *
  * @package Toolkit\Stdlib\Obj
  */
-class ConfigObject extends ArrayObject
+class DataObject extends ArrayObject  implements JsonSerializable
 {
     /**
      * @param array $data
@@ -28,6 +31,17 @@ public static function new(array $data = []): self
         return new static($data);
     }
 
+    /**
+     * @param string $key
+     * @param mixed  $default
+     *
+     * @return mixed|null
+     */
+    public function get(string $key, $default = null)
+    {
+        return $this[$key] ?? $default;
+    }
+
     /**
      * @param string $key
      * @param mixed  $default
@@ -95,6 +109,21 @@ public function getString(string $key, string $default = ''): string
         return $default;
     }
 
+    /**
+     * @param string $key
+     *
+     * @return string
+     */
+    public function getNotBlock(string $key): string
+    {
+        $val = $this->get($key, '');
+        if ($val === '') {
+            throw new UnexpectedValueException("the $key value cannot be empty");
+        }
+
+        return $val;
+    }
+
     /**
      * @param string $key
      * @param array  $default
@@ -110,11 +139,53 @@ public function getArray(string $key, array $default = []): array
         return $default;
     }
 
+    /**
+     * @param string $key
+     *
+     * @return self
+     */
+    public function getSubObject(string $key): self
+    {
+        return new self($this->getArray($key));
+    }
+
     /**
      * @return array
      */
     public function toArray(): array
     {
         return $this->getArrayCopy();
     }
+
+    /**
+     * @return string
+     */
+    public function toString(): string
+    {
+        return JsonHelper::enc($this->getArrayCopy(), JSON_THROW_ON_ERROR);
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        return $this->toString();
+    }
+
+    /**
+     * @return mixed
+     */
+    public function jsonSerialize(): array
+    {
+        return $this->getArrayCopy();
+    }
+
+    /**
+     * @return bool
+     */
+    public function isEmpty(): bool
+    {
+        return $this->count() === 0;
+    }
 }

src/Util/BaseStream.php renamed to src/Std/BaseStream.php

@@ -1,6 +1,6 @@
 <?php declare(strict_types=1);
 
-namespace Toolkit\Stdlib\Util;
+namespace Toolkit\Stdlib\Std;
 
 /**
  * class BaseStream

src/Std/StrStream.php

@@ -0,0 +1,146 @@
+<?php declare(strict_types=1);
+
+namespace Toolkit\Stdlib\Std;
+
+use Throwable;
+
+/**
+ * class StrStream - String value wrapper
+ */
+class StrStream
+{
+    /**
+     * @var string
+     */
+    protected $str = '';
+
+    /**
+     * @param string $str
+     *
+     * @return static
+     */
+    public static function new(string $str): self
+    {
+        return new self($str);
+    }
+
+    /**
+     * Class constructor.
+     *
+     * @param string $str
+     */
+    public function __construct(string $str)
+    {
+        $this->str = $str;
+    }
+
+    /**
+     * @param string $str
+     *
+     * @return $this
+     */
+    public function set(string $str): self
+    {
+        $this->str = $str;
+        return $this;
+    }
+
+    /**
+     * @param callable(string): string $fn
+     *
+     * @return $this
+     */
+    public function apply(callable $fn): self
+    {
+        return self::new($fn($this->str));
+    }
+
+    /**
+     * @param callable(string): bool $fn
+     *
+     * @return bool
+     */
+    public function is(callable $fn): bool
+    {
+        return (bool)$fn($this->str);
+    }
+
+    /**
+     * @param callable(string): string $fn
+     *
+     * @return $this
+     */
+    public function applyIf(callable $fn, $ifExpr): self
+    {
+        if ($ifExpr) {
+            return self::new($fn($this->str));
+        }
+
+        return $this;
+    }
+
+    /**
+     * @param string $str
+     *
+     * @return string
+     */
+    public function getOrNew(string $str): string
+    {
+        return $this->isEmpty() ? $str : $this->str;
+    }
+
+    /**
+     * @param Throwable $e
+     *
+     * @return string
+     * @throws Throwable
+     */
+    public function getOrThrow(Throwable $e): string
+    {
+        if ($this->isEmpty()) {
+            throw $e;
+        }
+
+        return $this->str;
+    }
+
+    /**
+     * @return bool
+     */
+    public function isEmpty(): bool
+    {
+        return $this->str === '';
+    }
+
+    /**
+     * @return StrValue
+     */
+    public function getValue(): StrValue
+    {
+        return StrValue::new($this->str);
+    }
+
+    /**
+     * @return StrValue
+     */
+    public function toValue(): StrValue
+    {
+        return StrValue::new($this->str);
+    }
+
+    /**
+     * @return string
+     */
+    public function toString(): string
+    {
+        return $this->str;
+    }
+
+    /**
+     * @return string
+     */
+    public function __toString(): string
+    {
+        return $this->str;
+    }
+}