GeezerVisonThe World Wide Web, restored to 800 pixels of glory. |
| Home|About|Gaming cabinet|Archives|How it works|Starter sites |
GeezerVison is showing github.com — python-docs-fa/howto/sorting.po at 3.15 · python/python-docs-fa Expand file tree/ Copy pathsorting.poMore file actions 512 lines (420 loc) · 36.3 KB / Copy pathsorting.poFile metadata and controls512 lines (420 loc) · 36.3 KB 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 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 # 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) <[email protected]>, 2025 # Danial Behzadi <[email protected]>, 2025 # Rafael Fontenelle <[email protected]>, 2025 # Sepehr Rasouli <[email protected]>, 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:53+0000\n" "Last-Translator: Sepehr Rasouli <[email protected]>, 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 "Sorting Techniques" msgstr "روش‌های مرتب‌سازی" msgid "Python lists have a built-in :meth:`list.sort` method that modifies the list in-place. There is also a :func:`sorted` built-in function that builds a new sorted list from an iterable." msgstr "فهرست‌های پایتون یک متد توکار :meth:`list.sort` دارند که فهرست را به‌صورت درجا تغییر می‌دهد. همچنین یک تابع توکار :func:`sorted` وجود دارد که یک فهرست مرتب‌شده‌ی جدید از یک پیمایش‌پذیر می‌سازد." msgid "In this document, we explore the various techniques for sorting data using Python." msgstr "در این سند، روش‌های مختلف مرتب‌سازی داده‌ها با استفاده از پایتون را بررسی می‌کنیم." msgid "Sorting Basics" msgstr "مبانی مرتب‌سازی" msgid "A simple ascending sort is very easy: just call the :func:`sorted` function. It returns a new sorted list:" msgstr "یک مرتب‌سازی صعودی ساده بسیار آسان است: کافی است تابع :func:`sorted` را فراخوانی کنید. این تابع یک فهرست مرتب‌شده‌ی جدید برمی‌گرداند:" msgid "" ">>> sorted([5, 2, 3, 1, 4])\n" "[1, 2, 3, 4, 5]" msgstr "" ">>> sorted([5, 2, 3, 1, 4])\n" "[1, 2, 3, 4, 5]" msgid "You can also use the :meth:`list.sort` method. It modifies the list in-place (and returns ``None`` to avoid confusion). Usually it's less convenient than :func:`sorted` - but if you don't need the original list, it's slightly more efficient." msgstr "همچنین می‌توانید از متد :meth:`list.sort` استفاده کنید. این متد فهرست را به‌صورت درجا تغییر می‌دهد (و برای جلوگیری از سردرگمی، ``None`` را برمی‌گرداند). معمولاً به اندازه :func:`sorted` راحت نیست، اما اگر نیازی به فهرست اصلی ندارید، کمی کارآمدتر است." msgid "" ">>> a = [5, 2, 3, 1, 4]\n" ">>> a.sort()\n" ">>> a\n" "[1, 2, 3, 4, 5]" msgstr "" ">>> a = [5, 2, 3, 1, 4]\n" ">>> a.sort()\n" ">>> a\n" "[1, 2, 3, 4, 5]" msgid "Another difference is that the :meth:`list.sort` method is only defined for lists. In contrast, the :func:`sorted` function accepts any iterable." msgstr "تفاوت دیگر این است که متد :meth:`list.sort` فقط برای فهرست‌ها تعریف شده است. در مقابل، تابع :func:`sorted` هر پیمایش‌پذیری را می‌پذیرد." msgid "" ">>> sorted({1: 'D', 2: 'B', 3: 'B', 4: 'E', 5: 'A'})\n" "[1, 2, 3, 4, 5]" msgstr "" ">>> sorted({1: 'D', 2: 'B', 3: 'B', 4: 'E', 5: 'A'})\n" "[1, 2, 3, 4, 5]" msgid "Key Functions" msgstr "توابع کلیدی" msgid "The :meth:`list.sort` method and the functions :func:`sorted`, :func:`min`, :func:`max`, :func:`heapq.nsmallest`, and :func:`heapq.nlargest` have a *key* parameter to specify a function (or other callable) to be called on each list element prior to making comparisons." msgstr "متد :meth:`list.sort` و توابع :func:`sorted`، :func:`min`، :func:`max`، :func:`heapq.nsmallest` و :func:`heapq.nlargest` یک پارامتر *key* دارند که برای مشخص کردن تابعی (یا شیء فراخوانی‌پذیر دیگر) به کار می‌رود تا پیش از انجام مقایسه‌ها روی هر عنصر فهرست فراخوانی شود." msgid "For example, here's a case-insensitive string comparison using :meth:`str.casefold`:" msgstr "برای مثال، در اینجا یک مقایسه‌ی رشته‌ای بدون حساسیت به بزرگی و کوچکی حروف با استفاده از :meth:`str.casefold` آمده است:" msgid "" ">>> sorted(\"This is a test string from Andrew\".split(), key=str.casefold)\n" "['a', 'Andrew', 'from', 'is', 'string', 'test', 'This']" msgstr "" ">>> sorted(\"This is a test string from Andrew\".split(), key=str.casefold)\n" "['a', 'Andrew', 'from', 'is', 'string', 'test', 'This']" msgid "The value of the *key* parameter should be a function (or other callable) that takes a single argument and returns a key to use for sorting purposes. This technique is fast because the key function is called exactly once for each input record." msgstr "مقدار پارامتر *key* باید تابعی (یا یک شیء فراخوانی‌پذیر دیگر) باشد که یک آرگومان می‌گیرد و کلیدی برای استفاده در مرتب‌سازی برمی‌گرداند. این روش سریع است زیرا تابع کلید دقیقاً یک بار برای هر رکورد ورودی فراخوانی می‌شود." msgid "A common pattern is to sort complex objects using some of the object's indices as keys. For example:" msgstr "یک الگوی رایج، مرتب‌سازی اشیاء پیچیده با استفاده از برخی از اندیس‌های شیء به‌عنوان کلید است. برای مثال:" msgid "" ">>> student_tuples = [\n" "... ('john', 'A', 15),\n" "... ('jane', 'B', 12),\n" "... ('dave', 'B', 10),\n" "... ]\n" ">>> sorted(student_tuples, key=lambda student: student[2]) # sort by age\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" ">>> student_tuples = [\n" "... ('john', 'A', 15),\n" "... ('jane', 'B', 12),\n" "... ('dave', 'B', 10),\n" "... ]\n" ">>> sorted(student_tuples, key=lambda student: student[2]) # sort by age\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgid "The same technique works for objects with named attributes. For example:" msgstr "همین روش برای اشیاء دارای ویژگی‌های نام‌دار نیز کار می‌کند. برای مثال:" msgid "" ">>> class Student:\n" "... def __init__(self, name, grade, age):\n" "... self.name = name\n" "... self.grade = grade\n" "... self.age = age\n" "... def __repr__(self):\n" "... return repr((self.name, self.grade, self.age))\n" "\n" ">>> student_objects = [\n" "... Student('john', 'A', 15),\n" "... Student('jane', 'B', 12),\n" "... Student('dave', 'B', 10),\n" "... ]\n" ">>> sorted(student_objects, key=lambda student: student.age) # sort by age\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" ">>> class Student:\n" "... def __init__(self, name, grade, age):\n" "... self.name = name\n" "... self.grade = grade\n" "... self.age = age\n" "... def __repr__(self):\n" "... return repr((self.name, self.grade, self.age))\n" "\n" ">>> student_objects = [\n" "... Student('john', 'A', 15),\n" "... Student('jane', 'B', 12),\n" "... Student('dave', 'B', 10),\n" "... ]\n" ">>> sorted(student_objects, key=lambda student: student.age) # sort by age\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgid "Objects with named attributes can be made by a regular class as shown above, or they can be instances of :class:`~dataclasses.dataclass` or a :term:`named tuple`." msgstr "اشیاء دارای ویژگی‌های نام‌دار می‌توانند با یک کلاس معمولی، همان‌طور که در بالا نشان داده شد، ساخته شوند، یا می‌توانند نمونه‌هایی از :class:`~dataclasses.dataclass` یا یک :term:`named tuple` باشند." msgid "Operator Module Functions and Partial Function Evaluation" msgstr "توابع ماژول operator و ارزیابی جزئی تابع" msgid "The :term:`key function` patterns shown above are very common, so Python provides convenience functions to make accessor functions easier and faster. The :mod:`operator` module has :func:`~operator.itemgetter`, :func:`~operator.attrgetter`, and a :func:`~operator.methodcaller` function." msgstr "الگوهای :term:`تابع کلید <key function>` نشان‌داده‌شده در بالا بسیار رایج هستند، بنابراین پایتون توابع کمکی برای ساده‌تر و سریع‌تر کردن توابع دسترسی فراهم می‌کند. ماژول :mod:`operator` دارای توابع :func:`~operator.itemgetter`، :func:`~operator.attrgetter` و :func:`~operator.methodcaller` است." msgid "Using those functions, the above examples become simpler and faster:" msgstr "با استفاده از آن توابع، مثال‌های بالا ساده‌تر و سریع‌تر می‌شوند:" msgid "" ">>> from operator import itemgetter, attrgetter\n" "\n" ">>> sorted(student_tuples, key=itemgetter(2))\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]\n" "\n" ">>> sorted(student_objects, key=attrgetter('age'))\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" ">>> from operator import itemgetter, attrgetter\n" "\n" ">>> sorted(student_tuples, key=itemgetter(2))\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]\n" "\n" ">>> sorted(student_objects, key=attrgetter('age'))\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgid "The operator module functions allow multiple levels of sorting. For example, to sort by *grade* then by *age*:" msgstr "توابع ماژول operator امکان مرتب‌سازی در چند سطح را فراهم می‌کنند. برای مثال، برای مرتب‌سازی بر اساس *grade* و سپس بر اساس *age*:" msgid "" ">>> sorted(student_tuples, key=itemgetter(1,2))\n" "[('john', 'A', 15), ('dave', 'B', 10), ('jane', 'B', 12)]\n" "\n" ">>> sorted(student_objects, key=attrgetter('grade', 'age'))\n" "[('john', 'A', 15), ('dave', 'B', 10), ('jane', 'B', 12)]" msgstr "" ">>> sorted(student_tuples, key=itemgetter(1,2))\n" "[('john', 'A', 15), ('dave', 'B', 10), ('jane', 'B', 12)]\n" "\n" ">>> sorted(student_objects, key=attrgetter('grade', 'age'))\n" "[('john', 'A', 15), ('dave', 'B', 10), ('jane', 'B', 12)]" msgid "The :mod:`functools` module provides another helpful tool for making key-functions. The :func:`~functools.partial` function can reduce the `arity <https://en.wikipedia.org/wiki/Arity>`_ of a multi-argument function making it suitable for use as a key-function." msgstr "ماژول :mod:`functools` ابزار مفید دیگری برای ساخت توابع کلید فراهم می‌کند. تابع :func:`~functools.partial` می‌تواند `تعداد آرگومان‌ها (arity) <https://fa.wikipedia.org/wiki/آریتی_(ریاضی)>`_ یک تابع با چند آرگومان را کاهش دهد و آن را برای استفاده به‌عنوان یک تابع کلید مناسب کند." msgid "" ">>> from functools import partial\n" ">>> from unicodedata import normalize\n" "\n" ">>> names = 'Zoë Åbjørn Núñez Élana Zeke Abe Nubia Eloise'.split()\n" "\n" ">>> sorted(names, key=partial(normalize, 'NFD'))\n" "['Abe', 'Åbjørn', 'Eloise', 'Élana', 'Nubia', 'Núñez', 'Zeke', 'Zoë']\n" "\n" ">>> sorted(names, key=partial(normalize, 'NFC'))\n" "['Abe', 'Eloise', 'Nubia', 'Núñez', 'Zeke', 'Zoë', 'Åbjørn', 'Élana']" msgstr "" ">>> from functools import partial\n" ">>> from unicodedata import normalize\n" "\n" ">>> names = 'Zoë Åbjørn Núñez Élana Zeke Abe Nubia Eloise'.split()\n" "\n" ">>> sorted(names, key=partial(normalize, 'NFD'))\n" "['Abe', 'Åbjørn', 'Eloise', 'Élana', 'Nubia', 'Núñez', 'Zeke', 'Zoë']\n" "\n" ">>> sorted(names, key=partial(normalize, 'NFC'))\n" "['Abe', 'Eloise', 'Nubia', 'Núñez', 'Zeke', 'Zoë', 'Åbjørn', 'Élana']" msgid "Ascending and Descending" msgstr "صعودی و نزولی" msgid "Both :meth:`list.sort` and :func:`sorted` accept a *reverse* parameter with a boolean value. This is used to flag descending sorts. For example, to get the student data in reverse *age* order:" msgstr "هر دو :meth:`list.sort` و :func:`sorted` یک پارامتر *reverse* با مقدار بولی می‌پذیرند. این برای مشخص کردن مرتب‌سازی نزولی استفاده می‌شود. برای مثال، برای دریافت داده‌های دانشجویی به ترتیب معکوس *سن*:" msgid "" ">>> sorted(student_tuples, key=itemgetter(2), reverse=True)\n" "[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]\n" "\n" ">>> sorted(student_objects, key=attrgetter('age'), reverse=True)\n" "[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]" msgstr "" ">>> sorted(student_tuples, key=itemgetter(2), reverse=True)\n" "[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]\n" "\n" ">>> sorted(student_objects, key=attrgetter('age'), reverse=True)\n" "[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]" msgid "Sort Stability and Complex Sorts" msgstr "پایداری مرتب‌سازی و مرتب‌سازی‌های پیچیده" msgid "Sorts are guaranteed to be `stable <https://en.wikipedia.org/wiki/Sorting_algorithm#Stability>`_\\. That means that when multiple records have the same key, their original order is preserved." msgstr "تضمین می‌شود که مرتب‌سازی‌ها `پایدار <https://fa.wikipedia.org/wiki/الگوریتم_مرتب‌سازی>`_ باشند. این بدان معناست که هنگامی که چندین رکورد کلید یکسانی دارند، ترتیب اصلی آن‌ها حفظ می‌شود." msgid "" ">>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)]\n" ">>> sorted(data, key=itemgetter(0))\n" "[('blue', 1), ('blue', 2), ('red', 1), ('red', 2)]" msgstr "" ">>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)]\n" ">>> sorted(data, key=itemgetter(0))\n" "[('blue', 1), ('blue', 2), ('red', 1), ('red', 2)]" msgid "Notice how the two records for *blue* retain their original order so that ``('blue', 1)`` is guaranteed to precede ``('blue', 2)``." msgstr "توجه کنید که چگونه دو رکورد برای *blue* ترتیب اصلی خود را حفظ می‌کنند، به‌طوری که تضمین می‌شود ``('blue', 1)`` پیش از ``('blue', 2)`` قرار دارد." msgid "This wonderful property lets you build complex sorts in a series of sorting steps. For example, to sort the student data by descending *grade* and then ascending *age*, do the *age* sort first and then sort again using *grade*:" msgstr "این ویژگی فوق‌العاده به شما امکان می‌دهد مرتب‌سازی‌های پیچیده را در مجموعه‌ای از گام‌های مرتب‌سازی ایجاد کنید. برای مثال، برای مرتب‌سازی داده‌های دانش‌آموز بر اساس *نمره* به‌صورت نزولی و سپس *سن* به‌صورت صعودی، ابتدا مرتب‌سازی بر اساس *سن* را انجام دهید و سپس دوباره با استفاده از *نمره* مرتب کنید:" msgid "" ">>> s = sorted(student_objects, key=attrgetter('age')) # sort on secondary key\n" ">>> sorted(s, key=attrgetter('grade'), reverse=True) # now sort on primary key, descending\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" ">>> s = sorted(student_objects, key=attrgetter('age')) # sort on secondary key\n" ">>> sorted(s, key=attrgetter('grade'), reverse=True) # now sort on primary key, descending\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgid "This can be abstracted out into a wrapper function that can take a list and tuples of field and order to sort them on multiple passes." msgstr "این را می‌توان به‌صورت یک تابع پوششی انتزاع کرد که بتواند یک فهرست و تاپل‌هایی از فیلد و ترتیب را برای مرتب‌سازی آن‌ها در چندین گذر دریافت کند." msgid "" ">>> def multisort(xs, specs):\n" "... for key, reverse in reversed(specs):\n" "... xs.sort(key=attrgetter(key), reverse=reverse)\n" "... return xs\n" "\n" ">>> multisort(list(student_objects), (('grade', True), ('age', False)))\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" ">>> def multisort(xs, specs):\n" "... for key, reverse in reversed(specs):\n" "... xs.sort(key=attrgetter(key), reverse=reverse)\n" "... return xs\n" "\n" ">>> multisort(list(student_objects), (('grade', True), ('age', False)))\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgid "The `Timsort <https://en.wikipedia.org/wiki/Timsort>`_ algorithm used in Python does multiple sorts efficiently because it can take advantage of any ordering already present in a dataset." msgstr "الگوریتم `Timsort <https://fa.wikipedia.org/wiki/مرتب‌سازی_تیم>`_ به‌کاررفته در پایتون، مرتب‌سازی‌های متعدد را به‌طور کارآمد انجام می‌دهد، زیرا می‌تواند از هرگونه ترتیب از پیش موجود در یک مجموعه داده بهره ببرد." msgid "Decorate-Sort-Undecorate" msgstr "آرایش-مرتب‌سازی-ناآرایش (Decorate-Sort-Undecorate)" msgid "This idiom is called Decorate-Sort-Undecorate after its three steps:" msgstr "این اصطلاح به نام Decorate-Sort-Undecorate نامیده می‌شود که برگرفته از سه مرحله‌ی آن است:" msgid "First, the initial list is decorated with new values that control the sort order." msgstr "ابتدا، فهرست اولیه با مقادیر جدیدی که ترتیب مرتب‌سازی را کنترل می‌کنند، آراسته می‌شود." msgid "Second, the decorated list is sorted." msgstr "دوم، فهرست دکورشده مرتب می‌شود." msgid "Finally, the decorations are removed, creating a list that contains only the initial values in the new order." msgstr "در نهایت، آرایش‌ها (decorations) حذف می‌شوند و فهرستی ایجاد می‌شود که فقط شامل مقادیر اولیه به ترتیب جدید است." msgid "For example, to sort the student data by *grade* using the DSU approach:" msgstr "برای مثال، برای مرتب‌سازی داده‌های دانش‌آموزان بر اساس *نمره* با استفاده از رویکرد DSU:" msgid "" ">>> decorated = [(student.grade, i, student) for i, student in enumerate(student_objects)]\n" ">>> decorated.sort()\n" ">>> [student for grade, i, student in decorated] # undecorate\n" "[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]" msgstr "" ">>> decorated = [(student.grade, i, student) for i, student in enumerate(student_objects)]\n" ">>> decorated.sort()\n" ">>> [student for grade, i, student in decorated] # undecorate\n" "[('john', 'A', 15), ('jane', 'B', 12), ('dave', 'B', 10)]" msgid "This idiom works because tuples are compared lexicographically; the first items are compared; if they are the same then the second items are compared, and so on." msgstr "این روش کار می‌کند زیرا تاپل‌ها به‌صورت لغت‌نامه‌ای مقایسه می‌شوند؛ آیتم‌های اول مقایسه می‌شوند؛ اگر یکسان باشند، آیتم‌های دوم مقایسه می‌شوند و به همین ترتیب." msgid "It is not strictly necessary in all cases to include the index *i* in the decorated list, but including it gives two benefits:" msgstr "در همه موارد، آوردن اندیس *i* در فهرست آراسته اکیداً ضروری نیست، اما گنجاندن آن دو مزیت دارد:" msgid "The sort is stable -- if two items have the same key, their order will be preserved in the sorted list." msgstr "مرتب‌سازی پایدار است — اگر دو آیتم کلید یکسانی داشته باشند، ترتیب آن‌ها در فهرست مرتب‌شده حفظ می‌شود." msgid "The original items do not have to be comparable because the ordering of the decorated tuples will be determined by at most the first two items. So for example the original list could contain complex numbers which cannot be sorted directly." msgstr "آیتم‌های اصلی لازم نیست قابل مقایسه باشند، زیرا ترتیب تاپل‌های دکورشده حداکثر بر اساس دو آیتم اول تعیین می‌شود. بنابراین برای مثال، فهرست اصلی می‌تواند شامل اعداد مختلط باشد که نمی‌توان آن‌ها را به‌طور مستقیم مرتب کرد." msgid "Another name for this idiom is `Schwartzian transform <https://en.wikipedia.org/wiki/Schwartzian_transform>`_\\, after Randal L. Schwartz, who popularized it among Perl programmers." msgstr "نام دیگر این اصطلاح `Schwartzian transform <https://en.wikipedia.org/wiki/Schwartzian_transform>`_\\، برگرفته از نام Randal L. Schwartz است که آن را میان برنامه‌نویسان Perl رواج داد." msgid "Now that Python sorting provides key-functions, this technique is not often needed." msgstr "اکنون که مرتب‌سازی پایتون توابع کلید را فراهم می‌کند، اغلب نیازی به این روش نیست." msgid "Comparison Functions" msgstr "توابع مقایسه" msgid "Unlike key functions that return an absolute value for sorting, a comparison function computes the relative ordering for two inputs." msgstr "برخلاف توابع کلید که یک مقدار مطلق را برای مرتب‌سازی برمی‌گردانند، یک تابع مقایسه ترتیب نسبی دو ورودی را محاسبه می‌کند." msgid "For example, a `balance scale <https://upload.wikimedia.org/wikipedia/commons/1/17/Balance_à_tabac_1850.JPG>`_ compares two samples giving a relative ordering: lighter, equal, or heavier. Likewise, a comparison function such as ``cmp(a, b)`` will return a negative value for less-than, zero if the inputs are equal, or a positive value for greater-than." msgstr "برای مثال، یک `ترازوی دوکفه‌ای <https://upload.wikimedia.org/wikipedia/commons/1/17/Balance_à_tabac_1850.JPG>`_ دو نمونه را مقایسه می‌کند و یک ترتیب نسبی ارائه می‌دهد: سبک‌تر، برابر، یا سنگین‌تر. به همین ترتیب، یک تابع مقایسه مانند ``cmp(a, b)`` مقدار منفی برای کوچک‌تر بودن، صفر اگر ورودی‌ها برابر باشند، یا مقدار مثبت برای بزرگ‌تر بودن برمی‌گرداند." msgid "It is common to encounter comparison functions when translating algorithms from other languages. Also, some libraries provide comparison functions as part of their API. For example, :func:`locale.strcoll` is a comparison function." msgstr "معمول است که هنگام ترجمه الگوریتم‌ها از زبان‌های دیگر با توابع مقایسه مواجه شوید. همچنین، برخی کتابخانه‌ها توابع مقایسه را به‌عنوان بخشی از API خود ارائه می‌کنند. برای مثال، :func:`locale.strcoll` یک تابع مقایسه است." msgid "To accommodate those situations, Python provides :class:`functools.cmp_to_key` to wrap the comparison function to make it usable as a key function::" msgstr "برای سازگاری با این موقعیت‌ها، پایتون :class:`functools.cmp_to_key` را فراهم می‌کند تا تابع مقایسه را در بر بگیرد و آن را به‌عنوان تابع کلید قابل‌استفاده کند::" msgid "sorted(words, key=cmp_to_key(strcoll)) # locale-aware sort order" msgstr "sorted(words, key=cmp_to_key(strcoll)) # locale-aware sort order" msgid "Strategies For Unorderable Types and Values" msgstr "راهبردهایی برای انواع و مقادیر غیرقابل‌مرتب‌سازی" msgid "A number of type and value issues can arise when sorting. Here are some strategies that can help:" msgstr "هنگام مرتب‌سازی ممکن است مسائل مختلفی مربوط به نوع و مقدار پیش بیاید. در اینجا چند راهبرد آمده است که می‌تواند کمک کند:" msgid "Convert non-comparable input types to strings prior to sorting:" msgstr "انواع ورودی غیرقابل‌مقایسه را پیش از مرتب‌سازی به رشته تبدیل کنید:" msgid "" ">>> data = ['twelve', '11', 10]\n" ">>> sorted(map(str, data))\n" "['10', '11', 'twelve']" msgstr "" ">>> data = ['twelve', '11', 10]\n" ">>> sorted(map(str, data))\n" "['10', '11', 'twelve']" msgid "This is needed because most cross-type comparisons raise a :exc:`TypeError`." msgstr "این مورد لازم است، زیرا بیشتر مقایسه‌های بین‌نوعی یک :exc:`TypeError` پرتاب می‌کنند." msgid "Remove special values prior to sorting:" msgstr "مقادیر خاص را پیش از مرتب‌سازی حذف کنید:" msgid "" ">>> from math import isnan\n" ">>> from itertools import filterfalse\n" ">>> data = [3.3, float('nan'), 1.1, 2.2]\n" ">>> sorted(filterfalse(isnan, data))\n" "[1.1, 2.2, 3.3]" msgstr "" ">>> from math import isnan\n" ">>> from itertools import filterfalse\n" ">>> data = [3.3, float('nan'), 1.1, 2.2]\n" ">>> sorted(filterfalse(isnan, data))\n" "[1.1, 2.2, 3.3]" msgid "This is needed because the `IEEE-754 standard <https://en.wikipedia.org/wiki/IEEE_754>`_ specifies that, \"Every NaN shall compare unordered with everything, including itself.\"" msgstr "این لازم است زیرا `استاندارد IEEE-754 <https://fa.wikipedia.org/wiki/IEEE_۷۵۴>`_ تصریح می‌کند که: «هر NaN باید در مقایسه با هر چیزی، از جمله خودش، نامرتب باشد.»" msgid "Likewise, ``None`` can be stripped from datasets as well:" msgstr "به همین ترتیب، می‌توان ``None`` را نیز از مجموعه‌داده‌ها حذف کرد:" msgid "" ">>> data = [3.3, None, 1.1, 2.2]\n" ">>> sorted(x for x in data if x is not None)\n" "[1.1, 2.2, 3.3]" msgstr "" ">>> data = [3.3, None, 1.1, 2.2]\n" ">>> sorted(x for x in data if x is not None)\n" "[1.1, 2.2, 3.3]" msgid "This is needed because ``None`` is not comparable to other types." msgstr "این مورد لازم است زیرا ``None`` با انواع دیگر قابل‌مقایسه نیست." msgid "Convert mapping types into sorted item lists before sorting:" msgstr "پیش از مرتب‌سازی، انواع نگاشت را به فهرست‌های مرتب‌شده از آیتم‌ها تبدیل کنید:" msgid "" ">>> data = [{'a': 1}, {'b': 2}]\n" ">>> sorted(data, key=lambda d: sorted(d.items()))\n" "[{'a': 1}, {'b': 2}]" msgstr "" ">>> data = [{'a': 1}, {'b': 2}]\n" ">>> sorted(data, key=lambda d: sorted(d.items()))\n" "[{'a': 1}, {'b': 2}]" msgid "This is needed because dict-to-dict comparisons raise a :exc:`TypeError`." msgstr "این کار لازم است، زیرا مقایسه‌ی دیکشنری با دیکشنری باعث پرتاب :exc:`TypeError` می‌شود." msgid "Convert set types into sorted lists before sorting:" msgstr "پیش از مرتب‌سازی، انواع مجموعه را به فهرست‌های مرتب‌شده تبدیل کنید:" msgid "" ">>> data = [{'a', 'b', 'c'}, {'b', 'c', 'd'}]\n" ">>> sorted(map(sorted, data))\n" "[['a', 'b', 'c'], ['b', 'c', 'd']]" msgstr "" ">>> data = [{'a', 'b', 'c'}, {'b', 'c', 'd'}]\n" ">>> sorted(map(sorted, data))\n" "[['a', 'b', 'c'], ['b', 'c', 'd']]" msgid "This is needed because the elements contained in set types do not have a deterministic order. For example, ``list({'a', 'b'})`` may produce either ``['a', 'b']`` or ``['b', 'a']``." msgstr "این امر لازم است زیرا المان‌های موجود در انواع مجموعه‌ای ترتیب قطعی ندارند. برای مثال، ``list({'a', 'b'})`` ممکن است ``['a', 'b']`` یا ``['b', 'a']`` را تولید کند." msgid "Odds and Ends" msgstr "موارد متفرقه" msgid "For locale aware sorting, use :func:`locale.strxfrm` for a key function or :func:`locale.strcoll` for a comparison function. This is necessary because \"alphabetical\" sort orderings can vary across cultures even if the underlying alphabet is the same." msgstr "برای مرتب‌سازی آگاه از locale، از :func:`locale.strxfrm` به‌عنوان تابع کلید یا از :func:`locale.strcoll` به‌عنوان تابع مقایسه استفاده کنید. این کار ضروری است، زیرا ترتیب‌های مرتب‌سازی «الفبایی» می‌توانند بین فرهنگ‌ها متفاوت باشند، حتی اگر الفبای زیربنایی یکسان باشد." msgid "The *reverse* parameter still maintains sort stability (so that records with equal keys retain the original order). Interestingly, that effect can be simulated without the parameter by using the builtin :func:`reversed` function twice:" msgstr "پارامتر *reverse* همچنان پایداری مرتب‌سازی را حفظ می‌کند (به‌طوری که رکوردهایی با کلیدهای برابر، ترتیب اصلی خود را حفظ می‌کنند). جالب است که می‌توان آن اثر را بدون این پارامتر، با دو بار استفاده از تابع توکار :func:`reversed` شبیه‌سازی کرد:" msgid "" ">>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)]\n" ">>> standard_way = sorted(data, key=itemgetter(0), reverse=True)\n" ">>> double_reversed = list(reversed(sorted(reversed(data), key=itemgetter(0))))\n" ">>> assert standard_way == double_reversed\n" ">>> standard_way\n" "[('red', 1), ('red', 2), ('blue', 1), ('blue', 2)]" msgstr "" ">>> data = [('red', 1), ('blue', 1), ('red', 2), ('blue', 2)]\n" ">>> standard_way = sorted(data, key=itemgetter(0), reverse=True)\n" ">>> double_reversed = list(reversed(sorted(reversed(data), key=itemgetter(0))))\n" ">>> assert standard_way == double_reversed\n" ">>> standard_way\n" "[('red', 1), ('red', 2), ('blue', 1), ('blue', 2)]" msgid "The sort routines use ``<`` when making comparisons between two objects. So, it is easy to add a standard sort order to a class by defining an :meth:`~object.__lt__` method:" msgstr "روال‌های مرتب‌سازی هنگام مقایسه‌ی دو شیء از ``<`` استفاده می‌کنند. بنابراین، افزودن یک ترتیب مرتب‌سازی استاندارد به یک کلاس با تعریف یک متد :meth:`~object.__lt__` آسان است:" msgid "" ">>> Student.__lt__ = lambda self, other: self.age < other.age\n" ">>> sorted(student_objects)\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgstr "" ">>> Student.__lt__ = lambda self, other: self.age < other.age\n" ">>> sorted(student_objects)\n" "[('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]" msgid "However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for details on the mechanics). To avoid surprises, :pep:`8` recommends that all six comparison methods be implemented. The :deco:`~functools.total_ordering` decorator is provided to make that task easier." msgstr "با این حال، توجه داشته باشید که اگر :meth:`~object.__lt__` پیاده‌سازی نشده باشد، ``<`` می‌تواند به استفاده از :meth:`~object.__gt__` روی بیاورد (برای جزئیات سازوکار، :func:`object.__lt__` را ببینید). برای جلوگیری از موارد غیرمنتظره، :pep:`8` توصیه می‌کند که هر شش متد مقایسه‌ای پیاده‌سازی شوند. دکوراتور :deco:`~functools.total_ordering` برای آسان‌تر کردن این کار ارائه شده است." msgid "Key functions need not depend directly on the objects being sorted. A key function can also access external resources. For instance, if the student grades are stored in a dictionary, they can be used to sort a separate list of student names:" msgstr "توابع کلید لازم نیست مستقیماً به اشیایی که مرتب می‌شوند وابسته باشند. یک تابع کلید همچنین می‌تواند به منابع خارجی دسترسی داشته باشد. برای مثال، اگر نمرات دانش‌آموزان در یک دیکشنری ذخیره‌شده باشد، می‌توان از آن‌ها برای مرتب‌سازی فهرستی جداگانه از نام‌های دانش‌آموزان استفاده کرد:" msgid "" ">>> students = ['dave', 'john', 'jane']\n" ">>> newgrades = {'john': 'F', 'jane':'A', 'dave': 'C'}\n" ">>> sorted(students, key=newgrades.__getitem__)\n" "['jane', 'dave', 'john']" msgstr "" ">>> students = ['dave', 'john', 'jane']\n" ">>> newgrades = {'john': 'F', 'jane':'A', 'dave': 'C'}\n" ">>> sorted(students, key=newgrades.__getitem__)\n" "['jane', 'dave', 'john']" msgid "Partial Sorts" msgstr "مرتب‌سازی‌های جزئی" msgid "Some applications require only some of the data to be ordered. The standard library provides several tools that do less work than a full sort:" msgstr "برخی کاربردها تنها نیاز دارند که بخشی از داده‌ها مرتب باشد. کتابخانه استاندارد چندین ابزار ارائه می‌دهد که کار کمتری نسبت به مرتب‌سازی کامل انجام می‌دهند:" msgid ":func:`min` and :func:`max` return the smallest and largest values, respectively. These functions make a single pass over the input data and require almost no auxiliary memory." msgstr ":func:`min` و :func:`max` به‌ترتیب کوچک‌ترین و بزرگ‌ترین مقادیر را برمی‌گردانند. این توابع یک پیمایش واحد روی داده‌های ورودی انجام می‌دهند و تقریباً به هیچ حافظه کمکی نیاز ندارند." msgid ":func:`heapq.nsmallest` and :func:`heapq.nlargest` return the *n* smallest and largest values, respectively. These functions make a single pass over the data keeping only *n* elements in memory at a time. For values of *n* that are small relative to the number of inputs, these functions make far fewer comparisons than a full sort." msgstr ":func:`heapq.nsmallest` و :func:`heapq.nlargest` به‌ترتیب *n* مقدار کوچک‌ترین و *n* مقدار بزرگ‌ترین را برمی‌گردانند. این توابع داده‌ها را در یک گذر واحد پیمایش می‌کنند و در هر لحظه فقط *n* عنصر را در حافظه نگه می‌دارند. برای مقادیر *n* که نسبت به تعداد ورودی‌ها کوچک هستند، این توابع مقایسه‌های بسیار کمتری نسبت به یک مرتب‌سازی کامل انجام می‌دهند." msgid ":func:`heapq.heappush` and :func:`heapq.heappop` create and maintain a partially sorted arrangement of data that keeps the smallest element at position ``0``. These functions are suitable for implementing priority queues which are commonly used for task scheduling." msgstr ":func:`heapq.heappush` و :func:`heapq.heappop` یک چیدمان تا حدی مرتب‌شده از داده‌ها ایجاد و نگهداری می‌کنند که کوچک‌ترین عنصر را در موقعیت ``0`` نگه می‌دارد. این توابع برای پیاده‌سازی صف‌های اولویتی که معمولاً برای زمان‌بندی وظایف استفاده می‌شوند، مناسب هستند." #~ msgid "Author" #~ msgstr "نویسنده" #~ msgid "Andrew Dalke and Raymond Hettinger" #~ msgstr "Andrew Dalke و Raymond Hettinger" |
| You are visitor 01402520 — GeezerVison does not store the pages you look up. Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required. |