#[AllowDynamicProperties]
class Scalar implements \JsonSerializable, \ArrayAccess
{
/**
* Register the value of the string.
*
* @param string|int $value
*/
public function __construct($value)
{
$this->string = (string) $value;
$this->int = (int) $value;
$this->value = is_numeric($value) ? (int) $value : $value;
}
/**
* Cast as string
*
* @return string
*/
public function __toString()
{
return $this->string;
}
/**
* When debugging, only output the string value
*
* @return void
*/
public function jsonSerialize(): mixed
{
return $this->string;
}
/**
* Dump the result of a model with all its fields loaded
*
* @return void
*/
public function json()
{
\Syltaen\Log::json($this);
}
// =============================================================================
// > ARRAY ACCESS / INTERFACES
// =============================================================================
/** Impementation of ArrayAccess::offsetExists */
public function offsetExists(mixed $offset): bool
{
return isset($this->string[$offset]);
}
/** Impementation of ArrayAccess::offsetGet */
public function offsetGet(mixed $offset): mixed
{
return $this->string[$offset];
}
/** Impementation of ArrayAccess::offsetSet */
public function offsetSet(mixed $offset, mixed $value): void
{
// $this->string[$offset] = $value;
}
/** Impementation of ArrayAccess::offsetUnset */
public function offsetUnset(mixed $offset): void
{
// unset($this->string[$offset]);
}
// =============================================================================
// > DYNAMIC PROPERTIES
// =============================================================================
/**
* Get a dynamic properties
*
* @return string
*/
public function __get($property)
{
return $this->{$property}();
}
/**
* Get lines of the string
*
* @param string $linebreak
* @return Set
*/
public function lines()
{
return $this->lines ??= $this->split("\n");
}
/**
* Get a grid from this string
*
* @return void
*/
public function grid() {
return new Grid($this);
}
/**
* The string length
*
* @return int
*/
public function length()
{
return $this->length ??= strlen($this->string);
}
/**
* Find the number of occurences of a substring
*
* @param string $sub
* @return int
*/
public function subCount($sub)
{
return substr_count($this->string, $sub);
}
/**
* Set of all the characters of the string
*
* @return Set
*/
public function chars()
{
return $this->chars ??= set(str_split($this->string));
}
// =============================================================================
// > TOOLS
// =============================================================================
/**
* Split the text with a delimiter
*
* @param string $delimiter
* @return Set
*/
public function split($delimiter)
{
return set(explode($delimiter, $this->string))->instanciate(self::class);
}
/**
* Substring
*
* @return Input
*/
public function sub($start, $end = null)
{
return new self(substr($this->string, $start, $end));
}
/**
* Extract all numbers found in the string
*
* @return Set
*/
public function numbers()
{
preg_match_all("/\-?\d+/", $this->string, $matches);
return set($matches[0])->ints();
}
/**
* Trim the text
*
* @param string $chars
* @return Input
*/
public function trim($chars = null)
{
return new self(is_null($chars) ? trim($this->string) : trim($this->string, $chars));
}
/**
* Append a text to the current one
*
* @param string $string
* @return self
*/
public function append($string)
{
return new self($this->string . $string);
}
/**
* Prepend a text to the current one
*
* @param string $string
* @return self
*/
public function prepend($string)
{
return new self($string . $this->string);
}
/**
* Get the range provided by the text
*
* @param string $delimiter
* @return Set
*/
public function range($delimiter = "-")
{
$range = $this->split($delimiter);
return set(range($range[0]->value, $range[1]->value));
}
/**
* Create chunk of text of a given size
*
* @param int $size
* @return Set
*/
public function chunk($size)
{
return set(str_split($this->string, $size))->instanciate(self::class);
}
/**
* String replacement
*
* @param string $from
* @param string $to
* @return self
*/
public function replace($from, $to, $use_regex = false)
{
return new self(str_replace($from, $to, $this->string));
}
/**
* Repeat the string X times
*
* @param int $times
* @return self
*/
public function repeat($times)
{
return new self(str_repeat($this->string, $times));
}
/**
* String replacement with a regex
*
* @param string $from
* @param string $to
* @return self
*/
public function pregReplace($from, $to)
{
return new self(preg_replace($from, $to, $this->string));
}
/**
* Preg match on the string value
*
* @param string $pattern
* @param bool $capture Capture the offset of the match
* @return array
*/
public function match($pattern, $capture = false)
{
preg_match($pattern, $this->string, $match, $capture ? PREG_OFFSET_CAPTURE : null);
return $match;
}
/**
* Preg match all on the string value
*
* @param string $pattern
* @param bool $capture Capture the offset of the matches
* @return array
*/
public function matchAll($pattern, $capture = false)
{
preg_match_all($pattern, $this->string, $match, $capture ? PREG_OFFSET_CAPTURE : null);
return $match;
}
/**
* Eval the string
*
* @return mixed
*/
public function eval($before = "", $after = "")
{
return eval("return {$before}" . $this . "{$after};");
}
/**
* Return the index of the first occurence of a substring
*
* @param string $substring
* @return int|false
*/
public function search($substring, $offset = 0)
{
return strpos($this->string, $substring, $offset);
}
/**
* Return all the indexes of the given substring
*
* @param string $substring
* @return int|false
*/
public function searches($substring)
{
$searches = [];
$offset = -1;
while (($offset = $this->search($substring, $offset + 1)) !== false) {
$searches[] = $offset;
}
return $searches;
}
/**
* Get the Levenshtein distance between two strings
*
* @param string $string
* @return int
*/
public function levenshtein($string)
{
return levenshtein($this->string, $string);
}
// =============================================================================
// > STATIC TOOLS
// =============================================================================
/**
* Check if the value of a variable (possibly a text) is empty or not
*
* @param mixed $value
* @return boolean
*/
public static function isNotEmpty($var)
{
return !self::isEmpty($var);
}
/**
* Check if the value of a variable (possibly a text) is empty or not
*
* @param mixed $value
* @return boolean
*/
public static function isEmpty($var)
{
if ($var instanceof Scalar) {
return empty($var->value) || (string) $var == " ";
}
if ($var instanceof Set) {
return $var->empty();
}
return empty($var);
}
/**
* Convert a value into a integer
*
* @return int
*/
public static function int($var)
{
return (int) (string) $var;
}
}