وظائف Dec2Hex و Hex2Dec

ينطبق على: تطبيقات Dataverse اللوحة قليل التعليمات البرمجية المكونات الإضافية تدفقات سطح المكتب التطبيقات Power Pages Power Platform المستندة إلى النموذج CLI

التحويل بين سلاسل النص الست عشري و الأرقام.

الوصف

استخدم Dec2Hex دالة لتحويل رقم إلى سلسلة نصية سداسية عشرية. يصدر Dec2Hex الأحرف 0 من خلال 9 والأحرف A الكبيرة من خلال F ؛ استخدم الوظيفة Lower لتحويل النتيجة إلى أحرف صغيرة إذا رغبت في ذلك. يقوم Dec2Hex باقتطاع رقم الإدخال إلى رقم صحيح كما لو تم تطبيق الدالة Trunc أولا. استخدم الأماكن وسادات بعدد موجب من الأصفار 0البادية (الأصفار) وحد طول الإخراج؛ يتم تجاهل الأماكن إذا كان الإدخال سالب.

استخدم Hex2Dec وظيفة لتحويل سلسلة نصية تحتوي على أرقام ست عشرية (0 خلال 9 و A خلال F) إلى رقم. يتم قبول أحرف الحالة العليا والسفلى. لا يمكن تمرير أكثر من 10 أحرف عشرية إلى Hex2Dec.

يعمل كلا هذين المعملين مع 40 بت، نوعان من المكمل، وعدد كامل. نطاق القيم المقبولة لكلا الوظائف هو 8000000000 عشري أو عشري -549755813888 إلى 7FFFFFFF عشري أو رقم عشري 549755813887.

إذا قمت بتمرير رقم واحد أو سلسلة نصية واحدة إلى هذه الوظائف، فستكون القيمة المرجعة نتيجة واحدة. إذا قمت بتمرير عمود واحد جدول القيمة المرجعة عبارة عن جدول نتائج ذو عمود واحد، ونتيجة واحدة لكل سجل في جدول الوسيطة. إذا كان لديك جدول متعدد الأعمدة، يمكنك تشكيله في جدول من عمود واحد، مثلما يصف التعامل مع الجداول.

إذا كانت قيمة الإدخال خارج النطاق أو كانت تتضمن أحرفا عشرية غير صالحة، يتم إرجاع خطأ Errorخطاء رقمية. إذا كان الإدخال جدول عمود مفرد، يكون الخطأ مضمنا في جدول الإخراج.

بناء الجملة

Dec2Hex ( عدد أماكن])

  • الرقم - مطلوب. الرقم الذي يتم تحويله إلى عشري.
  • الأماكن - اختياري. عدد الأحرف التي يجب استخدامها إذا كان الرقم موجبا. إذا تم حذف الأماكن، فإن Dec2Hex يستخدم الحد الأدنى من الأحرف الضرورية. إذا تم توفير هذه المعلمة، وكانت النتيجة غير مناسبة للمساحة المتوفرة، يتم إرجاع خطأ Error Parameter.رقمي . يتم تجاهل الأماكن إذا كان الرقم المراد تحويله سالبا.

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 مع وسيطة الأماكن

الصيغة نتيجة
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 مع جداول عمود مفردة وسيطة الأماكن

الصيغة نتيجة
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" ]