sync with cpython d9dde70e

Author: github-actions[bot]

library/tempfile.po

@@ -8,7 +8,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.14\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2026-08-25 00:10+0000\n"
+"POT-Creation-Date: 2026-10-10 00:22+0000\n"
 "PO-Revision-Date: 2022-06-12 15:17+0800\n"
 "Last-Translator: Matt Wang <mattwang44@gmail.com>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -136,7 +136,7 @@ msgstr ""
 "在不是 Posix 或 Cygwin 的平臺上，TemporaryFile 是 NamedTemporaryFile 的別名。"
 
 #: ../../library/tempfile.rst:68 ../../library/tempfile.rst:137
-#: ../../library/tempfile.rst:266
+#: ../../library/tempfile.rst:275
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``tempfile.mkstemp`` with "
 "argument ``fullpath``."
@@ -388,23 +388,36 @@ msgstr ""
 "時所採取的操作似乎不常見，但它在除錯期間或當你需要基於其他邏輯的清理行為時會"
 "非常有用。"
 
-#: ../../library/tempfile.rst:210 ../../library/tempfile.rst:292
+#: ../../library/tempfile.rst:212
+msgid ""
+"Cleanup is not robust against the tree being modified while it is removed. "
+"Files outside of the tree may have their permissions and file flags reset."
+msgstr ""
+
+#: ../../library/tempfile.rst:215
+msgid ""
+"On systems where :data:`shutil.rmtree.avoids_symlink_attacks` is false, "
+"manipulating symbolic links during cleanup may cause files outside of the "
+"tree to be removed."
+msgstr ""
+
+#: ../../library/tempfile.rst:219 ../../library/tempfile.rst:301
 msgid ""
 "Raises an :ref:`auditing event <auditing>` ``tempfile.mkdtemp`` with "
 "argument ``fullpath``."
 msgstr ""
 "引發一個附帶引數 ``fullpath`` 的 ``tempfile.mkdtemp`` :ref:`稽核事件 "
 "<auditing>`。"
 
-#: ../../library/tempfile.rst:214
+#: ../../library/tempfile.rst:223
 msgid "Added *ignore_cleanup_errors* parameter."
 msgstr "新增 *ignore_cleanup_errors* 參數。"
 
-#: ../../library/tempfile.rst:217
+#: ../../library/tempfile.rst:226
 msgid "Added the *delete* parameter."
 msgstr "新增 *delete* 參數。"
 
-#: ../../library/tempfile.rst:223
+#: ../../library/tempfile.rst:232
 msgid ""
 "Creates a temporary file in the most secure manner possible.  There are no "
 "race conditions in the file's creation, assuming that the platform properly "
@@ -418,13 +431,13 @@ msgstr ""
 "況。該檔案只能由建立者讀寫，如果所在平臺用 permission bit（許可權位元）來表示"
 "檔案是否可執行，則沒有人有執行權。"
 
-#: ../../library/tempfile.rst:230
+#: ../../library/tempfile.rst:239
 msgid ""
 "The file descriptor is :ref:`not inherited by child processes "
 "<fd_inheritance>`."
 msgstr "檔案描述器\\ :ref:`不會被子行程繼承 <fd_inheritance>`。"
 
-#: ../../library/tempfile.rst:232
+#: ../../library/tempfile.rst:241
 #, fuzzy
 msgid ""
 "Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for "
@@ -434,7 +447,7 @@ msgstr ""
 "與 :func:`TemporaryFile` 不同，:func:`mkstemp` 使用者用完臨時檔案後需要自行將"
 "其刪除。"
 
-#: ../../library/tempfile.rst:236
+#: ../../library/tempfile.rst:245
 msgid ""
 "If *suffix* is not ``None``, the file name will end with that suffix, "
 "otherwise there will be no suffix.  :func:`mkstemp` does not put a dot "
@@ -445,7 +458,7 @@ msgstr ""
 "func:`mkstemp` 不會在檔名和後綴之間加點 (dot)，如果需要加一個點號，請將其放"
 "在 *suffix* 的開頭。"
 
-#: ../../library/tempfile.rst:241
+#: ../../library/tempfile.rst:250
 msgid ""
 "If *prefix* is not ``None``, the file name will begin with that prefix; "
 "otherwise, a default prefix is used.  The default is the return value of :"
@@ -455,7 +468,7 @@ msgstr ""
 "綴。預設前綴是 :func:`gettempprefix` 或 :func:`gettempprefixb` 函式的回傳值"
 "（自動呼叫合適的函式）。"
 
