hanfeijp
diff --git a/‎c-api/long.po
Lines changed: 79 additions & 40 deletions b/‎c-api/long.po
Lines changed: 79 additions & 40 deletions
@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.6\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2018-01-05 15:01+0000\n"
+"POT-Creation-Date: 2018-01-30 12:25+0900\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: cocoatomo, 2017\n"
 "Language-Team: Japanese (https://www.transifex.com/python-doc/teams/5390/ja/)\n"
@@ -27,38 +27,45 @@ msgid ""
 "All integers are implemented as \"long\" integer objects of arbitrary size."
 msgstr "すべての整数は任意の長さをもつ \"long\" 整数として実装されます。"
 
-#: ../../c-api/long.rst:15
+#: ../../c-api/long.rst:13
+msgid ""
+"On error, most ``PyLong_As*`` APIs return ``(return type)-1`` which cannot "
+"be distinguished from a number.  Use :c:func:`PyErr_Occurred` to "
+"disambiguate."
+msgstr ""
+
+#: ../../c-api/long.rst:18
 msgid "This subtype of :c:type:`PyObject` represents a Python integer object."
 msgstr "この :c:type:`PyObject` のサブタイプは整数型を表現します。"
 
-#: ../../c-api/long.rst:20
+#: ../../c-api/long.rst:23
 msgid ""
 "This instance of :c:type:`PyTypeObject` represents the Python integer type. "
 "This is the same object as :class:`int` in the Python layer."
 msgstr ""
 "この :c:type:`PyTypeObject` のインスタンスは Python 整数型を表現します。これは Python レイヤにおける "
 ":class:`int` と同じオブジェクトです。"
 
-#: ../../c-api/long.rst:26
+#: ../../c-api/long.rst:29
 msgid ""
 "Return true if its argument is a :c:type:`PyLongObject` or a subtype of "
 ":c:type:`PyLongObject`."
 msgstr "引数が :c:type:`PyLongObject` か :c:type:`PyLongObject` のサブタイプのときに真を返します。"
 
-#: ../../c-api/long.rst:32
+#: ../../c-api/long.rst:35
 msgid ""
 "Return true if its argument is a :c:type:`PyLongObject`, but not a subtype "
 "of :c:type:`PyLongObject`."
 msgstr ""
 "引数が :c:type:`PyLongObject` 型で、かつ :c:type:`PyLongObject` 型のサブタイプでないときに真を返します。"
 
-#: ../../c-api/long.rst:38
+#: ../../c-api/long.rst:41
 msgid ""
 "Return a new :c:type:`PyLongObject` object from *v*, or *NULL* on failure."
 msgstr ""
 "*v* から新たな :c:type:`PyLongObject` オブジェクトを生成して返します。失敗のときには *NULL* を返します。"
 
-#: ../../c-api/long.rst:40
+#: ../../c-api/long.rst:43
 msgid ""
 "The current implementation keeps an array of integer objects for all "
 "integers between ``-5`` and ``256``, when you create an int in that range "
@@ -70,54 +77,54 @@ msgstr ""
 "までの全ての整数に対する整数オブジェクトの配列を保持するようにしており、この範囲の数を生成すると、実際には既存のオブジェクトに対する参照が返るようになっています。従って、``1``"
 " の値を変えることすら可能です。変えてしまった場合の Python の挙動は未定義です :-)"
 
-#: ../../c-api/long.rst:49
+#: ../../c-api/long.rst:52
 msgid ""
 "Return a new :c:type:`PyLongObject` object from a C :c:type:`unsigned long`,"
 " or *NULL* on failure."
 msgstr ""
 "Cの :c:type:`unsigned long` から新たな :c:type:`PyLongObject` "
 "オブジェクトを生成して返します。失敗した際には *NULL* を返します。"
 
-#: ../../c-api/long.rst:55
+#: ../../c-api/long.rst:58
 msgid ""
 "Return a new :c:type:`PyLongObject` object from a C :c:type:`Py_ssize_t`, or"
 " *NULL* on failure."
 msgstr ""
 "C の :c:type:`Py_ssize_t` 型から新たな :c:type:`PyLongObject` オブジェクトを生成して返します。 "
 "失敗のときには *NULL* を返します。"
 
-#: ../../c-api/long.rst:61
+#: ../../c-api/long.rst:64
 msgid ""
 "Return a new :c:type:`PyLongObject` object from a C :c:type:`size_t`, or "
 "*NULL* on failure."
 msgstr ""
 "C の :c:type:`size_t` 型から新たな :c:type:`PyLongObject` オブジェクトを生成して返します。 失敗のときには "
 "*NULL* を返します。"
 
