From: Tim Düsterhus <duesterhus@woltlab.com>
Date: Fri, 4 Jun 2021 11:40:00 +0000 (+0200)
Subject: Add `IpAddress::toBulletMasked()`
X-Git-Tag: 5.4.0_Beta_2~30^2~1
X-Git-Url: https://git.stricted.de/?a=commitdiff_plain;h=bd91d8ece71e66a4a6911723b97e2956d8077016;p=GitHub%2FWoltLab%2FWCF.git

Add `IpAddress::toBulletMasked()`
---

diff --git a/wcfsetup/install/files/lib/util/IpAddress.class.php b/wcfsetup/install/files/lib/util/IpAddress.class.php
index 574fbafce5..d96dc4c557 100644
--- a/wcfsetup/install/files/lib/util/IpAddress.class.php
+++ b/wcfsetup/install/files/lib/util/IpAddress.class.php
@@ -108,6 +108,47 @@ final class IpAddress
         return new self(\inet_ntop(\inet_pton((string)$ipAddress) & $mask));
     }
 
+    /**
+     * Returns a masked IP address with the masked parts replaced by bullets.
+     *
+     * @see IpAddress::toMasked()
+     */
+    public function toBulletMasked(int $mask4, int $mask6): string
+    {
+        $masked = $this->toMasked($mask4, $mask6);
+
+        if (($mask4 % 8) !== 0) {
+            throw new \InvalidArgumentException('Given $mask4 is not a multiple of 8.');
+        }
+        if (($mask6 % 4) !== 0) {
+            throw new \InvalidArgumentException('Given $mask6 is not a multiple of 4.');
+        }
+
+        if ($masked->asV4()) {
+            $maskedBlocks = (32 - $mask4) / 8;
+            $replacement = \str_repeat(".\u{2022}\u{2022}\u{2022}", $maskedBlocks);
+
+            return \preg_replace(
+                '/(\.0){' . ($maskedBlocks) . '}$/',
+                $replacement,
+                (string)$masked
+            );
+        } else {
+            $maskedDigits = (128 - $mask6) / 4;
+
+            // Partially masked quadruplet.
+            $replacement = \str_repeat("\u{2022}", ($maskedDigits % 4));
+            // Fully masked quadruplets.
+            $replacement .= \str_repeat(":\u{2022}\u{2022}\u{2022}\u{2022}", ($maskedDigits / 4));
+
+            return \preg_replace(
+                '/.{' . ($maskedDigits % 4) . '}::$/',
+                $replacement,
+                (string)$masked
+            );
+        }
+    }
+
     /**
      * @see IpAddress::getIpAddress()
      */