-#: ../../library/tempfile.rst:245
+#: ../../library/tempfile.rst:254
 msgid ""
 "If *dir* is not ``None``, the file will be created in that directory; "
 "otherwise, a default directory is used.  The default directory is chosen "
@@ -471,7 +484,7 @@ msgstr ""
 "檔案路徑是使用者友善的，比如透過 ``os.popen()`` 將路徑傳遞給外部命令時仍需要"
 "加引號 (quoting)。"
 
-#: ../../library/tempfile.rst:253
+#: ../../library/tempfile.rst:262
 msgid ""
 "If any of *suffix*, *prefix*, and *dir* are not ``None``, they must be the "
 "same type. If they are bytes, the returned name will be bytes instead of "
@@ -482,15 +495,15 @@ msgstr ""
 "型別相同。如果它們是位元組串，則回傳名稱的型別就是位元組串而非字串。如果不想"
 "遵循預設行為但又想要回傳值是位元組串型別，請傳入 ``suffix=b''``。"
 
-#: ../../library/tempfile.rst:259
+#: ../../library/tempfile.rst:268
 msgid ""
 "If *text* is specified and true, the file is opened in text mode. Otherwise, "
 "(the default) the file is opened in binary mode."
 msgstr ""
 "如果指定了 *text* 且為真值，檔案會以文字模式開啟。否則，檔案（預設）以二進位"
 "制模式開啟。"
 
-#: ../../library/tempfile.rst:262
+#: ../../library/tempfile.rst:271
 msgid ""
 ":func:`mkstemp` returns a tuple containing an OS-level handle to an open "
 "file (as would be returned by :func:`os.open`) and the absolute pathname of "
@@ -500,7 +513,7 @@ msgstr ""
 "level) 控制代碼，指向一個開啟的檔案（如同 :func:`os.open` 的回傳值），第二元"
 "素是該檔案的絕對路徑。"
 
-#: ../../library/tempfile.rst:268 ../../library/tempfile.rst:294
+#: ../../library/tempfile.rst:277 ../../library/tempfile.rst:303
 msgid ""
 "*suffix*, *prefix*, and *dir* may now be supplied in bytes in order to "
 "obtain a bytes return value.  Prior to this, only str was allowed. *suffix* "
@@ -511,11 +524,11 @@ msgstr ""
 "串型別的回傳值。在之前只允許使用字串。*suffix* 和 *prefix* 現在可以接受 "
 "``None``，並且預設為 ``None`` 以使用合適的預設值。"
 
-#: ../../library/tempfile.rst:274 ../../library/tempfile.rst:300
+#: ../../library/tempfile.rst:283 ../../library/tempfile.rst:309
 msgid "The *dir* parameter now accepts a :term:`path-like object`."
 msgstr "*dir* 參數現在可接受一個類路徑物件 (:term:`path-like object`)。"
 
-#: ../../library/tempfile.rst:280
+#: ../../library/tempfile.rst:289
 msgid ""
 "Creates a temporary directory in the most secure manner possible. There are "
 "no race conditions in the directory's creation.  The directory is readable, "
@@ -524,60 +537,60 @@ msgstr ""
 "盡可能以最安全的方式建立一個臨時目錄，建立該目錄時不會有 race condition 的情"
 "況，該目錄只能由建立者讀取、寫入和搜尋。"
 
-#: ../../library/tempfile.rst:284
+#: ../../library/tempfile.rst:293
 msgid ""
 "The user of :func:`mkdtemp` is responsible for deleting the temporary "
 "directory and its contents when done with it."
 msgstr ":func:`mkdtemp` 的使用者用完臨時目錄後需要自行將其刪除。"
 
-#: ../../library/tempfile.rst:287
+#: ../../library/tempfile.rst:296
 msgid ""
 "The *prefix*, *suffix*, and *dir* arguments are the same as for :func:"
 "`mkstemp`."
 msgstr ""
 "引數 *prefix*、*suffix* 和 *dir* 的含義與它們在 :func:`mkstemp` 中相同。"
 
-#: ../../library/tempfile.rst:290
+#: ../../library/tempfile.rst:299
 msgid ":func:`mkdtemp` returns the absolute pathname of the new directory."
 msgstr ":func:`mkdtemp` 回傳新目錄的絕對路徑名稱。"
 
-#: ../../library/tempfile.rst:303
+#: ../../library/tempfile.rst:312
 msgid ""
 ":func:`mkdtemp` now always returns an absolute path, even if *dir* is "
 "relative."
 msgstr ":func:`mkdtemp` 現在都會回傳絕對路徑，即使 *dir* 是相對路徑。"
 
