Translation of apiabiversion file

Author: invincible627

c-api/apiabiversion.po

@@ -27,249 +27,265 @@ msgstr ""
 
 #: ../../c-api/apiabiversion.rst:7
 msgid "API and ABI Versioning"
-msgstr ""
+msgstr "نسخه‌گذاری API و ABI"
 
 #: ../../c-api/apiabiversion.rst:11
 msgid "Build-time version constants"
-msgstr ""
+msgstr "ثابت‌های نسخه در زمان ساخت"
 
 #: ../../c-api/apiabiversion.rst:13
 msgid ""
 "CPython exposes its version number in the following macros. Note that these "
 "correspond to the version code is **built** with. See :c:var:`Py_Version` "
 "for the version used at **run time**."
 msgstr ""
+"CPython شماره‌ی نسخه‌ی خود را در ماکروهای زیر در معرض دید قرار می‌دهد. توجه داشته باشید که این‌ها "
+"مربوط به نسخه‌ای هستند که کد با آن **ساخته (build)** شده است. برای نسخه‌ای که در **زمان اجرا (run time)** استفاده می‌شود، به :c:var:`Py_Version` مراجعه کنید."
 
 #: ../../c-api/apiabiversion.rst:17
 msgid ""
 "See :ref:`stable` for a discussion of API and ABI stability across versions."
 msgstr ""
+"برای بحث درباره‌ی پایداری API و ABI در میان نسخه‌ها، به :ref:`stable` مراجعه کنید."
 
 #: ../../c-api/apiabiversion.rst:21
 msgid "The ``3`` in ``3.4.1a2``."
-msgstr ""
+msgstr "3 در ``3.4.1a2``."
 
 #: ../../c-api/apiabiversion.rst:25
 msgid "The ``4`` in ``3.4.1a2``."
-msgstr ""
+msgstr "4 در ``3.4.1a2``."
 
 #: ../../c-api/apiabiversion.rst:29
 msgid "The ``1`` in ``3.4.1a2``."
-msgstr ""
+msgstr "1 در ``3.4.1a2``."
 
 #: ../../c-api/apiabiversion.rst:33
 msgid ""
 "The ``a`` in ``3.4.1a2``. This can be ``0xA`` for alpha, ``0xB`` for beta, "
 "``0xC`` for release candidate or ``0xF`` for final."
 msgstr ""
+"``a`` در ``3.4.1a2``. این می‌تواند ``0xA`` برای آلفا باشد، ``0xB`` برای بتا، "
+"``0xC`` برای کاندیدای انتشار (release candidate) یا ``0xF`` برای نهایی (final)."
 
 #: ../../c-api/apiabiversion.rst:39
 msgid "The ``2`` in ``3.4.1a2``. Zero for final releases."
-msgstr ""
+msgstr "``2`` در ``3.4.1a2``. برای انتشارهای نهایی، صفر است."
 
 #: ../../c-api/apiabiversion.rst:43
 msgid ""
 "The Python version number encoded in a single integer. "
 "See :c:func:`Py_PACK_FULL_VERSION` for the encoding details."
 msgstr ""
+"شماره‌ی نسخه‌ی پایتون که در یک عدد صحیح کدگذاری شده است. "
+"برای جزئیات کدگذاری، به :c:func:`Py_PACK_FULL_VERSION` مراجعه کنید."
 
 #: ../../c-api/apiabiversion.rst:46
 msgid ""
 "Use this for numeric comparisons, for example, ``#if PY_VERSION_HEX >= ...``."
 msgstr ""
+"از این (مقدار) برای مقایسه‌های عددی استفاده کنید، برای مثال، ``#if PY_VERSION_HEX >= ...``."
 
 #: ../../c-api/apiabiversion.rst:49
 msgid "These macros are defined in :source:`Include/patchlevel.h`."
-msgstr ""
+msgstr "این ماکروها در :source:`Include/patchlevel.h` تعریف می‌شوند."
 
 #: ../../c-api/apiabiversion.rst:53
 msgid "Run-time version"
-msgstr ""
+msgstr "نسخه‌ی زمان اجرا"
 
 #: ../../c-api/apiabiversion.rst:57
 msgid ""
 "The Python runtime version number encoded in a single constant integer. "
 "See :c:func:`Py_PACK_FULL_VERSION` for the encoding details. This contains "
 "the Python version used at run time."
 msgstr ""
+"شماره‌ی نسخه‌ی زمان اجرای پایتون که در یک عدد صحیح ثابت کدگذاری شده است. "
+"برای جزئیات کدگذاری، به :c:func:`Py_PACK_FULL_VERSION` مراجعه کنید. این (مقدار) شامل "
+"نسخه‌ی پایتون است که در زمان اجرا استفاده می‌شود."
 
 #: ../../c-api/apiabiversion.rst:61
 msgid ""
 "Use this for numeric comparisons, for example, ``if (Py_Version >= ...)``."
 msgstr ""