-#: ../../c-api/long.rst:67
+#: ../../c-api/long.rst:70
 msgid ""
 "Return a new :c:type:`PyLongObject` object from a C :c:type:`long long`, or "
 "*NULL* on failure."
 msgstr ""
 "C の :c:type:`long long` 型から新たな :c:type:`PyLongObject` "
 "オブジェクトを生成して返します。失敗のときには *NULL* を返します。"
 
-#: ../../c-api/long.rst:73
+#: ../../c-api/long.rst:76
 msgid ""
 "Return a new :c:type:`PyLongObject` object from a C :c:type:`unsigned long "
 "long`, or *NULL* on failure."
 msgstr ""
 "C の :c:type:`unsigned long long` 型から新たな :c:type:`PyLongObject` "
 "オブジェクトを生成して返します。失敗のときには *NULL* を返します。"
 
-#: ../../c-api/long.rst:79
+#: ../../c-api/long.rst:82
 msgid ""
 "Return a new :c:type:`PyLongObject` object from the integer part of *v*, or "
 "*NULL* on failure."
 msgstr ""
 "*v* の整数部から新たな :c:type:`PyLongObject` オブジェクトを生成して返します。失敗のときには *NULL* を返します。"
 
-#: ../../c-api/long.rst:85
+#: ../../c-api/long.rst:88
 msgid ""
 "Return a new :c:type:`PyLongObject` based on the string value in *str*, "
 "which is interpreted according to the radix in *base*.  If *pend* is "
@@ -137,7 +144,7 @@ msgstr ""
 "先頭の空白、基数の指定の後や数字の間にある単一のアンダースコアは無視されます。\n"
 "数字が全くない場合、 :exc:`ValueError` が送出されます。"
 
-#: ../../c-api/long.rst:98
+#: ../../c-api/long.rst:101
 msgid ""
 "Convert a sequence of Unicode digits to a Python integer value.  The Unicode"
 " string is first encoded to a byte string using "
@@ -148,7 +155,7 @@ msgstr ""
 ":c:func:`PyUnicode_EncodeDecimal` を用いてバイト文字列にエンコードされ、次に "
 ":c:func:`PyLong_FromString` を用いて変換されます。"
 
-#: ../../c-api/long.rst:104
+#: ../../c-api/long.rst:107
 msgid ""
 "Deprecated since version 3.3, will be removed in version 4.0: Part of the "
 "old-style Py_UNICODE API; please migrate to using "
@@ -157,15 +164,15 @@ msgstr ""
 "バージョン 3.3 で非推奨、バージョン 4.0 で削除予定: 古いスタイルの Py_UNICODE API の一部です; "
 "PyLong_FromUnicodeObject() を使用するように移行してください。"
 
-#: ../../c-api/long.rst:104
+#: ../../c-api/long.rst:107
 msgid ""
 "Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using "
 ":c:func:`PyLong_FromUnicodeObject`."
 msgstr ""
 "古いスタイルの :c:type:`Py_UNICODE` APIの一部です; :c:func:`PyLong_FromUnicodeObject` "
 "を使用するように移行してください。"
 
-#: ../../c-api/long.rst:109
+#: ../../c-api/long.rst:112
 msgid ""
 "Convert a sequence of Unicode digits in the string *u* to a Python integer "
 "value.  The Unicode string is first encoded to a byte string using "
@@ -176,15 +183,15 @@ msgstr ""
 ":c:func:`PyUnicode_EncodeDecimal` を用いてバイト文字列にエンコードされ、次に "
 ":c:func:`PyLong_FromString` を用いて変換されます。"
 
-#: ../../c-api/long.rst:119
+#: ../../c-api/long.rst:122
 msgid ""
 "Create a Python integer from the pointer *p*. The pointer value can be "
 "retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`."
 msgstr ""
 "ポインタ *p* から Python 整数値を生成します。ポインタの値は :c:func:`PyLong_AsVoidPtr` "
 "を適用した結果から取得されます。"
 
-#: ../../c-api/long.rst:130 ../../c-api/long.rst:140
+#: ../../c-api/long.rst:133 ../../c-api/long.rst:145
 msgid ""
 "Return a C :c:type:`long` representation of *obj*.  If *obj* is not an "
 "instance of :c:type:`PyLongObject`, first call its :meth:`__int__` method "
@@ -194,13 +201,19 @@ msgstr ""
 "のインスタンスでなければ、まず、その :meth:`__int__` メソッドを (もしあれば) 呼び出して、オブジェクトを "
 ":c:type:`PyLongObject` に変換します。"
 
-#: ../../c-api/long.rst:134 ../../c-api/long.rst:159
+#: ../../c-api/long.rst:137 ../../c-api/long.rst:166
 msgid ""
 "Raise :exc:`OverflowError` if the value of *obj* is out of range for a "
 ":c:type:`long`."
 msgstr "もし *obj* の値が :c:type:`long` の範囲外であれば、 :exc:`OverflowError` を送出します。"
 
