code.power

	/**
	 * Regex Search Value
	 *
	 * @var    string
	 * @since  3.2.0
	 */
	protected string $regexValue = '';

	/**
	 * Constructor
	 *
	 * @param Config|null    $config    The search config object.
	 *
	 * @since 3.2.0
	 */
	public function __construct(?Config $config = null)
	{
		parent::__construct($config);
		$this->compileRegex();
	}

	/**
	 * Search inside a string
	 *
	 * @param  string   $value   The string value
	 *
	 * @return  string|null    The marked string if found, else null
	 * @since   3.2.0
	 */
	public function string(string $value): ?string
	{
		// we count every line
		$this->lineCounter();

		if (empty($this->searchValue) || !$this->match($value))
		{
			return null;
		}

		$result = preg_replace(
			$this->regexValue,
			$this->start . '$1' . $this->end,
			$value
		);

		return is_string($result) ? trim($result) : null;
	}

	/**
	 * Replace found instances inside string value
	 *
	 * @param   string   $value  The string value to update
	 *
	 * @return  string   The updated string
	 * @since   3.2.0
	 */
	public function replace(string $value): string
	{
		if (empty($this->searchValue) || !$this->match($value))
		{
			return $value;
		}

		$result = preg_replace(
			$this->regexValue,
			(string) $this->replaceValue,
			$value
		);

		return is_string($result) ? $result : $value;
	}

	/**
	 * Check if search string exists in the value
	 *
	 * @param   string    $value  The string value
	 *
	 * @return  bool
	 * @since   3.0.9
	 */
	public function match(string $value): bool
	{
		return !empty($this->searchValue) && preg_match($this->regexValue, $value) === 1;
	}

	/**
	 * Compile regex pattern based on whole word and match case settings
	 *
	 * @return void
	 * @since  5.1.1
	 */
	protected function compileRegex(): void
	{
		if (empty($this->searchValue))
		{
			$this->regexValue = '//';
			return;
		}

		$quoted = preg_quote($this->searchValue, '/');

		$pattern = $this->wholeWord === 1
			? '\b' . $quoted . '\b'
			: $quoted;

		$flags = $this->matchCase === 1 ? 'm' : 'mi';

		$this->regexValue = "/($pattern)/$flags";
	}