python-docs-fa/c-api/complex.po at fix-code-syntaxerror-translation · faridfarahani/python-docs-fa · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
# arman mohebali <armanmohebali@outlook.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-10-01 14:41+0330\n"
"PO-Revision-Date: 2021-06-28 00:48+0000\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/)\n"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"

msgid "Complex Number Objects"
msgstr "اشیاء عدد مختلط"

msgid "This subtype of :c:type:`PyObject` represents a Python complex number object."
msgstr "این زیرنوع از :c:type:`PyObject` نمایانگر یک شیء عدد مختلط پایتون است."

msgid "The complex number value, using the C :c:type:`Py_complex` representation."
msgstr "مقدار عدد مختلط، با استفاده از نمایش :c:type:`Py_complex` در C."

msgid "Use :c:func:`PyComplex_AsCComplex` and :c:func:`PyComplex_FromCComplex` to convert a Python complex number to/from the C :c:type:`Py_complex` representation."
msgstr "برای تبدیل یک عدد مختلط پایتون به/از نمایش C در :c:type:`Py_complex`، از :c:func:`PyComplex_AsCComplex` و :c:func:`PyComplex_FromCComplex` استفاده کنید."

msgid "This instance of :c:type:`PyTypeObject` represents the Python complex number type. It is the same object as :class:`complex` in the Python layer."
msgstr "این نمونه از :c:type:`PyTypeObject` نوع عدد مختلط پایتون را نشان می‌دهد. این همان شیء :class:`complex` در لایه‌ی پایتون است."

msgid "Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :c:type:`PyComplexObject`.  This function always succeeds."
msgstr "اگر آرگومان آن یک :c:type:`PyComplexObject` یا زیرنوعی از :c:type:`PyComplexObject` باشد، مقدار درست را برمی‌گرداند. این تابع همیشه موفق می‌شود."

msgid "Return true if its argument is a :c:type:`PyComplexObject`, but not a subtype of :c:type:`PyComplexObject`.  This function always succeeds."
msgstr "در صورتی که آرگومان آن یک :c:type:`PyComplexObject` باشد، اما زیرنوعی از :c:type:`PyComplexObject` نباشد، مقدار true را برمی‌گرداند. این تابع همیشه موفق می‌شود."

msgid "Return a new :c:type:`PyComplexObject` object from *real* and *imag*. Return ``NULL`` with an exception set on error."
msgstr "یک شیء جدید :c:type:`PyComplexObject` از *real* و *imag* برمی‌گرداند. در صورت خطا، ``NULL`` به همراه یک استثنای تنظیم‌شده برمی‌گرداند."

msgid "Return the real part of *op* as a C :c:expr:`double`."
msgstr "بخش حقیقی *op* را به‌صورت یک :c:expr:`double` در C برمی‌گرداند."

msgid "If *op* is not a Python complex number object but has a :meth:`~object.__complex__` method, this method will first be called to convert *op* to a Python complex number object.  If :meth:`!__complex__` is not defined then it falls back to call :c:func:`PyFloat_AsDouble` and returns its result."
msgstr "اگر *op* یک شیء عدد مختلط پایتون نباشد اما متد :meth:`~object.__complex__` را داشته باشد، این متد ابتدا برای تبدیل *op* به یک شیء عدد مختلط پایتون فراخوانی می‌شود. اگر :meth:`!__complex__` تعریف نشده باشد، به فراخوانی :c:func:`PyFloat_AsDouble` بازمی‌گردد و نتیجه‌ی آن را برمی‌گرداند."

msgid "Upon failure, this method returns ``-1.0`` with an exception set, so one should call :c:func:`PyErr_Occurred` to check for errors."
msgstr "در صورت شکست، این متد ``-1.0`` را همراه با یک استثنای تنظیم‌شده برمی‌گرداند، بنابراین برای بررسی خطاها باید :c:func:`PyErr_Occurred` را فراخوانی کنید."

msgid "Use :meth:`~object.__complex__` if available."
msgstr "در صورت وجود، از :meth:`~object.__complex__` استفاده کنید."

msgid "Return the imaginary part of *op* as a C :c:expr:`double`."
msgstr "بخش موهومی *op* را به‌صورت یک :c:expr:`double` در C برمی‌گرداند."

