woocommerce-pos / vendor / ramsey / uuid / src / Converter / NumberConverterInterface.php

NumberConverterInterface.php in WCPOS – Point of Sale (POS) plugin for WooCommerce 1.10.21, at vendor/ramsey/uuid/src/Converter/NumberConverterInterface.php

58 lines 1.5 KB

Raw Download Zip

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\Converter;
16
17	/**
18	* A number converter converts UUIDs from hexadecimal characters into
19	* representations of integers and vice versa
20	*
21	* @psalm-immutable
22	*/
23	interface NumberConverterInterface
24	{
25	/**
26	* Converts a hexadecimal number into an string integer representation of
27	* the number
28	*
29	* The integer representation returned is a string representation of the
30	* integer, to accommodate unsigned integers greater than PHP_INT_MAX.
31	*
32	* @param string $hex The hexadecimal string representation to convert
33	*
34	* @return string String representation of an integer
35	*
36	* @psalm-return numeric-string
37	*
38	* @psalm-pure
39	*/
40	public function fromHex(string $hex): string;
41
42	/**
43	* Converts a string integer representation into a hexadecimal string
44	* representation of the number
45	*
46	* @param string $number A string integer representation to convert; this
47	* must be a numeric string to accommodate unsigned integers greater
48	* than PHP_INT_MAX.
49	*
50	* @return string Hexadecimal string
51	*
52	* @psalm-return non-empty-string
53	*
54	* @psalm-pure
55	*/
56	public function toHex(string $number): string;
57	}
58