# tablepress/3.4/libraries/vendor/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php

TablePress – Tables in WordPress made easy, version 3.4. 176 lines.

- Page: https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php
- Raw: https://pluginprobe.com/plugins/tablepress/3.4/raw/libraries/vendor/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php
- Modified: 2025-08-26T04:06:14+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/tablepress/3.4/code/libraries/vendor/PhpSpreadsheet/Calculation/Engineering/ConvertHex.php#L10-L20`.

```php
<?php

namespace TablePress\PhpOffice\PhpSpreadsheet\Calculation\Engineering;

use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Exception;
use TablePress\PhpOffice\PhpSpreadsheet\Calculation\Information\ExcelError;

class ConvertHex extends ConvertBase
{
	/**
	 * toBinary.
	 *
	 * Return a hex value as binary.
	 *
	 * Excel Function:
	 *        HEX2BIN(x[,places])
	 *
	 * @param array<mixed>|bool|float|string $value The hexadecimal number you want to convert.
	 *                      Number cannot contain more than 10 characters.
	 *                      The most significant bit of number is the sign bit (40th bit from the right).
	 *                      The remaining 9 bits are magnitude bits.
	 *                      Negative numbers are represented using two's-complement notation.
	 *                      If number is negative, HEX2BIN ignores places and returns a 10-character binary number.
	 *                      If number is negative, it cannot be less than FFFFFFFE00,
	 *                          and if number is positive, it cannot be greater than 1FF.
	 *                      If number is not a valid hexadecimal number, HEX2BIN returns the #NUM! error value.
	 *                      If HEX2BIN requires more than places characters, it returns the #NUM! error value.
	 *                      Or can be an array of values
	 * @param array<mixed>|int $places The number of characters to use. If places is omitted,
	 *                          HEX2BIN uses the minimum number of characters necessary. Places
	 *                          is useful for padding the return value with leading 0s (zeros).
	 *                      If places is not an integer, it is truncated.
	 *                      If places is nonnumeric, HEX2BIN returns the #VALUE! error value.
	 *                      If places is negative, HEX2BIN returns the #NUM! error value.
	 *                      Or can be an array of values
	 *
	 * @return array<mixed>|string Result, or an error
	 *         If an array of numbers is passed as an argument, then the returned result will also be an array
	 *            with the same dimensions
	 */
	public static function toBinary($value, $places = null)
	{
		if (is_array($value) || is_array($places)) {
			return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
		}

		try {
			$value = self::validateValue($value);
			$value = self::validateHex($value);
			$places = self::validatePlaces($places);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		$dec = self::toDecimal($value);

		return ConvertDecimal::toBinary($dec, $places);
	}

	/**
	 * toDecimal.
	 *
	 * Return a hex value as decimal.
	 *
	 * Excel Function:
	 *        HEX2DEC(x)
	 *
	 * @param array<mixed>|bool|float|int|string $value The hexadecimal number you want to convert. This number cannot
	 *                          contain more than 10 characters (40 bits). The most significant
	 *                          bit of number is the sign bit. The remaining 39 bits are magnitude
	 *                          bits. Negative numbers are represented using two's-complement
	 *                          notation.
	 *                      If number is not a valid hexadecimal number, HEX2DEC returns the
	 *                          #NUM! error value.
	 *                      Or can be an array of values
	 *
	 * @return array<mixed>|float|int|string Result, or an error
	 *         If an array of numbers is passed as an argument, then the returned result will also be an array
	 *            with the same dimensions
	 */
	public static function toDecimal($value)
	{
		if (is_array($value)) {
			return self::evaluateSingleArgumentArray([self::class, __FUNCTION__], $value);
		}

		try {
			$value = self::validateValue($value);
			$value = self::validateHex($value);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		if (strlen($value) > 10) {
			return ExcelError::NAN();
		}

		$binX = '';
		foreach (mb_str_split($value, 1, 'UTF-8') as $char) {
			$binX .= str_pad(base_convert($char, 16, 2), 4, '0', STR_PAD_LEFT);
		}
		if (strlen($binX) == 40 && $binX[0] == '1') {
			for ($i = 0; $i < 40; ++$i) {
				$binX[$i] = ($binX[$i] == '1' ? '0' : '1');
			}

			return (bindec($binX) + 1) * -1;
		}

		return bindec($binX);
	}

	/**
	 * toOctal.
	 *
	 * Return a hex value as octal.
	 *
	 * Excel Function:
	 *        HEX2OCT(x[,places])
	 *
	 * @param array<mixed>|bool|float|int|string $value The hexadecimal number you want to convert. Number cannot
	 *                                    contain more than 10 characters. The most significant bit of
	 *                                    number is the sign bit. The remaining 39 bits are magnitude
	 *                                    bits. Negative numbers are represented using two's-complement
	 *                                    notation.
	 *                                    If number is negative, HEX2OCT ignores places and returns a
	 *                                    10-character octal number.
	 *                                    If number is negative, it cannot be less than FFE0000000, and
	 *                                    if number is positive, it cannot be greater than 1FFFFFFF.
	 *                                    If number is not a valid hexadecimal number, HEX2OCT returns
	 *                                    the #NUM! error value.
	 *                                    If HEX2OCT requires more than places characters, it returns
	 *                                    the #NUM! error value.
	 *                      Or can be an array of values
	 * @param array<mixed>|int $places The number of characters to use. If places is omitted, HEX2OCT
	 *                                    uses the minimum number of characters necessary. Places is
	 *                                    useful for padding the return value with leading 0s (zeros).
	 *                                    If places is not an integer, it is truncated.
	 *                                    If places is nonnumeric, HEX2OCT returns the #VALUE! error
	 *                                    value.
	 *                                    If places is negative, HEX2OCT returns the #NUM! error value.
	 *                      Or can be an array of values
	 *
	 * @return array<mixed>|string Result, or an error
	 *         If an array of numbers is passed as an argument, then the returned result will also be an array
	 *            with the same dimensions
	 */
	public static function toOctal($value, $places = null)
	{
		if (is_array($value) || is_array($places)) {
			return self::evaluateArrayArguments([self::class, __FUNCTION__], $value, $places);
		}

		try {
			$value = self::validateValue($value);
			$value = self::validateHex($value);
			$places = self::validatePlaces($places);
		} catch (Exception $e) {
			return $e->getMessage();
		}

		$decimal = self::toDecimal($value);

		return ConvertDecimal::toOctal($decimal, $places);
	}

	protected static function validateHex(string $value): string
	{
		if (strlen($value) > preg_match_all('/[0123456789ABCDEF]/', $value)) {
			throw new Exception(ExcelError::NAN());
		}

		return $value;
	}
}

```