msgid "If *op* is not a Python complex number object but has a :meth:`~object.__complex__` method, this method will first be called to convert *op* to a Python complex number object.  If :meth:`!__complex__` is not defined then it falls back to call :c:func:`PyFloat_AsDouble` and returns ``0.0`` on success."
msgstr "اگر *op* یک شیء عدد مختلط پایتون نباشد اما متد :meth:`~object.__complex__` را داشته باشد، این متد ابتدا برای تبدیل *op* به یک شیء عدد مختلط پایتون فراخوانی می‌شود. اگر :meth:`!__complex__` تعریف نشده باشد، به فراخوانی :c:func:`PyFloat_AsDouble` روی می‌آورد و در صورت موفقیت مقدار ``0.0`` را برمی‌گرداند."

msgid "This C structure defines an export format for a Python complex number object."
msgstr "این ساختار C یک قالب صادرات (export) برای یک شیء عدد مختلط پایتون تعریف می‌کند."

msgid "The structure is defined as::"
msgstr "ساختار به صورت زیر تعریف می‌شود::"

msgid ""
"typedef struct {\n"
"    double real;\n"
"    double imag;\n"
"} Py_complex;"
msgstr ""
"typedef struct {\n"
"    double real;\n"
"    double imag;\n"
"} Py_complex;"

msgid "Create a new Python complex number object from a C :c:type:`Py_complex` value. Return ``NULL`` with an exception set on error."
msgstr "یک شیء عدد مختلط جدید پایتون را از یک مقدار :c:type:`Py_complex` در C ایجاد می‌کند. در صورت خطا، ``NULL`` به همراه یک استثنای تنظیم‌شده برگردانده می‌شود."

msgid "Return the :c:type:`Py_complex` value of the complex number *op*."
msgstr "مقدار :c:type:`Py_complex` عدد مختلط *op* را برمی‌گرداند."

msgid "If *op* is not a Python complex number object but has a :meth:`~object.__complex__` method, this method will first be called to convert *op* to a Python complex number object.  If :meth:`!__complex__` is not defined then it falls back to :meth:`~object.__float__`.  If :meth:`!__float__` is not defined then it falls back to :meth:`~object.__index__`."
msgstr "اگر *op* یک شیء عدد مختلط پایتون نباشد اما متد :meth:`~object.__complex__` را داشته باشد، این متد ابتدا فراخوانی می‌شود تا *op* را به یک شیء عدد مختلط پایتون تبدیل کند. اگر :meth:`!__complex__` تعریف‌نشده باشد، به جای آن از :meth:`~object.__float__` استفاده می‌شود. اگر :meth:`!__float__` تعریف‌نشده باشد، به جای آن از :meth:`~object.__index__` استفاده می‌شود."

msgid "Upon failure, this method returns :c:type:`Py_complex` with :c:member:`~Py_complex.real` set to ``-1.0`` and with an exception set, so one should call :c:func:`PyErr_Occurred` to check for errors."
msgstr "در صورت شکست، این متد یک :c:type:`Py_complex` برمی‌گرداند که :c:member:`~Py_complex.real` آن روی ``-1.0`` تنظیم شده و یک استثنا نیز تنظیم شده است؛ بنابراین برای بررسی خطاها باید :c:func:`PyErr_Occurred` را فراخوانی کرد."

msgid "Use :meth:`~object.__index__` if available."
msgstr "در صورت وجود، از :meth:`~object.__index__` استفاده کنید."

msgid "Complex Numbers as C Structures"
msgstr "اعداد مختلط به‌عنوان ساختارهای C"

msgid "The API also provides functions for working with complex numbers, using the :c:type:`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."
msgstr "این رابط برنامه‌نویسی (API) همچنین توابعی را برای کار با اعداد مختلط، با استفاده از نمایش :c:type:`Py_complex` فراهم می‌کند. توجه داشته باشید توابعی که این ساختارها را به عنوان پارامتر می‌پذیرند و آن‌ها را به عنوان نتیجه برمی‌گردانند، این کار را *به صورت مقداری* (by value) انجام می‌دهند و نه با رفع ارجاع آن‌ها از طریق اشاره‌گرها."