-#: ../../library/tempfile.rst:309
+#: ../../library/tempfile.rst:318
 msgid ""
 "Return the name of the directory used for temporary files. This defines the "
 "default value for the *dir* argument to all functions in this module."
 msgstr ""
 "回傳儲存臨時檔案的目錄名稱。這設定了此 module 所有函式 *dir* 引數的預設值。"
 
-#: ../../library/tempfile.rst:313
+#: ../../library/tempfile.rst:322
 msgid ""
 "Python searches a standard list of directories to find one which the calling "
 "user can create files in.  The list is:"
 msgstr ""
 "Python 搜尋標準目錄列表來找到呼叫者可以在其中建立檔案的目錄。這個列表是："
 
-#: ../../library/tempfile.rst:316
+#: ../../library/tempfile.rst:325
 msgid "The directory named by the :envvar:`TMPDIR` environment variable."
 msgstr ":envvar:`TMPDIR` 環境變數指向的目錄。"
 
-#: ../../library/tempfile.rst:318
+#: ../../library/tempfile.rst:327
 msgid "The directory named by the :envvar:`TEMP` environment variable."
 msgstr ":envvar:`TEMP` 環境變數指向的目錄。"
 
-#: ../../library/tempfile.rst:320
+#: ../../library/tempfile.rst:329
 msgid "The directory named by the :envvar:`TMP` environment variable."
 msgstr ":envvar:`TMP` 環境變數指向的目錄。"
 
-#: ../../library/tempfile.rst:322
+#: ../../library/tempfile.rst:331
 msgid "A platform-specific location:"
 msgstr "與平臺相關的位置："
 
-#: ../../library/tempfile.rst:324
+#: ../../library/tempfile.rst:333
 #, fuzzy
 msgid ""
 "On Windows, the directories :file:`%USERPROFILE%\\\\AppData\\\\Local\\"
@@ -587,47 +600,47 @@ msgstr ""
 "在 Windows 上，目錄依次為 :file:`C:\\\\TEMP`、:file:`C:\\\\TMP`、:file:`\\"
 "\\TEMP` 和 :file:`\\\\TMP`。"
 
-#: ../../library/tempfile.rst:330
+#: ../../library/tempfile.rst:339
 msgid ""
 "On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, and :"
 "file:`/usr/tmp`, in that order."
 msgstr ""
 "在所有其他平臺上，目錄依次為 :file:`/tmp`、:file:`/var/tmp` 和 :file:`/usr/"
 "tmp`。"
 
-#: ../../library/tempfile.rst:333
+#: ../../library/tempfile.rst:342
 msgid "As a last resort, the current working directory."
 msgstr "不得已時，使用目前工作目錄。"
 
-#: ../../library/tempfile.rst:335
+#: ../../library/tempfile.rst:344
 msgid ""
 "The result of this search is cached, see the description of :data:`tempdir` "
 "below."
 msgstr "搜尋的結果會被 cache（快取）起來，請見下面 :data:`tempdir` 的描述。"
 
-#: ../../library/tempfile.rst:340
+#: ../../library/tempfile.rst:349
 msgid ""
 "Always returns a str.  Previously it would return any :data:`tempdir` value "
 "regardless of type so long as it was not ``None``."
 msgstr ""
 "回傳一個字串。在之前的版本中它會回傳任意 :data:`tempdir` 的值而不考慮它的型"
 "別，只要它不為 ``None``。"
 
-#: ../../library/tempfile.rst:345
+#: ../../library/tempfile.rst:354
 msgid "Same as :func:`gettempdir` but the return value is in bytes."
 msgstr "與 :func:`gettempdir` 相同，但回傳值為位元組串型別。"
 
-#: ../../library/tempfile.rst:351
+#: ../../library/tempfile.rst:360
 msgid ""
 "Return the filename prefix used to create temporary files.  This does not "
 "contain the directory component."
 msgstr "回傳用於建立臨時檔案的檔名前綴，它不包含目錄部分。"
 
-#: ../../library/tempfile.rst:356
+#: ../../library/tempfile.rst:365
 msgid "Same as :func:`gettempprefix` but the return value is in bytes."
 msgstr "與 :func:`gettempprefix` 相同，但回傳值為位元組串型別。"
 
-#: ../../library/tempfile.rst:360
+#: ../../library/tempfile.rst:369
 msgid ""
 "The module uses a global variable to store the name of the directory used "
 "for temporary files returned by :func:`gettempdir`.  It can be set directly "
