Функції Dec2Hex і Hex2Dec

Застосовується до: плагінів Dataverse Canvasз базовим кодуванням Desktop flows Модельно-керованих додатків Power Pages Power Platform CLI

Перетворення між шістнадцятковими текстовими рядками та числами.

Опис

Використовуйте функцію Dec2Hex для перетворення числа в шістнадцятковий текстовий рядок. Dec2Hex випромінює символи 0 через 9 і символи верхнього регістру A через F; використовуйте функцію Lower для перетворення результату в нижній регістр, якщо це потрібно. Dec2Hex обрізає вхідне число до цілого числа, ніби функція Trunc була застосована першою. Використовуйте «Місця» для заповнення додатного числа початковими 0s (нулями) та обмеження довжини виводу; Місця ігнорується, якщо вхідні дані від’ємні.

Використовуйте функцію Hex2Dec для перетворення текстового рядка, що містить шістнадцяткові цифри (0 через і наскрізь 9 A F), на число. Приймаються символи верхнього та нижнього регістру. У Hex2Dec можна передати не більше 10 шістнадцяткових символів.

Обидві ці функції працюють з 40-бітним, двійковим, цілим числом. Діапазон прийнятих значень для обох функцій є шістнадцятковим 8000000000 або десятковим -549755813888 до шістнадцяткового 7FFFFFFFF або десяткового 549755813887.

Якщо ви передасте цим функціям одне число або текстовий рядок, повернене значення буде єдиним результатом. Якщо ви передаєте таблицю з одним стовпцем , поверненим значенням є таблиця результатів з одним стовпцем, по одному результату для кожного запису в таблиці аргументу. Якщо ваша таблиця має кілька стовпців, ви можете переробити її на таблицю з одним стовпцем, як описано в розділі Робота з таблицями.

Якщо вхідне значення виходить за межі діапазону або містить неприпустимі шістнадцяткові символи, повертається помилка ErrorKind.Numeric . Якщо вхідними даними була таблиця з одним стовпцем, помилка вбудовується в таблицю виведення.

Синтаксис

Dec2Hex( Кількість [, Місць] )

• Кількість - обов’язковий. Число для перетворення в шістнадцяткове.
• Місця- необов’язкові . Кількість символів, які слід використовувати, якщо число додатне. Якщо параметр «Місця» пропущено, Dec2Hex використовує мінімальну необхідну кількість символів. Якщо цей параметр надано, а результат не вміщується у вказане місце, повертається помилка ErrorKind.Numeric . Місця ігноруються, якщо число для перетворення від’ємне.

Hex2Dec( Шістнадцятковий рядок )

• HexString - обов’язковий. Рядок шістнадцяткових цифр для перетворення в число.

Приклади

Основне використання Hex2Dec

Формула	Результат
Hex2Dec( "A5" )	165
Hex2Dec( "FFFFFFFF5B")	-165
Hex2Dec( "c8d" )	3213
Hex2Dec( "fffffff373" )	-3213
Hex2Dec( "ffffffffff" )	-1
Hex2Dec( "ffffffffffff" )	error (out of range)
Hex2Dec( "43j" )	error (invalid hexadecimal character)
Hex2Dec( [ "A", "12", "FFFF" ] )	[ 10, 18, 65535 ]
Hex2Dec( [ "3", "E", "I", "B" ] )	[ 3, 14, error (invalid hexadecimal character), 11 ]

Основне використання Dec2Hex

Формула	Результат
Dec2Hex( 165 )	"A5"
Dec2Hex( -165 )	"FFFFFFFF5B"
Dec2Hex( 3213 )	"c8d"
Dec2Hex( -3213 )	"FFFFFFF373"
Dec2Hex( -1 )	"FFFFFFFFFF"
Dec2Hex( 3.74 )	"3"
Dec2Hex( -3.74 )	"FFFFFFFFFD"
Dec2Hex( [ 10, 255, -16 ] )	[ "A", "FF", "FFFFFFFFF0" ]
Dec2Hex( 1e45 )	error (out of range)
Dec2Hex( [ 1, 1e-45, 1e45, 2 ] )	[ "1", "0", error (out of range), "2" ]

Основне використання Dec2Hex з аргументом Places

Формула	Результат
Dec2Hex( 45780 )	"B2D4"
Dec2Hex( 45780, 4 )	"B2D4"
Dec2Hex( 45780, 5 )	"0B2D4"
Dec2Hex( 45780, 6 )	"00B2D4"
Dec2Hex( 45780, 3 )	error (not enough space)
Dec2Hex( 45780, 11 )	error (out of range)
Dec2Hex( -45780 )	"FFFFFF4D2C"
Dec2Hex( -45780, 4 )	"FFFFFF4D2C"
Dec2Hex( -45780, 6 )	"FFFFFF4D2C"
Dec2Hex( -45780, 10 )	"FFFFFF4D2C"
Dec2Hex( -45780, 11 )	error (out of range)

Основне використання Dec2Hex з таблицями з однією колонкою та аргументом Places

Формула	Результат
Dec2Hex( [ 10, 255, -16 ], [ 1, 2, 3 ] )	[ "A", "FF", "FFFFFFFFF0" ]
Dec2Hex( [ 10, 255, -16 ], 4 )	[ "000A", "00FF", "FFFFFFFFF0" ]
Dec2Hex( 255, [0, 1, 2, 3] )	[ error (not enough space), error (not enough space), "FF", "0FF" ]