+"از این (مقدار) برای مقایسه‌های عددی استفاده کنید، برای مثال، ``if (Py_Version >= ...)``."
 
 #: ../../c-api/apiabiversion.rst:67
 msgid "Bit-packing macros"
-msgstr ""
+msgstr "ماکروهای بسته‌بندی بیتی"
 
 #: ../../c-api/apiabiversion.rst:71
 msgid ""
 "Return the given version, encoded as a single 32-bit integer with the "
 "following structure:"
 msgstr ""
+"نسخه‌ی داده‌شده را که به صورت یک عدد صحیح ۳۲-بیتی با "
+"ساختار زیر کدگذاری شده است، برمی‌گرداند:"
 
 #: ../../c-api/apiabiversion.rst:77
 msgid "Argument"
-msgstr ""
+msgstr "آرگومان"
 
 #: ../../c-api/apiabiversion.rst:75
 msgid "No. of bits"
-msgstr ""
+msgstr "تعداد بیت‌ها"
 
 #: ../../c-api/apiabiversion.rst:77
 msgid "Bit mask"
-msgstr ""
+msgstr "ماسک بیتی"
 
 #: ../../c-api/apiabiversion.rst:77
 msgid "Bit shift"
-msgstr ""
+msgstr "شیفت بیتی"
 
 #: ../../c-api/apiabiversion.rst:75
 msgid "Example values"
-msgstr ""
+msgstr "مقادیر نمونه"
 
 #: ../../c-api/apiabiversion.rst:77 ../../c-api/apiabiversion.rst:95
 msgid "``3.4.1a2``"
-msgstr ""
+msgstr "``3.4.1a2``"
 
 #: ../../c-api/apiabiversion.rst:77 ../../c-api/apiabiversion.rst:97
 msgid "``3.10.0``"
-msgstr ""
+msgstr "``3.10.0``"
 
 #: ../../c-api/apiabiversion.rst:79
 msgid "*major*"
-msgstr ""
+msgstr "*major*"
 
 #: ../../c-api/apiabiversion.rst:79 ../../c-api/apiabiversion.rst:81
 #: ../../c-api/apiabiversion.rst:83
 msgid "8"
-msgstr ""
+msgstr "8"
 
 #: ../../c-api/apiabiversion.rst:79
 msgid "``0xFF000000``"
-msgstr ""
+msgstr "``0xFF000000``"
 
 #: ../../c-api/apiabiversion.rst:79
 msgid "24"
-msgstr ""
+msgstr "24"
 
 #: ../../c-api/apiabiversion.rst:79
 msgid "``0x03``"
-msgstr ""
+msgstr "``0x03``"
 
 #: ../../c-api/apiabiversion.rst:81
 msgid "*minor*"
-msgstr ""
+msgstr "*minor*"
 
 #: ../../c-api/apiabiversion.rst:81
 msgid "``0x00FF0000``"
-msgstr ""
+msgstr "``0x00FF0000``"
 
 #: ../../c-api/apiabiversion.rst:81
 msgid "16"
-msgstr ""
+msgstr "16"
 
 #: ../../c-api/apiabiversion.rst:81
 msgid "``0x04``"
-msgstr ""
+msgstr "``0x04``"
 
 #: ../../c-api/apiabiversion.rst:81
 msgid "``0x0A``"
-msgstr ""
+msgstr "``0x0A``"
 
 #: ../../c-api/apiabiversion.rst:83
 msgid "*micro*"
-msgstr ""
+msgstr "*micro*"
 
 #: ../../c-api/apiabiversion.rst:83
 msgid "``0x0000FF00``"
-msgstr ""
+msgstr "``0x0000FF00``"
 
 #: ../../c-api/apiabiversion.rst:83
 msgid "``0x01``"
-msgstr ""
+msgstr "``0x01``"
 
 #: ../../c-api/apiabiversion.rst:83
 msgid "``0x00``"
-msgstr ""
+msgstr "``0x00``"
 
 #: ../../c-api/apiabiversion.rst:85
 msgid "*release_level*"
-msgstr ""
+msgstr "*release_level*"
 
 #: ../../c-api/apiabiversion.rst:85 ../../c-api/apiabiversion.rst:87
 msgid "4"
-msgstr ""
+msgstr "4"
 
 #: ../../c-api/apiabiversion.rst:85
 msgid "``0x000000F0``"