@@ -641,7 +654,7 @@ msgstr ""
 "式都接受一個 *dir* 引數，它可被用於指定目錄。這是個推薦的做法，它不會透過改變"
 "全域性 API 行為而對其他不預期此行為的程式造成影響。"
 
-#: ../../library/tempfile.rst:369
+#: ../../library/tempfile.rst:378
 msgid ""
 "When set to a value other than ``None``, this variable defines the default "
 "value for the *dir* argument to the functions defined in this module, "
@@ -651,7 +664,7 @@ msgstr ""
 "預設值，包括確定其型別為位元組串還是字串。它不可以為 :term:`path-like "
 "object`。"
 
-#: ../../library/tempfile.rst:374
+#: ../../library/tempfile.rst:383
 msgid ""
 "If ``tempdir`` is ``None`` (the default) at any call to any of the above "
 "functions except :func:`gettempprefix` it is initialized following the "
@@ -660,7 +673,7 @@ msgstr ""
 "如果在呼叫除 :func:`gettempprefix` 外的上述任何函式時 ``tempdir`` 為 "
 "``None`` (預設值) 則它會按照 :func:`gettempdir` 中所描述的演算法來初始化。"
 
-#: ../../library/tempfile.rst:380
+#: ../../library/tempfile.rst:389
 msgid ""
 "Beware that if you set ``tempdir`` to a bytes value, there is a nasty side "
 "effect: The global default return type of :func:`mkstemp` and :func:"
@@ -674,16 +687,16 @@ msgstr ""
 "``prefix``、``suffix`` 或 ``dir`` 時被改為位元組串。請不要編寫預期此行為或依"
 "賴於此行為的程式。這個奇怪的行為是為了維持與以往實作版本的相容性。"
 
-#: ../../library/tempfile.rst:391
+#: ../../library/tempfile.rst:400
 msgid "Examples"
 msgstr "範例"
 
-#: ../../library/tempfile.rst:393
+#: ../../library/tempfile.rst:402
 msgid ""
 "Here are some examples of typical usage of the :mod:`!tempfile` module::"
 msgstr "以下是 :mod:`!tempfile` module 的一些常見用法範例： ::"
 
-#: ../../library/tempfile.rst:395
+#: ../../library/tempfile.rst:404
 msgid ""
 ">>> import tempfile\n"
 "\n"
@@ -765,11 +778,11 @@ msgstr ""
 ">>>\n"
 "# 目錄及其內容已被刪除"
 
-#: ../../library/tempfile.rst:438
+#: ../../library/tempfile.rst:447
 msgid "Deprecated functions and variables"
 msgstr "已棄用的函式和變數"
 
-#: ../../library/tempfile.rst:440
+#: ../../library/tempfile.rst:449
 msgid ""
 "A historical way to create temporary files was to first generate a file name "
 "with the :func:`mktemp` function and then create a file using this name. "
@@ -784,11 +797,11 @@ msgstr ""
 "之間的時間裡，其他程式可能會使用該名稱建立檔案。解決方案是將兩個步驟結合起"
 "來，並立即建立檔案。這個方案目前被 :func:`mkstemp` 和上述其他函式所採用。"
 
-#: ../../library/tempfile.rst:451
+#: ../../library/tempfile.rst:460
 msgid "Use :func:`mkstemp` instead."
 msgstr "使用 :func:`mkstemp` 代替。"
 
-#: ../../library/tempfile.rst:454
+#: ../../library/tempfile.rst:463
 msgid ""
 "Return an absolute pathname of a file that did not exist at the time the "
 "call is made.  The *prefix*, *suffix*, and *dir* arguments are similar to "
@@ -799,7 +812,7 @@ msgstr ""
 "與 :func:`mkstemp` 中所用的類似，除了在於不支援位元組串型別的檔名且不支援 "
 "``suffix=None`` 和 ``prefix=None``。"
 
-#: ../../library/tempfile.rst:461
+#: ../../library/tempfile.rst:470
 msgid ""
 "Use of this function may introduce a security hole in your program.  By the "
 "time you get around to doing anything with the file name it returns, someone "
@@ -811,7 +824,7 @@ msgstr ""
 "作時，可能有人已經捷足先登了。:func:`mktemp` 的功能可以很輕鬆地用帶有 "
 "``delete=False`` 參數的 :func:`NamedTemporaryFile` 代替： ::"
 
-#: ../../library/tempfile.rst:467
+#: ../../library/tempfile.rst:476
 msgid ""
 ">>> f = NamedTemporaryFile(delete=False)\n"
 ">>> f.name\n"