اشیاء عدد مختلط¶

type PyComplexObject¶

این زیرنوع از PyObject نمایانگر یک شیء عدد مختلط پایتون است.

Py_complex cval¶: The complex number value, using the C Py_complex representation.

منسوخ شده از نسخه‌ی 3.15, در نسخه‌ی 3.20 حذف خواهد شد: Use PyComplex_AsCComplex() and PyComplex_FromCComplex() to convert a Python complex number to/from the C Py_complex representation.

PyTypeObject PyComplex_Type¶: قسمتی از ABI پایدار.
این نمونه از PyTypeObject نوع عدد مختلط پایتون را نشان می‌دهد. این همان شیء complex در لایه‌ی پایتون است.

int PyComplex_Check(PyObject *p)¶: اگر آرگومان آن یک PyComplexObject یا زیرنوعی از PyComplexObject باشد، مقدار درست را برمی‌گرداند. این تابع همیشه موفق می‌شود.

int PyComplex_CheckExact(PyObject *p)¶: در صورتی که آرگومان آن یک PyComplexObject باشد، اما زیرنوعی از PyComplexObject نباشد، مقدار true را برمی‌گرداند. این تابع همیشه موفق می‌شود.

PyObject *PyComplex_FromDoubles(double real, double imag)¶: مقدار بازگشتی: مرجع جدید. قسمتی از ABI پایدار.
یک شیء جدید PyComplexObject از real و imag برمی‌گرداند. در صورت خطا، NULL به همراه یک استثنای تنظیم‌شده برمی‌گرداند.

double PyComplex_RealAsDouble(PyObject *op)¶

قسمتی از ABI پایدار.

بخش حقیقی op را به‌صورت یک double در C برمی‌گرداند.

اگر op یک شیء عدد مختلط پایتون نباشد اما متد __complex__() را داشته باشد، این متد ابتدا برای تبدیل op به یک شیء عدد مختلط پایتون فراخوانی می‌شود. اگر __complex__() تعریف نشده باشد، به فراخوانی PyFloat_AsDouble() بازمی‌گردد و نتیجه‌ی آن را برمی‌گرداند.

در صورت شکست، این متد -1.0 را همراه با یک استثنای تنظیم‌شده برمی‌گرداند، بنابراین برای بررسی خطاها باید PyErr_Occurred() را فراخوانی کنید.

تغییر یافته در نسخه‌ی 3.13: در صورت وجود، از __complex__() استفاده کنید.

double PyComplex_ImagAsDouble(PyObject *op)¶

قسمتی از ABI پایدار.

بخش موهومی op را به‌صورت یک double در C برمی‌گرداند.

اگر op یک شیء عدد مختلط پایتون نباشد اما متد __complex__() را داشته باشد، این متد ابتدا برای تبدیل op به یک شیء عدد مختلط پایتون فراخوانی می‌شود. اگر __complex__() تعریف نشده باشد، به فراخوانی PyFloat_AsDouble() روی می‌آورد و در صورت موفقیت مقدار 0.0 را برمی‌گرداند.

در صورت شکست، این متد -1.0 را همراه با یک استثنای تنظیم‌شده برمی‌گرداند، بنابراین برای بررسی خطاها باید PyErr_Occurred() را فراخوانی کنید.

تغییر یافته در نسخه‌ی 3.13: در صورت وجود، از __complex__() استفاده کنید.

type Py_complex¶

This C structure defines an export format for a Python complex number object.

double real¶
double imag¶

ساختار به صورت زیر تعریف می‌شود:

typedef struct {
    double real;
    double imag;
} Py_complex;

PyObject *PyComplex_FromCComplex(Py_complex v)¶: مقدار بازگشتی: مرجع جدید.
یک شیء عدد مختلط جدید پایتون را از یک مقدار Py_complex در C ایجاد می‌کند. در صورت خطا، NULL به همراه یک استثنای تنظیم‌شده برگردانده می‌شود.

Py_complex PyComplex_AsCComplex(PyObject *op)¶

مقدار Py_complex عدد مختلط op را برمی‌گرداند.

اگر op یک شیء عدد مختلط پایتون نباشد اما متد __complex__() را داشته باشد، این متد ابتدا فراخوانی می‌شود تا op را به یک شیء عدد مختلط پایتون تبدیل کند. اگر __complex__() تعریف‌نشده باشد، به جای آن از __float__() استفاده می‌شود. اگر __float__() تعریف‌نشده باشد، به جای آن از __index__() استفاده می‌شود.

در صورت شکست، این متد یک Py_complex برمی‌گرداند که real آن روی -1.0 تنظیم شده و یک استثنا نیز تنظیم شده است؛ بنابراین برای بررسی خطاها باید PyErr_Occurred() را فراخوانی کرد.

تغییر یافته در نسخه‌ی 3.8: در صورت وجود، از __index__() استفاده کنید.

اعداد مختلط به‌عنوان ساختارهای C¶

The API also provides functions for working with complex numbers, using the Py_complex representation. Note that the functions which accept these structures as parameters and return them as results do so by value rather than dereferencing them through pointers.

Please note, that these functions are soft deprecated since Python 3.15. Avoid using this API in a new code to do complex arithmetic: either use the Number Protocol API or use native complex types, like double complex.

Py_complex _Py_c_sum(Py_complex left, Py_complex right)¶: مجموع دو عدد مختلط را با استفاده از نمایش C Py_complex برمی‌گرداند.

منسوخ شده از نسخه‌ی 3.15.

Py_complex _Py_c_diff(Py_complex left, Py_complex right)¶: تفاضل دو عدد مختلط را با استفاده از نمایش C Py_complex برمی‌گرداند.

منسوخ شده از نسخه‌ی 3.15.

Py_complex _Py_c_neg(Py_complex num)¶: نقیض عدد مختلط num را با استفاده از نمایش C Py_complex برمی‌گرداند.

منسوخ شده از نسخه‌ی 3.15.

Py_complex _Py_c_prod(Py_complex left, Py_complex right)¶: حاصل‌ضرب دو عدد مختلط را با استفاده از نمایش Py_complex در C برمی‌گرداند.

منسوخ شده از نسخه‌ی 3.15.

Py_complex _Py_c_quot(Py_complex dividend, Py_complex divisor)¶

خارج قسمت دو عدد مختلط را با استفاده از نمایش Py_complex در C برمی‌گرداند.

اگر divisor تهی باشد، این متد صفر را برمی‌گرداند و errno را برابر EDOM قرار می‌دهد.

منسوخ شده از نسخه‌ی 3.15.

Py_complex _Py_c_pow(Py_complex num, Py_complex exp)¶

توان num به exp را با استفاده از نمایش C Py_complex برمی‌گرداند.

اگر num صفر باشد و exp عدد حقیقی مثبت نباشد، این متد صفر را برمی‌گرداند و مقدار errno را برابر EDOM قرار می‌دهد.

در صورت سرریز، errno را برابر ERANGE قرار می‌دهد.

منسوخ شده از نسخه‌ی 3.15.

double _Py_c_abs(Py_complex num)¶

Return the absolute value of the complex number num.

در صورت سرریز، errno را برابر ERANGE قرار می‌دهد.

منسوخ شده از نسخه‌ی 3.15.

تغییر یافته در نسخه‌ی 3.16.0a0 (unreleased): This function leaves errno unchanged on success.

اشیاء عدد مختلط¶

اعداد مختلط به‌عنوان ساختارهای C¶

فهرست مطالب

موضوع قبلی

موضوع بعدی

این صفحه