sorting.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2021, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# tomo, 2020
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2021-01-01 16:06+0000\n"
"PO-Revision-Date: 2020-05-30 11:55+0000\n"
"Last-Translator: tomo, 2020\n"
"Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/"
"ja/)\n"
"Language: ja\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../howto/sorting.rst:4
msgid "Sorting HOW TO"
msgstr "ソート HOW TO"

#: ../../howto/sorting.rst:0
msgid "Author"
msgstr "著者"

#: ../../howto/sorting.rst:6
msgid "Andrew Dalke and Raymond Hettinger"
msgstr "Andrew Dalke and Raymond Hettinger"

#: ../../howto/sorting.rst:0
msgid "Release"
msgstr "リリース"

#: ../../howto/sorting.rst:7
msgid "0.1"
msgstr "0.1"

#: ../../howto/sorting.rst:10
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 ""
"Python のリストにはリストをインプレースに変更する、組み込みメソッド :meth:"
"`list.sort` があります。他にもイテラブルからソートしたリストを作成する組み込"
"み関数 :func:`sorted` があります。"

#: ../../howto/sorting.rst:14
msgid ""
"In this document, we explore the various techniques for sorting data using "
"Python."
msgstr ""
"このドキュメントでは Python を使った様々なソートのテクニックを探索します。"

#: ../../howto/sorting.rst:18
msgid "Sorting Basics"
msgstr "ソートの基本"

#: ../../howto/sorting.rst:20
msgid ""
"A simple ascending sort is very easy: just call the :func:`sorted` function. "
"It returns a new sorted list::"
msgstr ""
"単純な昇順のソートはとても簡単です: :func:`sorted` 関数を呼ぶだけです。そうす"
"れば、新たにソートされたリストが返されます::"

#: ../../howto/sorting.rst:26
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` メソッドを呼びだしても同じことができます。この方法はリスト"
"をインプレースに変更します (そして sorted との混乱を避けるため ``None`` を返"
"します)。多くの場合、こちらの方法は :func:`sorted` と比べると不便です - ただ"
"し、元々のリストが不要な場合には、わずかですがより効率的です。"

#: ../../howto/sorting.rst:36
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` 関数は任意のイテラブルを受け付けます。"

#: ../../howto/sorting.rst:43
msgid "Key Functions"
msgstr "Key 関数"

#: ../../howto/sorting.rst:45
msgid ""
"Both :meth:`list.sort` and :func:`sorted` have a *key* parameter to specify "
"a function to be called on each list element prior to making comparisons."
msgstr ""
":meth:`list.sort` と :func:`sorted` には *key* パラメータがあります。 これは"
"比較を行う前にリストの各要素に対して呼び出される関数を指定するパラメータで"
"す。"

#: ../../howto/sorting.rst:48
msgid "For example, here's a case-insensitive string comparison:"
msgstr "例えば、大文字小文字を区別しない文字列比較の例:"

#: ../../howto/sorting.rst:53
msgid ""
"The value of the *key* parameter should be a function 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* パラメータは単一の引数をとり、ソートに利用される key を返さなければいけ"
"ません。この制約によりソートを高速に行えます、キー関数は各入力レコードに対し"
"てきっちり一回だけ呼び出されるからです。"

#: ../../howto/sorting.rst:57
msgid ""
"A common pattern is to sort complex objects using some of the object's "
"indices as keys. For example:"
msgstr ""
"よくある利用パターンはいくつかの要素から成る対象をインデクスのどれかをキーと"
"してソートすることです。例えば:"

#: ../../howto/sorting.rst:68
msgid ""
"The same technique works for objects with named attributes. For example:"
msgstr ""
"同じテクニックは名前づけされた属性 (named attributes) を使うことでオブジェク"
"トに対しても動作します。例えば:"

#: ../../howto/sorting.rst:87
msgid "Operator Module Functions"
msgstr "operator モジュール関数"

#: ../../howto/sorting.rst:89
msgid ""
"The 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 ""
"上述した key 関数のパターンはとても一般的です、 そのため、Python は高速で扱い"
"やすいアクセサ関数を提供しています。 :mod:`operator` モジュールには :func:"
"`~operator.itemgetter`, :func:`~operator.attrgetter` そして :func:`~operator."
"methodcaller` 関数があります。"

#: ../../howto/sorting.rst:94
msgid "Using those functions, the above examples become simpler and faster:"
msgstr "これらの関数を利用すると、上の例はもっと簡単で高速になります:"

