Debian Codegraph @

vendor/ramsey/uuid/src/BinaryUtils.php

raw
1 <?php
2
3 /**
4 * This file is part of the ramsey/uuid library
5 *
6 * For the full copyright and license information, please view the LICENSE
7 * file that was distributed with this source code.
8 *
9 * @copyright Copyright (c) Ben Ramsey <[email protected]>
10 * @license http://opensource.org/licenses/MIT MIT
11 */
12
13 declare(strict_types=1);
14
15 namespace Ramsey\Uuid;
16
17 /**
18 * Provides binary math utilities
19 */
20 class BinaryUtils
21 {
22 /**
23 * Applies the variant field to the 16-bit clock sequence
24 *
25 * @link https://www.rfc-editor.org/rfc/rfc9562#section-4.1 RFC 9562, 4.1. Variant Field
26 *
27 * @param int $clockSeq The 16-bit clock sequence value before the variant is applied
28 *
29 * @return int The 16-bit clock sequence multiplexed with the UUID variant
30 *
31 * @pure
32 */
33 public static function applyVariant(int $clockSeq): int
34 {
35 return ($clockSeq & 0x3fff) | 0x8000;
36 }
37
38 /**
39 * Applies the version field to the 16-bit `time_hi_and_version` field
40 *
41 * @link https://www.rfc-editor.org/rfc/rfc9562#section-4.2 RFC 9562, 4.2. Version Field
42 *
43 * @param int $timeHi The value of the 16-bit `time_hi_and_version` field before the version is applied
44 * @param int $version The version to apply to the `time_hi` field
45 *
46 * @return int The 16-bit time_hi field of the timestamp multiplexed with the UUID version number
47 *
48 * @pure
49 */
50 public static function applyVersion(int $timeHi, int $version): int
51 {
52 return ($timeHi & 0x0fff) | ($version << 12);
53 }
54 }