# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2020, 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.6\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-02-09 18:48+0900\n"
"PO-Revision-Date: 2018-06-29 17:47+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"

#: ../../c-api/dict.rst:6
msgid "Dictionary Objects"
msgstr "辞書オブジェクト (dictionary object)"

#: ../../c-api/dict.rst:13
msgid ""
"This subtype of :c:type:`PyObject` represents a Python dictionary object."
msgstr ""
"この :c:type:`PyObject` のサブタイプは Python の辞書オブジェクトを表現しま"
"す。"

#: ../../c-api/dict.rst:18
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python dictionary "
"type.  This is the same object as :class:`dict` in the Python layer."
msgstr ""
"この :c:type:`PyTypeObject` のインスタンスは Python の辞書を表現します。この"
"オブジェクトは、Python レイヤにおける :class:`dict` と同じオブジェクトです。"

#: ../../c-api/dict.rst:24
msgid ""
"Return true if *p* is a dict object or an instance of a subtype of the dict "
"type."
msgstr ""
"引数が辞書オブジェクトか辞書型のサブタイプのインスタンスの場合に真を返しま"
"す。"

#: ../../c-api/dict.rst:30
msgid ""
"Return true if *p* is a dict object, but not an instance of a subtype of the "
"dict type."
msgstr ""
"*p* が辞書オブジェクトであり、かつ辞書型のサブクラスのインスタンスでない場合"
"に真を返します。"

#: ../../c-api/dict.rst:36
msgid "Return a new empty dictionary, or *NULL* on failure."
msgstr "空の新たな辞書を返します。失敗すると *NULL* を返します。"

#: ../../c-api/dict.rst:41
msgid ""
"Return a :class:`types.MappingProxyType` object for a mapping which enforces "
"read-only behavior.  This is normally used to create a view to prevent "
"modification of the dictionary for non-dynamic class types."
msgstr ""
"あるマップ型オブジェクトに対して、読み出し専用に制限された :class:`types."
"MappingProxyType` オブジェクトを返します。通常、この関数は動的でないクラス型 "
"(non-dynamic class type) のクラス辞書が変更されないようにビューを作成するため"
"に使われます。"

#: ../../c-api/dict.rst:48
msgid "Empty an existing dictionary of all key-value pairs."
msgstr "現在辞書に入っている全てのキーと値のペアを除去して空にします。"

#: ../../c-api/dict.rst:53
msgid ""
"Determine if dictionary *p* contains *key*.  If an item in *p* is matches "
"*key*, return ``1``, otherwise return ``0``.  On error, return ``-1``. This "
"is equivalent to the Python expression ``key in p``."
msgstr ""
"辞書 *p* に *key* が入っているか判定します。*p* の要素が *key* に一致した場合"
"は ``1`` を返し、それ以外の場合には ``0`` を返します。エラーの場合 ``-1`` を"
"返します。この関数は Python の式 ``key in p`` と等価です。"

#: ../../c-api/dict.rst:60
msgid "Return a new dictionary that contains the same key-value pairs as *p*."
msgstr "*p* と同じキーと値のペアが入った新たな辞書を返します。"

#: ../../c-api/dict.rst:65
msgid ""
"Insert *value* into the dictionary *p* with a key of *key*.  *key* must be :"
"term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` "
"on success or ``-1`` on failure."
msgstr ""
"辞書 *p* に、 *key* をキーとして値 *value* を挿入します。 *key* はハッシュ可"
"能(:term:`hashable`)でなければなりません; ハッシュ可能でない場合、 :exc:"
"`TypeError` を送出します。成功した場合には ``0`` を、失敗した場合には ``-1`` "
"を返します。"

#: ../../c-api/dict.rst:74
msgid ""
"Insert *value* into the dictionary *p* using *key* as a key. *key* should be "
"a :c:type:`char\\*`.  The key object is created using "
"``PyUnicode_FromString(key)``.  Return ``0`` on success or ``-1`` on failure."
msgstr ""
"辞書 *p* に、 *key* をキーとして値 *value* を挿入します。 *key* は :c:type:"
"`char\\*` 型でなければなりません。キーオブジェクトは "
"``PyUnicode_FromString(key)`` で生成されます。成功した場合には ``0`` を、失敗"
"した場合には ``-1`` を返します。"

#: ../../c-api/dict.rst:82
msgid ""
"Remove the entry in dictionary *p* with key *key*. *key* must be hashable; "
"if it isn't, :exc:`TypeError` is raised.  Return ``0`` on success or ``-1`` "
"on failure."
msgstr ""
"辞書 *p* から *key* をキーとするエントリを除去します。 *key* はハッシュ可能で"
"なければなりません;  ハッシュ可能でない場合、 :exc:`TypeError` を送出します。"
"成功した場合には ``0`` を、失敗した場合には ``-1`` を返します。"

