الفرق بين المراجعتين لصفحة: «Python/complex»

مراجعة 19:00، 27 أبريل 2018

تتكوّن الأعداد المركبّة من جزأين حقيقي وتخيّلي وكلاهما من الأعداد العشرية ذات الفاصلة العائمة float. ولاستخراج هذين الجزئين من عدد تخيلي z، فيمكن استخدام الخاصيتين z.real و z.imag.

يستخدم الحرفان 'j' أو 'J' للتعبير عن الأعداد المركبة كما هو موضح في الأمثلة التالية:

>>>w = 3j  #عدد مركّب الجزء الحقيقي فيه يساوي 0
>>>x = 2+5J
>>>y = -3-9j
>>>z = 3.1 + 4.5J
>>>z.real
3.1
>>> z.imag
4.5

الدّالة `complex()`‎

تعيد الدّالة complex()‎ عددًا مُركّبًا (complex number) حسب العدد الحقيقي والعدد التّخيّلي المُعطيين، أو تُحوّل سلسلةً نصيّةً أو عددًا إلى عدد مركّب.

البنية العامة

complex([real[, imag]])

المعاملات

`real`

مُعامل اختياريّ يُمثّل العدد الحقيقيّ، يُمكن أن تكون قيمته أيّة قيمةٍ عدديّة (ما يشمل الأعداد المركّبة).

و يُمكن أن تكون قيمته سلسلةً نصيّة لتفسيرها إلى عدد مركّب. إن كانت قيمة هذا المُعامل سلسلةً نصيّة، فيجب استدعاء الدّالة دون مُعاملٍ ثانٍ.

`imag`

مُعامل اختياريّ يُمثّل العدد التخيّليّ، يُمكن أن تكون قيمته أيّة قيمةٍ عدديّة (ما يشمل الأعداد المركّبة). إن لم تُمرّر قيمة لهذا المُعامل، فقيمته الافتراضيّة هي صفر.

على النّقيض من المُعامل real، لا يُمكن لقيمة هذا المُعامل أن تكون سلسلةً نصيّة.

القيمة المعادة

عدد مركّب.

تعيد الدالة القيمة 0j في حال عدم وجود أية معاملات.

الاستثناءات

يجب أن لا تحتوي السلاسل النصية على مسافات بيضاء بين العاملين + أو - عند التحويل باستخدام الدالة complex()‎، فمثلًا التعبير complex('1+2j')‎ يعد صحيحًا، أما التعبير complex('1 + 2j')‎ فيطلق الخطأ ValueError. انظر الأمثلة أدناه.

أمثلة

المثال التّالي يوضّح كيفيّة عمل هذه الدّالة:

>>> complex() # استدعاء الدّالة دون مُعاملات
0j
>>> complex(1, 4) # استدعاء الدّالة بكلا المُعاملين
(1+4j)
>>> complex('3+5j') # استدعاء الدّالة بتمرير سلسلة نصيّة إلى المُعامل الأول
(3+5j)
>>> complex('3+ 5j') # خطأ، انظر الاستثناءات
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: complex() arg is a malformed string

ملاحظات

يُمكن استعمال الدّالة complex()‎ لتحويل الأعداد إلى أعداد مركّبة كما تُستعمل الدّوال int()‎ و float()‎.

انظر أيضًا

مصادر

صفحتا Built-in Typesو Built-in Functions في توثيق بايثون الرسمي.

@@ سطر 14: / سطر 14: @@
 == الدّالة  <code>complex()</code>‎ ==
-تعيد الدّالة <code>complex()‎</code> عددًا مُركّبًا (complex number) حسب العدد الحقيقي والعدد الخياليّ المُعطيين، أو تُحوّل سلسلةً نصيّةً أو عددًا إلى عدد مركّب.
+تعيد الدّالة <code>complex()‎</code> عددًا مُركّبًا (complex number) حسب العدد الحقيقي والعدد التّخيّلي المُعطيين، أو تُحوّل سلسلةً نصيّةً أو عددًا إلى عدد مركّب.
 == البنية العامة ==
@@ سطر 27: / سطر 27: @@
 و يُمكن أن تكون  قيمته سلسلةً نصيّة لتفسيرها إلى عدد مركّب. إن كانت قيمة هذا المُعامل  سلسلةً نصيّة، فيجب استدعاء الدّالة دون مُعاملٍ ثانٍ.
 === <code>imag</code> ===
-مُعامل اختياريّ يُمثّل العدد الخياليّ، يُمكن أن تكون قيمته أيّة قيمةٍ عدديّة (ما يشمل الأعداد المركّبة). إن لم تُمرّر قيمة لهذا المُعامل، فقيمته الافتراضيّة هي صفر.
+مُعامل اختياريّ يُمثّل العدد التخيّليّ، يُمكن أن تكون قيمته أيّة قيمةٍ عدديّة (ما يشمل الأعداد المركّبة). إن لم تُمرّر قيمة لهذا المُعامل، فقيمته الافتراضيّة هي صفر.
-على عكس المُعامل <code>real</code>، لا يُمكن لقيمة هذا المُعامل أن تكون سلسلةً نصيّة.
+على النّقيض من المُعامل <code>real</code>، لا يُمكن لقيمة هذا المُعامل أن تكون سلسلةً نصيّة.
 == القيمة المعادة ==
 عدد مركّب.
 تعيد الدالة القيمة <code>0j</code> في حال عدم وجود أية معاملات.
@@ سطر 53: / سطر 55: @@
 == ملاحظات ==
-* يُمكن استعمال الدّالة <code>complex()‎</code> لتحويل الأعداد إلى أعداد مركّبة كما تُستعمل الدّوال <code>int()‎</code> و <code>float()‎</code>.
+* يُمكن استعمال الدّالة <code>complex()‎</code> لتحويل الأعداد إلى أعداد مركّبة كما تُستعمل الدّوال <code>[[Python/int|int()‎]]</code> و <code>[[Python/float|float()‎]]</code>.
 == انظر أيضًا ==
-* [[Python/float|الأعداد العشرية (ذات الفاصلة العائمة) float في بايثون]]
+* [[Python/float|الأعداد العشرية (ذات الفاصلة العائمة) float في بايثون]].
 * [[Python/int|الأعداد الصحيحة في بايثون]].