Innmind / Immutable

     *

     * @return BooleanPrimitive

     */

    public function match($regex, $flags = 0, $offset = 0)

    {

        $value = preg_match((string) $regex, $this->value, null, $flags, $offset);

        if ($value === false) {

            throw new RegexException('', preg_last_error());

        }

        return new BooleanPrimitive((bool) $value);

    }

    /**

     * Return a collection of the elements matching the regex

     *

     * @return TypedCollection

     */

    public function getMatches($regex, $flags = 0, $offset = 0)

    {

        $matches = [];

        $value = preg_match(

            (string) $regex,

            $this->value,

            $matches,

            $flags,

            $offset

        );

        if ($value === false) {

            throw new RegexException('', preg_last_error());

        }

        return new TypedCollection(self::class, $matches);

    }

    /**

     * Replace part of the string by using a regular expression