#: ../../c-api/dict.rst:89
msgid ""
"Remove the entry in dictionary *p* which has a key specified by the string "
"*key*.  Return ``0`` on success or ``-1`` on failure."
msgstr ""
"辞書 *p* から文字列 *key* をキーとするエントリを除去します。成功した場合には "
"``0`` を、失敗した場合には ``-1`` を返します。"

#: ../../c-api/dict.rst:95
msgid ""
"Return the object from dictionary *p* which has a key *key*.  Return *NULL* "
"if the key *key* is not present, but *without* setting an exception."
msgstr ""
"辞書 *p* 内で *key* をキーとするオブジェクトを返します。キー *key* が存在しな"
"い場合には *NULL* を返しますが、例外をセット *しません*。"

#: ../../c-api/dict.rst:98
msgid ""
"Note that exceptions which occur while calling :meth:`__hash__` and :meth:"
"`__eq__` methods will get suppressed. To get error reporting use :c:func:"
"`PyDict_GetItemWithError()` instead."
msgstr ""
":meth:`__hash__` メソッドや :meth:`__eq__` メソッドの呼び出し中に起こる例外は"
"抑制されることに注意してください。\n"
"エラーを報告させるには、代わりに :c:func:`PyDict_GetItemWithError()` を使って"
"ください。"

#: ../../c-api/dict.rst:105
msgid ""
"Variant of :c:func:`PyDict_GetItem` that does not suppress exceptions. "
"Return *NULL* **with** an exception set if an exception occurred.  Return "
"*NULL* **without** an exception set if the key wasn't present."
msgstr ""
":c:func:`PyDict_GetItem` の変種で例外を隠しません。例外が発生した場合は、例外"
"をセット **した上で** *NULL* を返します。キーが存在しなかった場合は、例外を"
"セット **せずに** *NULL* を返します。"

#: ../../c-api/dict.rst:113
msgid ""
"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:"
"type:`char\\*`, rather than a :c:type:`PyObject\\*`."
msgstr ""
":c:func:`PyDict_GetItem` と同じですが、 *key* は :c:type:`PyObject\\*` ではな"
"く :c:type:`char\\*` で指定します。"

#: ../../c-api/dict.rst:116
msgid ""
"Note that exceptions which occur while calling :meth:`__hash__` and :meth:"
"`__eq__` methods and creating a temporary string object will get suppressed. "
"To get error reporting use :c:func:`PyDict_GetItemWithError()` instead."
msgstr ""
":meth:`__hash__` メソッドや :meth:`__eq__` メソッドの呼び出し中や、一時的な文"
"字列オブジェクトの作成中に起こる例外は抑制されることに注意してください。\n"
"エラーを報告させるには、代わりに :c:func:`PyDict_GetItemWithError()` を使って"
"ください。"

#: ../../c-api/dict.rst:124
msgid ""
"This is the same as the Python-level :meth:`dict.setdefault`.  If present, "
"it returns the value corresponding to *key* from the dictionary *p*.  If the "
"key is not in the dict, it is inserted with value *defaultobj* and "
"*defaultobj* is returned.  This function evaluates the hash function of "
"*key* only once, instead of evaluating it independently for the lookup and "
"the insertion."
msgstr ""
"これは Python レベルの :meth:`dict.setdefault` と同じです。\n"
"もしあれば、辞書 *p* から *key* に対応する値を返します。\n"
"キーが辞書になければ、値 *defaultobj* を挿入し *defaultobj* を返します。\n"
"この関数は、 *key* のハッシュ値を検索と挿入ごとに別々に評価するのではなく、一"
"度だけしか評価しません。"

#: ../../c-api/dict.rst:134
msgid ""
"Return a :c:type:`PyListObject` containing all the items from the dictionary."
msgstr "辞書内の全ての要素対が入った :c:type:`PyListObject` を返します。"

#: ../../c-api/dict.rst:139
msgid ""
"Return a :c:type:`PyListObject` containing all the keys from the dictionary."
msgstr "辞書内の全てのキーが入った :c:type:`PyListObject` を返します。"

#: ../../c-api/dict.rst:144
msgid ""
"Return a :c:type:`PyListObject` containing all the values from the "
"dictionary *p*."
msgstr "辞書 *p* 内の全ての値が入った :c:type:`PyListObject` を返します。"

#: ../../c-api/dict.rst:152
msgid ""
"Return the number of items in the dictionary.  This is equivalent to "
"``len(p)`` on a dictionary."
msgstr ""
"辞書内の要素の数を返します。辞書に対して ``len(p)`` を実行するのと同じです。"

