Deploy preview for PR 1148 🛫

Author: pydoc-zh-tw[bot]

pr-preview/pr-1148/_sources/tutorial/datastructures.rst.txt

@@ -512,8 +512,12 @@ dictionary; this is also the way dictionaries are written on output.
 The main operations on a dictionary are storing a value with some key and
 extracting the value given the key.  It is also possible to delete a key:value
 pair with ``del``. If you store using a key that is already in use, the old
-value associated with that key is forgotten.  It is an error to extract a value
-using a non-existent key.
+value associated with that key is forgotten.
+
+Extracting a value for a non-existent key by subscripting (``d[key]``) raises a
+:exc:`KeyError`. To avoid getting this error when trying to access a possibly
+non-existent key, use the :meth:`~dict.get` method instead, which returns
+``None`` (or a specified default value) if the key is not in the dictionary.
 
 Performing ``list(d)`` on a dictionary returns a list of all the keys
 used in the dictionary, in insertion order (if you want it sorted, just use
@@ -528,6 +532,12 @@ Here is a small example using a dictionary::
    {'jack': 4098, 'sape': 4139, 'guido': 4127}
    >>> tel['jack']
    4098
+   >>> tel['irv']
+   Traceback (most recent call last):
+     File "<stdin>", line 1, in <module>
+   KeyError: 'irv'
+   >>> print(tel.get('irv'))
+   None
    >>> del tel['sape']
    >>> tel['irv'] = 4127
    >>> tel

pr-preview/pr-1148/_sources/whatsnew/3.14.rst.txt

@@ -937,6 +937,19 @@ The compiler now emits a :exc:`SyntaxWarning` when a :keyword:`return`,
 leaving a :keyword:`finally` block.
 This change is specified in :pep:`765`.
 
+In situations where this change is inconvenient (such as those where the
+warnings are redundant due to code linting), the :ref:`warning filter
+<warning-filter>` can be used to turn off all syntax warnings by adding
+``ignore::SyntaxWarning`` as a filter. This can be specified in combination
+with a filter that converts other warnings to errors (for example, passing
+``-Werror -Wignore::SyntaxWarning`` as CLI options, or setting
+``PYTHONWARNINGS=error,ignore::SyntaxWarning``).
+
+Note that applying such a filter at runtime using the :mod:`warnings` module
+will only suppress the warning in code that is compiled *after* the filter is
+adjusted. Code that is compiled prior to the filter adjustment (for example,
+when a module is imported) will still emit the syntax warning.
+
 (Contributed by Irit Katriel in :gh:`130080`.)
 
 

pr-preview/pr-1148/about.html

@@ -314,7 +314,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/bugs.html

@@ -230,7 +230,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
 </section>
 <section id="getting-started-contributing-to-python-yourself">
 <span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭">¶</a></h2>
-<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://devguide.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
+<p>除了只是回報你所發現的錯誤之外，同樣也歡迎你提交修正它們的修補程式 (patch)。你可以在 <a class="reference external" href="https://devguide.python.org/">Python 開發者指南</a>中找到如何開始修補 Python 的更多資訊。如果你有任何問題，<a class="reference external" href="https://mail.python.org/mailman3/lists/core-mentorship.python.org/">核心導師郵寄清單</a>是一個友善的地方，你可以在那裡得到，關於 Python 修正錯誤的過程中，所有問題的答案。</p>
 </section>
 </section>
 
@@ -352,7 +352,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/abstract.html

@@ -323,7 +323,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/allocation.html

@@ -432,7 +432,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/apiabiversion.html

@@ -471,7 +471,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/arg.html

@@ -954,7 +954,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/bool.html

@@ -334,7 +334,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？
 

pr-preview/pr-1148/c-api/buffer.html

@@ -1016,7 +1016,7 @@ <h3>導航</h3>
 <a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
 <br>
     <br>
-      最後更新於 10月 06, 2025 (00:20 UTC)。
+      最後更新於 10月 07, 2025 (00:21 UTC)。
 
       <a href="/bugs.html">發現 bug</a>？