عرض مصدر Python/float/fromhex

هذه الدالة هي تابع صنف (Class method) يعيد العدد العشري الذي يمكن تمثيله باستخدام السلسلة النصية التي تتضمن الصيغة الست عشرية.

== البنية العامة ==
<syntaxhighlight lang="python3">
x.fromhex()
</syntaxhighlight>

== المعاملات ==

=== <code>s</code> ===
وهو عبارة عن [[Python/str|سلسلة نصية]] تتضمن القيمة الست عشرية المراد تمثيلها بصيغة العدد العشري، وتأخذ القيمة الست عشرية الصيغة التالية:<syntaxhighlight lang="python3">
[sign] ['0x'] integer ['.' fraction] ['p' exponent]
</syntaxhighlight>الإشارة <code>sign</code> هنا اختيارية وتأخذ القيمتين <code>+</code> أو <code>-</code>، أما العدد الصحيح <code>integer</code> والكسر <code>fraction</code> فهما [[Python/str|سلسلتان نصيتان]] تضمّان أعدادًا بالصيغة الست عشرية، والأس هو عدد عشري يمكن أن يكون مسبوقًا بإشارة اختيارية.

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

هذه الصيغة مشابهة للصيغة المحددة في القسم 6.4.4.2 من المعيار C99، وللصيغة المستخدمة في الإصدار 1.5 وما بعده من لغة جافا. ويمكن استخدام مخرجات <code>[[Python/float/hex|float.hex()]]‎</code> بصورة خاصّة كعدد ست عشري ذي فاصلة عائمة في الشيفرات المكتوبة بلغتي C أو جافا، ويمكن كذلك لدالة <code>float.fromhex()</code>‎ استخدام السلاسل النصّية التي ينتجها محرّف التنسيق ‎%a في لغة C أو الدالة <code>Double.toHexString</code> في لغة جافا.

تجدر الإشارة إلى أنّ الأسّ يُكتب بالنظام العشري decimal وليس بالنظام الست عشري، وأنّ إجراء عملية الضرب على المعامل تجري بالرفع إلى الأسّ <code>2</code>.

== أمثلة ==
تمثّل السلسلة الست عشرية <code>0x3.a7p10</code> العدد العشري <code>‎(3+ 10./16 + 7./16**2) * 2.0**10‎</code> أو <code>3740.0</code>:<syntaxhighlight lang="python3">
>>> float.fromhex('0x3.a7p10')
3740.0
</syntaxhighlight>ينتج عن التحويل العكسي للرقم <code>3740.0</code> إلى النظام الست عشري [[Python/str|سلسلة نصّية]] تتضمّن قيمة مختلفة تمثّل العدد نفسه:<syntaxhighlight lang="python3">
>>> float.hex(3740.0)
'0x1.d380000000000p+11'
</syntaxhighlight>

== انظر أيضًا ==
* [[Python/float|الأعداد العشرية في بايثون.]]

== مصادر ==
* [https://docs.python.org/3/library/stdtypes.html#float.fromhex قسم fromhex في صفحة Types في توثيق بايثون الرسمي.]
[[تصنيف:Python]]
[[تصنيف:Python Function]]
[[تصنيف:Python Built-in Functions]]