#: ../../c-api/dict.rst:158
msgid ""
"Iterate over all key-value pairs in the dictionary *p*.  The :c:type:"
"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the "
"first call to this function to start the iteration; the function returns "
"true for each pair in the dictionary, and false once all pairs have been "
"reported.  The parameters *pkey* and *pvalue* should either point to :c:type:"
"`PyObject\\*` variables that will be filled in with each key and value, "
"respectively, or may be *NULL*.  Any references returned through them are "
"borrowed.  *ppos* should not be altered during iteration. Its value "
"represents offsets within the internal dictionary structure, and since the "
"structure is sparse, the offsets are not consecutive."
msgstr ""
"辞書 *p* 内の全てのキー/値のペアにわたる反復処理を行います。 *ppos* が参照し"
"ている :c:type:`Py_ssize_t` 型は、この関数で反復処理を開始する際に、最初に関"
"数を呼び出すよりも前に ``0`` に初期化しておかなければなりません; この関数は辞"
"書内の各ペアを取り上げるごとに真を返し、全てのペアを取り上げたことが分かると"
"偽を返します。パラメーター *pkey* および *pvalue* には、それぞれ辞書の各々の"
"キーと値が埋められた :c:type:`PyObject\\*` 変数を指すポインタか、または "
"*NULL* が入ります。この関数から返される参照はすべて借用参照になります。反復処"
"理中に *ppos* を変更してはなりません。この値は内部的な辞書構造体のオフセット"
"を表現しており、構造体はスパースなので、オフセットの値に一貫性がないためで"
"す。"

#: ../../c-api/dict.rst:169
msgid "For example::"
msgstr "例えば::"

#: ../../c-api/dict.rst:179
msgid ""
"The dictionary *p* should not be mutated during iteration.  It is safe to "
"modify the values of the keys as you iterate over the dictionary, but only "
"so long as the set of keys does not change.  For example::"
msgstr ""
"反復処理中に辞書 *p* を変更してはなりません。辞書を反復処理する際に、キーに対"
"応する値を変更しても大丈夫になりましたが、キーの集合を変更しないことが前提で"
"す。以下に例を示します::"

#: ../../c-api/dict.rst:204
msgid ""
"Iterate over mapping object *b* adding key-value pairs to dictionary *a*. "
"*b* may be a dictionary, or any object supporting :c:func:`PyMapping_Keys` "
"and :c:func:`PyObject_GetItem`. If *override* is true, existing pairs in *a* "
"will be replaced if a matching key is found in *b*, otherwise pairs will "
"only be added if there is not a matching key in *a*. Return ``0`` on success "
"or ``-1`` if an exception was raised."
msgstr ""
"マップ型オブジェクト *b* の全ての要素にわたって、反復的にキー/値のペアを辞書 "
"*a* に追加します。 *b* は辞書か、 :c:func:`PyMapping_Keys` または :c:func:"
"`PyObject_GetItem` をサポートする何らかのオブジェクトにできます。 *override* "
"が真ならば、 *a* のキーと一致するキーが *b* にある際に、既存のペアを置き換え"
"ます。それ以外の場合は、 *b* のキーに一致するキーが *a* にないときのみ追加を"
"行います。成功した場合には ``0`` を返し、例外が送出された場合には ``-1`` を返"
"します。"

#: ../../c-api/dict.rst:214
msgid ""
"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a."
"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back "
"to the iterating over a sequence of key value pairs if the second argument "
"has no \"keys\" attribute.  Return ``0`` on success or ``-1`` if an "
"exception was raised."
msgstr ""
"C で表せば ``PyDict_Merge(a, b, 1)`` と同じで、また Python の ``a."
"update(b)`` と似ていますが、 :c:func:`PyDict_Update` は第二引数が \"keys\" 属"
"性を持たない場合にキー/値ペアのシーケンスを反復することはありません。成功した"
"場合には ``0`` を返し、例外が送出された場合には ``-1`` を返します。"

#: ../../c-api/dict.rst:223
msgid ""
"Update or merge into dictionary *a*, from the key-value pairs in *seq2*. "
"*seq2* must be an iterable object producing iterable objects of length 2, "
"viewed as key-value pairs.  In case of duplicate keys, the last wins if "
"*override* is true, else the first wins. Return ``0`` on success or ``-1`` "
"if an exception was raised. Equivalent Python (except for the return value)::"
msgstr ""
"*seq2* 内のキー/値ペアを使って、辞書 *a* の内容を更新したり統合したりします。"
"*seq2* は、キー/値のペアとみなせる長さ 2 の反復可能オブジェクト(iterable "
"object) を生成する反復可能オブジェクトでなければなりません。重複するキーが存"
"在する場合、*override* が真ならば先に出現したキーを使い、そうでない場合は後に"
"出現したキーを使います。成功した場合には ``0`` を返し、例外が送出された場合に"
"は ``-1`` を返します。(戻り値以外は) 等価な Python コードを書くと、以下のよう"
"になります::"

#: ../../c-api/dict.rst:238
msgid "Clear the free list. Return the total number of freed items."
msgstr "free list をクリアします。解放された要素数を返します。"