feat: translate c-api/typehints

mattwang44 · mattwang44 · commit 3a91d7471749 · 2022-10-16T16:20:14.000+08:00
diff --git a/c-api/typehints.po b/c-api/typehints.po
@@ -1,33 +1,37 @@
-# SOME DESCRIPTIVE TITLE.
 # Copyright (C) 2001-2022, Python Software Foundation
 # This file is distributed under the same license as the Python package.
-# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
 #
-#, fuzzy
+# Translators:
+# Matt Wang <mattwang44@gmail.com>, 2022
+#
 msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.11\n"
 "Report-Msgid-Bugs-To: \n"
 "POT-Creation-Date: 2022-10-06 00:23+0000\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"PO-Revision-Date: 2022-10-16 16:16+0800\n"
+"Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
 "tw)\n"
 "Language: zh_TW\n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
+"X-Generator: Poedit 3.1.1\n"
 
 #: ../../c-api/typehints.rst:6
 msgid "Objects for Type Hinting"
-msgstr ""
+msgstr "型別提示物件"
 
 #: ../../c-api/typehints.rst:8
 msgid ""
 "Various built-in types for type hinting are provided.  Currently, two types "
 "exist -- :ref:`GenericAlias <types-genericalias>` and :ref:`Union <types-"
 "union>`.  Only ``GenericAlias`` is exposed to C."
 msgstr ""
+"提供了數個用於型別提示的內建型別。目前有兩種 -- :ref:`GenericAlias <types-"
+"genericalias>` 和 :ref:`Union <types-union>`。只有 ``GenericAlias`` 有公開 "
+"(expose) 給 C。"
 
 #: ../../c-api/typehints.rst:14
 msgid ""
@@ -43,17 +47,31 @@ msgid ""
 "lazily from ``__args__``.  On failure, an exception is raised and ``NULL`` "
 "is returned."
 msgstr ""
+"建立一個 :ref:`GenericAlias <types-genericalias>` 物件，等同於呼叫 Python "
+"的 :class:`types.GenericAlias` class。*origin* 和 *args* 引數分別設定了 "
+"`GenericAlias`` 的 ``__origin__`` 與 ``__args__`` 屬性。*origin* 應該要是個 :"
+"c:expr:`PyTypeObject*` 且 *args* 可以是個 :c:expr:`PyTupleObject*` 或任意 "
+"``PyObject*``。如果傳入的 *args* 不是個 tuple（元組），則會自動建立一個長度"
+"為 1 的 tuple 且 ``__args__`` 會被設為 ``(args,)``。只會進行最少的引數檢查，"
+"所以即便 *origin* 不是個型別，函式也會不會失敗。``GenericAlias`` 的 "
+"``__parameters__`` 屬性會自 ``__args__`` 惰性地建立 (constructed lazily)。當"
+"失敗時，會引發一個例外並回傳``NULL``。"
 
 #: ../../c-api/typehints.rst:28
 msgid "Here's an example of how to make an extension type generic::"
 msgstr ""
+"以下是個讓一個擴充型別泛用化 (generic) 的例子：\n"
+"\n"
+"::"
 
 #: ../../c-api/typehints.rst:38
 msgid "The data model method :meth:`__class_getitem__`."
-msgstr ""
+msgstr "資料模型方法 :meth:`__class_getitem__`。"
 
 #: ../../c-api/typehints.rst:44
 msgid ""
 "The C type of the object returned by :c:func:`Py_GenericAlias`. Equivalent "
 "to :class:`types.GenericAlias` in Python."
 msgstr ""
+":c:func:`Py_GenericAlias` 所回傳該物件的 C 型別。等價於 Python 中的 :class:"
+"`types.GenericAlias`。"
