# dec2hex

Convert decimal integer to its hexadecimal representation for fi objects

Since R2021b

## Description

example

hexStr = dec2hex(D) returns the hexadecimal, or base-16, representation of the decimal integer D. The output argument hexStr is a character array where each row represents the hexadecimal digits of each decimal integer in D using the characters 0-9 and A-F. D must contain finite integers.

example

hexStr = dec2hex(D,minDigits) returns a hexadecimal representation with no fewer than minDigits digits.

Tip

dec2hex returns the hexadecimal representation of the real-world value of the fi object D. To obtain the hexadecimal representation of the stored integer value, use hex instead.

## Examples

collapse all

Convert the decimal number stored as a fi object to hexadecimal representation.

D1 = fi(2748);
D2 = fi(251);
hexStr1 = dec2hex(D1)
hexStr2 = dec2hex(D2)
hexStr1 =

'ABC'

hexStr2 =

'FB'

The dec2hex function converts negative numbers using their two's complement binary values.

D3 = fi(-5);
hexStr3 = dec2hex(D3)
hexStr3 =

'FB'

Convert the decimal number stored as a fi object to hexadecimal representation. Specify the minimum number of hexadecimal digits that dec2hex returns. If you specify more digits than are required, then dec2hex pads the output.

D = fi(2748);
hexStr = dec2hex(D,8)
hexStr =

'00000ABC'

If you specify fewer digits, then dec2hex still returns as many hexadecimal digits as required to represent the input number.

hexStr = dec2hex(D,2)
hexStr =

'ABC'

Create a numeric fi array.

D = fi([1023 122 14]);

To represent the elements of D as hexadecimal values, use the dec2hex function. Each row of hexStr corresponds to an element of D.

hexStr = dec2hex(D)
hexStr =

3×3 char array

'3FF'
'07A'
'00E'

Convert a numeric fi array containing negative values and specify minimum number of digits.

D = fi([1023 122 14;2748 251 -5]);
hexStr = dec2hex(D,5)
hexStr =

6×5 char array

'003FF'
'00ABC'
'0007A'
'000FB'
'0000E'
'FFFFB'

Convert the upper and lower bound of a signed fi object with 100-bit word length.

binStr = dec2hex([lowerbound(fi([],1,100,0)),...
upperbound(fi([],1,100,0))])
binStr =

2×25 char array

'8000000000000000000000000'
'7FFFFFFFFFFFFFFFFFFFFFFFF'

## Input Arguments

collapse all

Input array, specified as a numeric fi array.

• D must contain finite integers. If any element of D has a fractional part, then dec2hex produces an error. For example, dec2hex converts fi(10) to 'A', but does not convert fi(10.5).

• D can include negative numbers. The function converts negative numbers using their two's complement binary values.

Data Types: fi

Minimum number of digits in the output, specified as a positive integer.

• If D can be represented with fewer than minDigits hexadecimal digits, then dec2hex pads the output.

• If D is so large that it must be represented with more than minDigits digits, then dec2hex returns the output with as many digits as required.

## Version History

Introduced in R2021b