-#: ../../c-api/long.rst:144
+#: ../../c-api/long.rst:140 ../../c-api/long.rst:154 ../../c-api/long.rst:169
+#: ../../c-api/long.rst:183 ../../c-api/long.rst:200 ../../c-api/long.rst:262
+#: ../../c-api/long.rst:274
+msgid "Returns -1 on error.  Use :c:func:`PyErr_Occurred` to disambiguate."
+msgstr ""
+
+#: ../../c-api/long.rst:149
 msgid ""
 "If the value of *obj* is greater than :const:`LONG_MAX` or less than "
 ":const:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and "
@@ -212,7 +225,7 @@ msgstr ""
 "*\\*overflow* は ``0`` に設定されます。もし、ほかの例外が発生した場合は *\\*overflow* が ``0`` に設定され "
 "``-1`` を返します。"
 
-#: ../../c-api/long.rst:155 ../../c-api/long.rst:165
+#: ../../c-api/long.rst:162 ../../c-api/long.rst:174
 msgid ""
 "Return a C :c:type:`long long` representation of *obj*.  If *obj* is not an "
 "instance of :c:type:`PyLongObject`, first call its :meth:`__int__` method "
@@ -222,7 +235,7 @@ msgstr ""
 "のインスタンスでなければ、まず、その :meth:`__int__` メソッドを (もしあれば) 呼び出して、オブジェクトを "
 ":c:type:`PyLongObject` に変換します。"
 
-#: ../../c-api/long.rst:169
+#: ../../c-api/long.rst:178
 msgid ""
 "If the value of *obj* is greater than :const:`PY_LLONG_MAX` or less than "
 ":const:`PY_LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, "
@@ -234,76 +247,94 @@ msgstr ""
 "*\\*overflow* は ``0`` に設定されます。もし、ほかの例外が発生した場合は *\\*overflow* が ``0`` に設定され "
 "``-1`` を返します。"
 
-#: ../../c-api/long.rst:183
+#: ../../c-api/long.rst:194
 msgid ""
 "Return a C :c:type:`Py_ssize_t` representation of *pylong*.  *pylong* must "
 "be an instance of :c:type:`PyLongObject`."
 msgstr ""
 "*pylong* を表す C の :c:type:`Py_ssize_t` を返します。 *pylong* は "
 ":c:type:`PyLongObject` のインスタンスでなければなりません。"
 
-#: ../../c-api/long.rst:186
+#: ../../c-api/long.rst:197
 msgid ""
 "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
 ":c:type:`Py_ssize_t`."
 msgstr ""
 "もし *pylong* の値が :c:type:`Py_ssize_t` の範囲外であれば、 :exc:`OverflowError` を送出します。"
 
-#: ../../c-api/long.rst:196
+#: ../../c-api/long.rst:209
 msgid ""
 "Return a C :c:type:`unsigned long` representation of *pylong*.  *pylong* "
 "must be an instance of :c:type:`PyLongObject`."
 msgstr ""
 "*pylong* を表す C の :c:type:`unsigned long` を返します。 *pylong* は "
 ":c:type:`PyLongObject` のインスタンスでなければなりません。"
 
-#: ../../c-api/long.rst:199
+#: ../../c-api/long.rst:212
 msgid ""
 "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
 ":c:type:`unsigned long`."
 msgstr ""
 "もし *pylong* の値が :c:type:`unsigned long` の範囲外であれば、 :exc:`OverflowError` "
 "を送出します。"
 
-#: ../../c-api/long.rst:205
+#: ../../c-api/long.rst:215
+msgid ""
+"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
+"disambiguate."
+msgstr ""
+
+#: ../../c-api/long.rst:225
 msgid ""
 "Return a C :c:type:`size_t` representation of *pylong*.  *pylong* must be an"
 " instance of :c:type:`PyLongObject`."
 msgstr ""
 "*pylong* を表す C の :c:type:`size_t` を返します。 *pylong* は :c:type:`PyLongObject` "
 "のインスタンスでなければなりません。"
 
-#: ../../c-api/long.rst:208
+#: ../../c-api/long.rst:228
 msgid ""
 "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
 ":c:type:`size_t`."
 msgstr ""
 "もし *pylong* の値が :c:type:`size_t` の範囲外であれば、 :exc:`OverflowError` を送出します。"
 
-#: ../../c-api/long.rst:217
+#: ../../c-api/long.rst:231
+msgid ""
+"Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to "
+"disambiguate."
+msgstr ""
+
+#: ../../c-api/long.rst:240
 msgid ""
 "Return a C :c:type:`unsigned long long` representation of *pylong*.  "
 "*pylong* must be an instance of :c:type:`PyLongObject`."
 msgstr ""
 "*pylong* を表す C の :c:type:`unsigned long long` を返します。 *pylong* は "
 ":c:type:`PyLongObject` のインスタンスでなければなりません。"
 
