python-docs-fa/c-api/complex.po at refs/heads/3.14 · python/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
# 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
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-16 12:56+0000\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 "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 "Complex Numbers as C Structures"
msgstr "اعداد مختلط به‌عنوان ساختارهای C"

msgid "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.  This is consistent throughout the API."
msgstr "توجه داشته باشید که توابعی که این ساختارها را به‌عنوان پارامتر می‌پذیرند و آن‌ها را به‌عنوان نتیجه برمی‌گردانند، این کار را *به‌صورت مقدار* انجام می‌دهند، نه با ارجاع‌زدایی (dereferencing) آن‌ها از طریق اشاره‌گرها. این موضوع در سراسر 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 "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 "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 "Complex Numbers as Python Objects"
msgstr "اعداد مختلط به‌عنوان اشیاء پایتون"

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

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 "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 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 "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 "object"
msgstr "شیء"

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