aboutsummaryrefslogtreecommitdiffstats
path: root/vendor/ramsey/uuid/src/BinaryUtils.php
diff options
context:
space:
mode:
Diffstat (limited to 'vendor/ramsey/uuid/src/BinaryUtils.php')
-rw-r--r--vendor/ramsey/uuid/src/BinaryUtils.php54
1 files changed, 38 insertions, 16 deletions
diff --git a/vendor/ramsey/uuid/src/BinaryUtils.php b/vendor/ramsey/uuid/src/BinaryUtils.php
index 18ea467d9..fb8ba9adc 100644
--- a/vendor/ramsey/uuid/src/BinaryUtils.php
+++ b/vendor/ramsey/uuid/src/BinaryUtils.php
@@ -1,5 +1,17 @@
<?php
+/**
+ * This file is part of the ramsey/uuid library
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @copyright Copyright (c) Ben Ramsey <ben@benramsey.com>
+ * @license http://opensource.org/licenses/MIT MIT
+ */
+
+declare(strict_types=1);
+
namespace Ramsey\Uuid;
/**
@@ -8,32 +20,42 @@ namespace Ramsey\Uuid;
class BinaryUtils
{
/**
- * Applies the RFC 4122 variant field to the `clock_seq_hi_and_reserved` field
+ * Applies the RFC 4122 variant field to the 16-bit clock sequence
+ *
+ * @link http://tools.ietf.org/html/rfc4122#section-4.1.1 RFC 4122, § 4.1.1: Variant
*
- * @param $clockSeqHi
- * @return int The high field of the clock sequence multiplexed with the variant
- * @link http://tools.ietf.org/html/rfc4122#section-4.1.1
+ * @param int $clockSeq The 16-bit clock sequence value before the RFC 4122
+ * variant is applied
+ *
+ * @return int The 16-bit clock sequence multiplexed with the UUID variant
+ *
+ * @psalm-pure
*/
- public static function applyVariant($clockSeqHi)
+ public static function applyVariant(int $clockSeq): int
{
- // Set the variant to RFC 4122
- $clockSeqHi = $clockSeqHi & 0x3f;
- $clockSeqHi |= 0x80;
+ $clockSeq = $clockSeq & 0x3fff;
+ $clockSeq |= 0x8000;
- return $clockSeqHi;
+ return $clockSeq;
}
/**
- * Applies the RFC 4122 version number to the `time_hi_and_version` field
+ * Applies the RFC 4122 version number to the 16-bit `time_hi_and_version` field
+ *
+ * @link http://tools.ietf.org/html/rfc4122#section-4.1.3 RFC 4122, § 4.1.3: Version
+ *
+ * @param int $timeHi The value of the 16-bit `time_hi_and_version` field
+ * before the RFC 4122 version is applied
+ * @param int $version The RFC 4122 version to apply to the `time_hi` field
+ *
+ * @return int The 16-bit time_hi field of the timestamp multiplexed with
+ * the UUID version number
*
- * @param string $timeHi
- * @param integer $version
- * @return int The high field of the timestamp multiplexed with the version number
- * @link http://tools.ietf.org/html/rfc4122#section-4.1.3
+ * @psalm-pure
*/
- public static function applyVersion($timeHi, $version)
+ public static function applyVersion(int $timeHi, int $version): int
{
- $timeHi = hexdec($timeHi) & 0x0fff;
+ $timeHi = $timeHi & 0x0fff;
$timeHi |= $version << 12;
return $timeHi;