-msgstr ""
+msgstr "``0x000000F0``"
 
 #: ../../c-api/apiabiversion.rst:85
 msgid "``0xA``"
-msgstr ""
+msgstr "``0xA``"
 
 #: ../../c-api/apiabiversion.rst:85
 msgid "``0xF``"
-msgstr ""
+msgstr "``0xF``"
 
 #: ../../c-api/apiabiversion.rst:87
 msgid "*release_serial*"
-msgstr ""
+msgstr "*release_serial*"
 
 #: ../../c-api/apiabiversion.rst:87
 msgid "``0x0000000F``"
-msgstr ""
+msgstr "``0x0000000F``"
 
 #: ../../c-api/apiabiversion.rst:87
 msgid "0"
-msgstr ""
+msgstr "0"
 
 #: ../../c-api/apiabiversion.rst:87
 msgid "``0x2``"
-msgstr ""
+msgstr "``0x2``"
 
 #: ../../c-api/apiabiversion.rst:87
 msgid "``0x0``"
-msgstr ""
+msgstr "``0x0``"
 
 #: ../../c-api/apiabiversion.rst:90
 msgid "For example:"
-msgstr ""
+msgstr "برای مثال:"
 
 #: ../../c-api/apiabiversion.rst:93
 msgid "Version"
-msgstr ""
+msgstr "نسخه"
 
 #: ../../c-api/apiabiversion.rst:93
 msgid "``Py_PACK_FULL_VERSION`` arguments"
-msgstr ""
+msgstr "آرگومان‌های ``Py_PACK_FULL_VERSION``"
 
 #: ../../c-api/apiabiversion.rst:93
 msgid "Encoded version"
-msgstr ""
+msgstr "نسخه‌ی کدگذاری شده"
 
 #: ../../c-api/apiabiversion.rst:95
 msgid "``(3, 4, 1, 0xA, 2)``"
-msgstr ""
+msgstr "``(3, 4, 1, 0xA, 2)``"
 
 #: ../../c-api/apiabiversion.rst:95
 msgid "``0x030401a2``"
-msgstr ""
+msgstr "``0x030401a2``"
 
 #: ../../c-api/apiabiversion.rst:97
 msgid "``(3, 10, 0, 0xF, 0)``"
-msgstr ""
+msgstr "``(3, 10, 0, 0xF, 0)``"
 
 #: ../../c-api/apiabiversion.rst:97
 msgid "``0x030a00f0``"
-msgstr ""
+msgstr "``0x030a00f0``"
 
 #: ../../c-api/apiabiversion.rst:100
 msgid ""
 "Out-of range bits in the arguments are ignored. That is, the macro can be "
 "defined as:"
 msgstr ""
+"بیت‌های خارج از محدوده در آرگومان‌ها نادیده گرفته می‌شوند. به عبارت دیگر، این ماکرو را می‌توان "
+"به صورت زیر تعریف کرد:"
 
 #: ../../c-api/apiabiversion.rst:103
 msgid ""
@@ -282,16 +298,29 @@ msgid ""
 "   (((SERIAL) & 0xf) << 0))\n"
 "#endif"
 msgstr ""
-
+"#ifndef Py_PACK_FULL_VERSION\n"
+"#define Py_PACK_FULL_VERSION(X, Y, Z, LEVEL, SERIAL) ( \\\n"
+"   (((X) & 0xff) << 24) |                              \\\n"
+"   (((Y) & 0xff) << 16) |                              \\\n"
+"   (((Z) & 0xff) << 8) |                               \\\n"
+"   (((LEVEL) & 0xf) << 4) |                            \\\n"
+"   (((SERIAL) & 0xf) << 0))\n"
+"#endif"
 #: ../../c-api/apiabiversion.rst:114
+
 msgid ""
 "``Py_PACK_FULL_VERSION`` is primarily a macro, intended for use in ``#if`` "
 "directives, but it is also available as an exported function."
 msgstr ""
+"``Py_PACK_FULL_VERSION`` در درجه‌ی اول یک ماکرو است که برای استفاده در دستورات "
+"``#if`` در نظر گرفته شده است، اما به‌عنوان یک تابع صادرشده نیز در دسترس است."
 
 #: ../../c-api/apiabiversion.rst:121
 msgid ""
 "Equivalent to ``Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)``. The result "
 "does not correspond to any Python release, but is useful in numeric "
 "comparisons."
 msgstr ""
+"معادل ``Py_PACK_FULL_VERSION(major, minor, 0, 0, 0)`` است. نتیجه "
+"با هیچ نسخه‌ی انتشار یافته‌ای از پایتون مطابقت ندارد، اما در مقایسه‌های عددی "
+"مفید است."