-#: ../../c-api/long.rst:220
+#: ../../c-api/long.rst:243
 msgid ""
 "Raise :exc:`OverflowError` if the value of *pylong* is out of range for an "
 ":c:type:`unsigned long long`."
 msgstr ""
 "もし *pylong* の値が :c:type:`unsigned long long` の範囲外であれば、 :exc:`OverflowError` "
 "を送出します。"
 
-#: ../../c-api/long.rst:223
+#: ../../c-api/long.rst:246
+msgid ""
+"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to"
+" disambiguate."
+msgstr ""
+
+#: ../../c-api/long.rst:249
 msgid ""
 "A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`."
 msgstr ""
 "負 *pylong* を指定した際に :exc:`TypeError` ではなく、 :exc:`OverflowError` "
 "を送出するようになりました。"
 
-#: ../../c-api/long.rst:229
+#: ../../c-api/long.rst:255
 msgid ""
 "Return a C :c:type:`unsigned long` representation of *obj*.  If *obj* is not"
 " an instance of :c:type:`PyLongObject`, first call its :meth:`__int__` "
@@ -313,15 +344,15 @@ msgstr ""
 ":c:type:`PyLongObject` のインスタンスでなければ、まず、その :meth:`__int__` メソッドを (もしあれば) "
 "呼び出して、オブジェクトを :c:type:`PyLongObject` に変換します。"
 
-#: ../../c-api/long.rst:233
+#: ../../c-api/long.rst:259
 msgid ""
 "If the value of *obj* is out of range for an :c:type:`unsigned long`, return"
 " the reduction of that value modulo ``ULONG_MAX + 1``."
 msgstr ""
 "*obj* の値が :c:type:`unsigned long` の範囲から外れていた場合は、 ``ULONG_MAX + 1`` "
 "を法とした剰余を返します。"
 
-#: ../../c-api/long.rst:239
+#: ../../c-api/long.rst:267
 msgid ""
 "Return a C :c:type:`unsigned long long` representation of *obj*.  If *obj* "
 "is not an instance of :c:type:`PyLongObject`, first call its :meth:`__int__`"
@@ -331,30 +362,34 @@ msgstr ""
 ":c:type:`PyLongObject` のインスタンスでなければ、まず、その :meth:`__int__` メソッドを (もしあれば) "
 "呼び出して、オブジェクトを :c:type:`PyLongObject` に変換します。"
 
-#: ../../c-api/long.rst:243
+#: ../../c-api/long.rst:271
 msgid ""
 "If the value of *obj* is out of range for an :c:type:`unsigned long long`, "
 "return the reduction of that value modulo ``PY_ULLONG_MAX + 1``."
 msgstr ""
 "*obj* の値が :c:type:`unsigned long long` の範囲から外れていた場合は、 ``PY_ULLONG_MAX + 1`` "
 "を法とした剰余を返します。"
 
-#: ../../c-api/long.rst:249
+#: ../../c-api/long.rst:279
 msgid ""
 "Return a C :c:type:`double` representation of *pylong*.  *pylong* must be an"
 " instance of :c:type:`PyLongObject`."
 msgstr ""
 "*pylong* を表す C の :c:type:`double` を返します。 *pylong* は :c:type:`PyLongObject` "
 "のインスタンスでなければなりません。"
 
-#: ../../c-api/long.rst:252
+#: ../../c-api/long.rst:282
 msgid ""
 "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
 ":c:type:`double`."
 msgstr ""
 "もし *pylong* の値が :c:type:`double` の範囲外であれば、 :exc:`OverflowError` を送出します。"
 
-#: ../../c-api/long.rst:258
+#: ../../c-api/long.rst:285
+msgid "Returns -1.0 on error.  Use :c:func:`PyErr_Occurred` to disambiguate."
+msgstr ""
+
+#: ../../c-api/long.rst:290
 msgid ""
 "Convert a Python integer *pylong* to a C :c:type:`void` pointer. If *pylong*"
 " cannot be converted, an :exc:`OverflowError` will be raised.  This is only "
@@ -364,3 +399,7 @@ msgstr ""
 "Python の整数型を指す *pylong* を、 C の :c:type:`void` ポインタに変換します。 *pylong* "
 "を変換できなければ、 :exc:`OverflowError` を送出します。この関数は :c:func:`PyLong_FromVoidPtr` "
 "で値を生成するときに使うような :c:type:`void` ポインタ型を生成できるだけです。"
+
+#: ../../c-api/long.rst:295
+msgid "Returns NULL on error.  Use :c:func:`PyErr_Occurred` to disambiguate."
+msgstr ""