From 110dc2831488937c1afb70c11657a341912fc8cd Mon Sep 17 00:00:00 2001
From: Peter Nguyen <peteralistairnguyen@gmail.com>
Date: Wed, 5 Feb 2025 00:44:12 -0600
Subject: Initial commit 2/25/2025

---
 vendor/vlucas/phpdotenv/src/Util/Regex.php | 112 +++++++++++++++++++++++++++++
 1 file changed, 112 insertions(+)
 create mode 100644 vendor/vlucas/phpdotenv/src/Util/Regex.php

(limited to 'vendor/vlucas/phpdotenv/src/Util/Regex.php')

diff --git a/vendor/vlucas/phpdotenv/src/Util/Regex.php b/vendor/vlucas/phpdotenv/src/Util/Regex.php
new file mode 100644
index 0000000..b17355c
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Util/Regex.php
@@ -0,0 +1,112 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Util;
+
+use GrahamCampbell\ResultType\Error;
+use GrahamCampbell\ResultType\Success;
+
+/**
+ * @internal
+ */
+final class Regex
+{
+    /**
+     * This class is a singleton.
+     *
+     * @codeCoverageIgnore
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Perform a preg match, wrapping up the result.
+     *
+     * @param string $pattern
+     * @param string $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<bool,string>
+     */
+    public static function matches(string $pattern, string $subject)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern) {
+            return @\preg_match($pattern, $subject) === 1;
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg match all, wrapping up the result.
+     *
+     * @param string $pattern
+     * @param string $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<int,string>
+     */
+    public static function occurrences(string $pattern, string $subject)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern) {
+            return (int) @\preg_match_all($pattern, $subject);
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg replace callback, wrapping up the result.
+     *
+     * @param string   $pattern
+     * @param callable $callback
+     * @param string   $subject
+     * @param int|null $limit
+     *
+     * @return \GrahamCampbell\ResultType\Result<string,string>
+     */
+    public static function replaceCallback(string $pattern, callable $callback, string $subject, ?int $limit = null)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern, $callback, $limit) {
+            return (string) @\preg_replace_callback($pattern, $callback, $subject, $limit ?? -1);
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg split, wrapping up the result.
+     *
+     * @param string $pattern
+     * @param string $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<string[],string>
+     */
+    public static function split(string $pattern, string $subject)
+    {
+        return self::pregAndWrap(static function (string $subject) use ($pattern) {
+            /** @var string[] */
+            return (array) @\preg_split($pattern, $subject);
+        }, $subject);
+    }
+
+    /**
+     * Perform a preg operation, wrapping up the result.
+     *
+     * @template V
+     *
+     * @param callable(string):V $operation
+     * @param string             $subject
+     *
+     * @return \GrahamCampbell\ResultType\Result<V,string>
+     */
+    private static function pregAndWrap(callable $operation, string $subject)
+    {
+        $result = $operation($subject);
+
+        if (\preg_last_error() !== \PREG_NO_ERROR) {
+            /** @var \GrahamCampbell\ResultType\Result<V,string> */
+            return Error::create(\preg_last_error_msg());
+        }
+
+        /** @var \GrahamCampbell\ResultType\Result<V,string> */
+        return Success::create($result);
+    }
+}
-- 
cgit v1.2.3