#: ../../howto/sorting.rst:104
msgid ""
"The operator module functions allow multiple levels of sorting. For example, "
"to sort by *grade* then by *age*:"
msgstr ""
"operator モジュールの関数は複数の段階でのソートを可能にします。例えば、 "
"*grade* でソートしてさらに *age* でソートする場合:"

#: ../../howto/sorting.rst:114
msgid "Ascending and Descending"
msgstr "昇順と降順"

#: ../../howto/sorting.rst:116
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* パラメータを 真偽値"
"として受け付けます。このパラメータは降順ソートを行うかどうかの フラグとして利"
"用されます。 例えば、学生のデータを *age* の逆順で得たい場合:"

#: ../../howto/sorting.rst:127
msgid "Sort Stability and Complex Sorts"
msgstr "ソートの安定性と複合的なソート"

#: ../../howto/sorting.rst:129
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 ""
"ソートは、 `安定 (stable) <https://en.wikipedia.org/wiki/"
"Sorting_algorithm#Stability>`_ であることが保証されています。これはレコードの"
"中に同じキーがある場合、元々の順序が維持されるということを意味します。"

#: ../../howto/sorting.rst:137
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)`` の前にあること注意してください。"

#: ../../howto/sorting.rst:140
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 ""
"この素晴しい性質によって複数のソートを段階的に組み合わせることができます。例"
"えば、学生データを *grade* の降順にソートし、さらに *age* の昇順にソートした"
"い場合には、まず *age* でソートし、次に *grade* でもう一度ソートします:"

#: ../../howto/sorting.rst:148
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 ""
"この処理は、リストおよびフィールド名とソート順序のタプルを複数受け取れるラッ"
"パー関数へ抽象化できます。"

#: ../../howto/sorting.rst:159
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 ""
"Python では `Timsort <https://en.wikipedia.org/wiki/Timsort>`_ アルゴリズムが"
"利用されていて、効率良く複数のソートを行うことができます、これは現在のデータ"
"セット中のあらゆる順序をそのまま利用できるからです。"

#: ../../howto/sorting.rst:164
msgid "The Old Way Using Decorate-Sort-Undecorate"
msgstr "デコレート-ソート-アンデコレートを利用した古いやり方"

#: ../../howto/sorting.rst:166
msgid "This idiom is called Decorate-Sort-Undecorate after its three steps:"
msgstr ""
"このイディオムは以下の3つのステップにちなんでデコレート-ソート-アンデコレー"
"ト (Decorate-Sort-Undecorate) と呼ばれています:"

#: ../../howto/sorting.rst:168
msgid ""
"First, the initial list is decorated with new values that control the sort "
"order."
msgstr ""
"まず、元となるリストをソートしたい順序を制御する新しい値でデコレートします。"

#: ../../howto/sorting.rst:170
msgid "Second, the decorated list is sorted."
msgstr "次に、デコレートしたリストをソートします。"

#: ../../howto/sorting.rst:172
msgid ""
"Finally, the decorations are removed, creating a list that contains only the "
"initial values in the new order."
msgstr ""
"最後に、デコレートを取り除き、新しい順序で元々の値のみを持つリストを作りま"
"す。"

#: ../../howto/sorting.rst:175
msgid ""
"For example, to sort the student data by *grade* using the DSU approach:"
msgstr "例えば、DSU アプローチを利用して学生データを *grade* でソートする場合:"

#: ../../howto/sorting.rst:182
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 ""
"このイディオムはタブルが辞書編集的に比較されるため正しく動作します; 最初の要"
"素が比較され、同じ場合には第二の要素が比較され、以下も同様に動きます。"

#: ../../howto/sorting.rst:186
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* は全ての場合で含まれる必要はありません"
"が、そうすることで二つの利点があります:"

#: ../../howto/sorting.rst:189
msgid ""
"The sort is stable -- if two items have the same key, their order will be "
"preserved in the sorted list."
msgstr ""
"ソートが安定になります -- もし二つの要素が同じキーを持つ場合、それらの順序が"
"ソートされたリストでも維持されます。"

#: ../../howto/sorting.rst:192
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 ""
"元々の要素が比較可能な要素を持つとは限りません、なぜならデコレートされたタブ"
"ルの順序は多くの場合、最初の二つの要素で決定されるからです。例として元のリス"
"トは直接比較できない複素数を含むことができます。"