msgid "Please note, that these functions are :term:`soft deprecated` since Python 3.15.  Avoid using this API in a new code to do complex arithmetic: either use the :ref:`Number Protocol <number>` API or use native complex types, like :c:expr:`double complex`."
msgstr "لطفاً توجه داشته باشید که این توابع از نسخه‌ی 3.15 پایتون :term:`مشمول هشدار منسوخ‌شدگی <soft deprecated>` هستند. از استفاده از این API در کدهای جدید برای انجام محاسبات مختلط خودداری کنید: یا از API :ref:`پروتکل اعداد <number>` استفاده کنید یا از انواع مختلط بومی مانند :c:expr:`double complex` بهره ببرید."

msgid "Return the sum of two complex numbers, using the C :c:type:`Py_complex` representation."
msgstr "مجموع دو عدد مختلط را با استفاده از نمایش C :c:type:`Py_complex` برمی‌گرداند."

msgid "Return the difference between two complex numbers, using the C :c:type:`Py_complex` representation."
msgstr "تفاضل دو عدد مختلط را با استفاده از نمایش C :c:type:`Py_complex` برمی‌گرداند."

msgid "Return the negation of the complex number *num*, using the C :c:type:`Py_complex` representation."
msgstr "نقیض عدد مختلط *num* را با استفاده از نمایش C :c:type:`Py_complex` برمی‌گرداند."

msgid "Return the product of two complex numbers, using the C :c:type:`Py_complex` representation."
msgstr "حاصل‌ضرب دو عدد مختلط را با استفاده از نمایش :c:type:`Py_complex` در C برمی‌گرداند."

msgid "Return the quotient of two complex numbers, using the C :c:type:`Py_complex` representation."
msgstr "خارج قسمت دو عدد مختلط را با استفاده از نمایش :c:type:`Py_complex` در C برمی‌گرداند."

msgid "If *divisor* is null, this method returns zero and sets :c:data:`errno` to :c:macro:`!EDOM`."
msgstr "اگر *divisor* تهی باشد، این متد صفر را برمی‌گرداند و :c:data:`errno` را برابر :c:macro:`!EDOM` قرار می‌دهد."

msgid "Return the exponentiation of *num* by *exp*, using the C :c:type:`Py_complex` representation."
msgstr "توان *num* به *exp* را با استفاده از نمایش C :c:type:`Py_complex` برمی‌گرداند."

msgid "If *num* is null and *exp* is not a positive real number, this method returns zero and sets :c:data:`errno` to :c:macro:`!EDOM`."
msgstr "اگر *num* صفر باشد و *exp* عدد حقیقی مثبت نباشد، این متد صفر را برمی‌گرداند و مقدار :c:data:`errno` را برابر :c:macro:`!EDOM` قرار می‌دهد."

msgid "Set :c:data:`errno` to :c:macro:`!ERANGE` on overflows."
msgstr "در صورت سرریز، :c:data:`errno` را برابر :c:macro:`!ERANGE` قرار می‌دهد."

msgid "Return the absolute value of the complex number *num*."
msgstr "مقدار مطلق عدد مختلط *num* را برمی‌گرداند."

msgid "object"
msgstr "شیء"

msgid "complex number"
msgstr "عدد مختلط"

#~ msgid "Python's complex number objects are implemented as two distinct types when viewed from the C API:  one is the Python object exposed to Python programs, and the other is a C structure which represents the actual complex number value. The API provides functions for working with both."
#~ msgstr "اشیاء عدد مختلط پایتون از دید API زبان C به‌صورت دو نوع متمایز پیاده‌سازی شده‌اند: یکی شیء پایتونی است که در اختیار برنامه‌های پایتون قرار می‌گیرد، و دیگری ساختاری در C است که مقدار واقعی عدد مختلط را نمایندگی می‌کند. این API توابعی برای کار با هر دو فراهم می‌کند."

#~ msgid "The C structure which corresponds to the value portion of a Python complex number object.  Most of the functions for dealing with complex number objects use structures of this type as input or output values, as appropriate."
#~ msgstr "ساختار C که به بخش مقدارِ شیء عدد مختلط پایتون مربوط می‌شود. بیشتر توابعی که با اشیاء عدد مختلط سروکار دارند، بسته به مورد، از ساختارهایی از این نوع به‌عنوان مقادیر ورودی یا خروجی استفاده می‌کنند."

#~ msgid "Complex Numbers as Python Objects"
#~ msgstr "اعداد مختلط به‌عنوان اشیاء پایتون"