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 +++++++++++++++++++++++++++++
 vendor/vlucas/phpdotenv/src/Util/Str.php   |  98 +++++++++++++++++++++++++
 2 files changed, 210 insertions(+)
 create mode 100644 vendor/vlucas/phpdotenv/src/Util/Regex.php
 create mode 100644 vendor/vlucas/phpdotenv/src/Util/Str.php

(limited to 'vendor/vlucas/phpdotenv/src/Util')

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);
+    }
+}
diff --git a/vendor/vlucas/phpdotenv/src/Util/Str.php b/vendor/vlucas/phpdotenv/src/Util/Str.php
new file mode 100644
index 0000000..15257bd
--- /dev/null
+++ b/vendor/vlucas/phpdotenv/src/Util/Str.php
@@ -0,0 +1,98 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Dotenv\Util;
+
+use GrahamCampbell\ResultType\Error;
+use GrahamCampbell\ResultType\Success;
+use PhpOption\Option;
+
+/**
+ * @internal
+ */
+final class Str
+{
+    /**
+     * This class is a singleton.
+     *
+     * @codeCoverageIgnore
+     *
+     * @return void
+     */
+    private function __construct()
+    {
+        //
+    }
+
+    /**
+     * Convert a string to UTF-8 from the given encoding.
+     *
+     * @param string      $input
+     * @param string|null $encoding
+     *
+     * @return \GrahamCampbell\ResultType\Result<string,string>
+     */
+    public static function utf8(string $input, ?string $encoding = null)
+    {
+        if ($encoding !== null && !\in_array($encoding, \mb_list_encodings(), true)) {
+            /** @var \GrahamCampbell\ResultType\Result<string,string> */
+            return Error::create(
+                \sprintf('Illegal character encoding [%s] specified.', $encoding)
+            );
+        }
+        $converted = $encoding === null ?
+            @\mb_convert_encoding($input, 'UTF-8') :
+            @\mb_convert_encoding($input, 'UTF-8', $encoding);
+        /**
+         * this is for support UTF-8 with BOM encoding
+         * @see https://en.wikipedia.org/wiki/Byte_order_mark
+         * @see https://github.com/vlucas/phpdotenv/issues/500
+         */
+        if (\substr($converted, 0, 3) == "\xEF\xBB\xBF") {
+            $converted = \substr($converted, 3);
+        }
+        /** @var \GrahamCampbell\ResultType\Result<string,string> */
+        return Success::create($converted);
+    }
+
+    /**
+     * Search for a given substring of the input.
+     *
+     * @param string $haystack
+     * @param string $needle
+     *
+     * @return \PhpOption\Option<int>
+     */
+    public static function pos(string $haystack, string $needle)
+    {
+        /** @var \PhpOption\Option<int> */
+        return Option::fromValue(\mb_strpos($haystack, $needle, 0, 'UTF-8'), false);
+    }
+
+    /**
+     * Grab the specified substring of the input.
+     *
+     * @param string   $input
+     * @param int      $start
+     * @param int|null $length
+     *
+     * @return string
+     */
+    public static function substr(string $input, int $start, ?int $length = null)
+    {
+        return \mb_substr($input, $start, $length, 'UTF-8');
+    }
+
+    /**
+     * Compute the length of the given string.
+     *
+     * @param string $input
+     *
+     * @return int
+     */
+    public static function len(string $input)
+    {
+        return \mb_strlen($input, 'UTF-8');
+    }
+}
-- 
cgit v1.2.3