#: ../../howto/sorting.rst:197
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>`_ があります。これは Perl プログラマの間で有名な "
"Randal L. Schwartz にちなんでいます。"

#: ../../howto/sorting.rst:201
msgid ""
"Now that Python sorting provides key-functions, this technique is not often "
"needed."
msgstr ""
"いまや Python のソートは key 関数による方法を提供しているので、このテクニック"
"は不要でしょう。"

#: ../../howto/sorting.rst:205
msgid "The Old Way Using the *cmp* Parameter"
msgstr "*cmp* パラメータを利用した古い方法"

#: ../../howto/sorting.rst:207
msgid ""
"Many constructs given in this HOWTO assume Python 2.4 or later. Before that, "
"there was no :func:`sorted` builtin and :meth:`list.sort` took no keyword "
"arguments. Instead, all of the Py2.x versions supported a *cmp* parameter to "
"handle user specified comparison functions."
msgstr ""
"この HOWTO の内容の多くは Python 2.4 以降を仮定しています。それ以前では組み込"
"み関数 :func:`sorted` と :meth:`list.sort` はキーワード引数をとりませんでし"
"た。その代わりに Py2.x バージョンの全ては、ユーザが比較関数を指定するための "
"*cmp* パラメータをサポートしました。"

#: ../../howto/sorting.rst:212
msgid ""
"In Py3.0, the *cmp* parameter was removed entirely (as part of a larger "
"effort to simplify and unify the language, eliminating the conflict between "
"rich comparisons and the :meth:`__cmp__` magic method)."
msgstr ""
"Py3.0 では *cmp* パラメータは完全に削除されました (ぜいたくな比較と :meth:"
"`__cmp__` マジックメソッドの衝突を除き、言語を単純化しまとめるための多大な労"
"力の一環として)。"

#: ../../howto/sorting.rst:216
msgid ""
"In Py2.x, sort allowed an optional function which can be called for doing "
"the comparisons. That function should take two arguments to be compared and "
"then return a negative value for less-than, return zero if they are equal, "
"or return a positive value for greater-than. For example, we can do:"
msgstr ""
"Py2.x ではソートにオプションとして比較に利用できる関数を与えることができま"
"す。関数は比較される二つの引数をとり、小さい場合には負の値を、等しい場合には "
"0 を、大きい場合には正の値を返さなければいけません。例えば、以下のようにでき"
"ます:"

#: ../../howto/sorting.rst:226
msgid "Or you can reverse the order of comparison with:"
msgstr "また、比較順を逆にすることもできます:"

#: ../../howto/sorting.rst:233
msgid ""
"When porting code from Python 2.x to 3.x, the situation can arise when you "
"have the user supplying a comparison function and you need to convert that "
"to a key function. The following wrapper makes that easy to do::"
msgstr ""
"Python 2.x から 3.x にコードを移植する場合、比較関数を持っている場合には key "
"関数に比較しなければならないような状況に陥るかもしれません。以下のラッパーが"
"それを簡単にしてくれるでしょう::"

#: ../../howto/sorting.rst:256
msgid "To convert to a key function, just wrap the old comparison function:"
msgstr "key 関数を変換するには、古い比較関数をラップするだけです:"

#: ../../howto/sorting.rst:267
msgid ""
"In Python 3.2, the :func:`functools.cmp_to_key` function was added to the :"
"mod:`functools` module in the standard library."
msgstr ""
"Python 3.2 には、標準ライブラリの :mod:`functools` モジュールに :func:"
"`functools.cmp_to_key` 関数が追加されました。"

#: ../../howto/sorting.rst:271
msgid "Odd and Ends"
msgstr "残りいくつかとまとめ"

#: ../../howto/sorting.rst:273
msgid ""
"For locale aware sorting, use :func:`locale.strxfrm` for a key function or :"
"func:`locale.strcoll` for a comparison function."
msgstr ""
"ロケールに配慮したソートをするには、キー関数 :func:`locale.strxfrm` を利用す"
"るか、比較関数に :func:`locale.strcoll` を利用します。"

#: ../../howto/sorting.rst:276
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` 関数を二回使うことで模倣することができます:"

#: ../../howto/sorting.rst:288
msgid ""
"The sort routines are guaranteed to use :meth:`__lt__` when making "
"comparisons between two objects. So, it is easy to add a standard sort order "
"to a class by defining an :meth:`__lt__` method::"
msgstr ""
"ソートルーチンは二つのオブジェクトを比較するのに :meth:`__lt__` を利用するこ"
"とを保証しています。そのため :meth:`__lt__` メソッドを定義することで、標準の"
"ソート順序を追加できます::"

#: ../../howto/sorting.rst:296
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 ""
"key 関数はソートするオブジェクトに依存する必要はありません。 key 関数は外部リ"
"ソースにアクセスすることもできます。例えば学生の成績が辞書に保存されている場"
"合、それを利用して別の学生の名前のリストをソートすることができます:"