Skip to content

Commit 48887de

Browse files
mattwang44mattwang44
committed
Deploying to gh-pages from @ 5dbf657 🚀
1 parent 3a47dea commit 48887de

File tree

540 files changed

+1531
-2062
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

540 files changed

+1531
-2062
lines changed

‎.buildinfo

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
# Sphinx build info version 1
22
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3-
config: 1a04f150092c908563e420566d3bc0e4
3+
config: b4b716da5d29292ed3248eee755a5024
44
tags: 645f666f9bcd5a90fca523b33c5a78b7

‎_sources/library/dis.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1462,7 +1462,7 @@ iterations of the loop.
14621462

14631463
end = STACK.pop()
14641464
start = STACK.pop()
1465-
STACK.append(slice(start, stop))
1465+
STACK.append(slice(start, end))
14661466

14671467
if it is 3, implements::
14681468

‎_sources/library/socket.rst.txt

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -695,6 +695,13 @@ Constants
695695

696696
.. versionadded:: 3.12
697697

698+
.. data:: SHUT_RD
699+
SHUT_WR
700+
SHUT_RDWR
701+
702+
These constants are used by the :meth:`~socket.socket.shutdown` method of socket objects.
703+
704+
.. availability:: not WASI.
698705

699706
Functions
700707
^^^^^^^^^

‎about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -319,7 +319,7 @@ <h3>瀏覽</h3>
319319
<a href="https://www.python.org/psf/donations/">Please donate.</a>
320320
<br />
321321
<br />
322-
最後更新於 Aug 16, 2024 (09:42 UTC)。
322+
最後更新於 Aug 18, 2024 (12:45 UTC)。
323323

324324
<a href="/bugs.html">Found a bug</a>?
325325

‎bugs.html

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -184,16 +184,16 @@ <h3>瀏覽</h3>
184184

185185
<section id="dealing-with-bugs">
186186
<span id="reporting-bugs"></span><h1>處理錯誤 (Bug)<a class="headerlink" href="#dealing-with-bugs" title="連結到這個標頭"></a></h1>
187-
<p>Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開發者們想知道任何您在 Python 中發現的缺失。</p>
187+
<p>Python 已經是一個以穩定著稱的成熟程式語言。為了維持「穩定」的信譽，開發者們想知道任何你在 Python 中發現的缺失。</p>
188188
<p>有時候自己直接修復錯誤並且送出一個修正給 Python 會比較快，因為這樣會加速流程而且不會困擾到太多人。學習如何<a class="reference internal" href="#contributing-to-python"><span class="std std-ref">貢獻給 Python</span></a>。</p>
189189
<section id="documentation-bugs">
190190
<h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title="連結到這個標頭"></a></h2>
191-
<p>如果您在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到<a class="reference internal" href="#using-the-tracker"><span class="std std-ref">追蹤系統 (tracker)</span></a>。如果您有相應的修正建議，請一併提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 <a class="reference external" href="https://github.com/python/python-docs-zh-tw/issues">https://github.com/python/python-docs-zh-tw/issues</a>。）</p>
191+
<p>如果你在這份說明文件中發現了錯誤並想要幫助我們改進，請將錯誤報告提交到<a class="reference internal" href="#using-the-tracker"><span class="std std-ref">追蹤系統 (tracker)</span></a>。如果你有相應的修正建議，請一併提交。（譯者註：如果是繁體中文說明文件翻譯相關的錯誤，請提交到 <a class="reference external" href="https://github.com/python/python-docs-zh-tw/issues">https://github.com/python/python-docs-zh-tw/issues</a>。）</p>
192192
<p>你也可以在我們的<a class="reference external" href="https://discuss.python.org/c/documentation/26">說明文件 Discourse 討論區</a>中新增一個討論事項。</p>
193193
<p>If you find a bug in the theme (HTML / CSS / JavaScript) of the
194194
documentation, please submit a bug report on the <a class="reference external" href="https://github.com/python/python-docs-theme">python-doc-theme bug
195195
tracker</a>.</p>
196-
<p>如果您的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 <a class="reference external" href="mailto:docs&#37;&#52;&#48;python&#46;org">docs<span>&#64;</span>python<span>&#46;</span>org</a>（程式碼執行的錯誤可以寄到 <a class="reference external" href="mailto:python-list&#37;&#52;&#48;python&#46;org">python-list<span>&#64;</span>python<span>&#46;</span>org</a>）。「docs&#64;」是一個由志工們所運行的郵寄清單；您的請求會被注意到，但可能需要一些時間才會被處理。</p>
196+
<p>如果你的時間有限，也可以將說明文件的錯誤報告以電子郵件寄到 <a class="reference external" href="mailto:docs&#37;&#52;&#48;python&#46;org">docs<span>&#64;</span>python<span>&#46;</span>org</a>（程式碼執行的錯誤可以寄到 <a class="reference external" href="mailto:python-list&#37;&#52;&#48;python&#46;org">python-list<span>&#64;</span>python<span>&#46;</span>org</a>）。「docs&#64;」是一個由志工們所運行的郵寄清單；你的請求會被注意到，但可能需要一些時間才會被處理。</p>
197197
<div class="admonition seealso">
198198
<p class="admonition-title">也參考</p>
199199
<dl class="simple">
@@ -211,13 +211,13 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
211211
<section id="using-the-python-issue-tracker">
212212
<span id="using-the-tracker"></span><h2>使用 Python 問題追蹤系統<a class="headerlink" href="#using-the-python-issue-tracker" title="連結到這個標頭"></a></h2>
213213
<p>對於 Python 本身的問題報告，應該透過 GitHub 問題追蹤系統 (<a class="reference external" href="https://github.com/python/cpython/issues">https://github.com/python/cpython/issues</a>) 提交。這個 GitHub 問題追蹤系統提供了一個網頁表單，可以輸入並提交相關資訊給開發者。</p>
214-
<p>填寫報告的第一步，是確認該問題是否已經被回報過了。這樣做的好處，除了可以節省開發者的時間，也能讓您了解目前關於該問題的處理進度；有可能已經在下一個發行版本中修正了這個問題，也有可能需要更詳細的資訊（在這種情況下，如果可以，非常歡迎您提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋追蹤系統。</p>
215-
<p>如果您想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果您還沒有 GitHub 帳戶，請點選「Sign up」連結來建立一個新的帳戶。您無法以匿名方式提交錯誤報告。</p>
216-
<p>如果已經登入，那您就可以提交問題了。請點選列表頂端區域的「New issue」按鈕，來回報一個新的問題。</p>
214+
<p>填寫報告的第一步，是確認該問題是否已經被回報過了。這樣做的好處，除了可以節省開發者的時間，也能讓你了解目前關於該問題的處理進度；有可能已經在下一個發行版本中修正了這個問題，也有可能需要更詳細的資訊（在這種情況下，如果可以，非常歡迎你提供資訊！）。要確認是否重複回報，請使用頁面頂端的搜尋框來搜尋追蹤系統。</p>
215+
<p>如果你想回報的問題還沒有在問題列表出現過，請登入 GitHub。如果你還沒有 GitHub 帳戶，請點選「Sign up」連結來建立一個新的帳戶。你無法以匿名方式提交錯誤報告。</p>
216+
<p>如果已經登入，那你就可以提交問題了。請點選列表頂端區域的「New issue」按鈕，來回報一個新的問題。</p>
217217
<p>提交的表單中有兩個欄位，「Title」及「Comment」。</p>
218218
<p>在「Title」欄位，輸入對該問題<em>非常</em>簡短的描述；最好少於十個單字。</p>
219-
<p>在「Comment」欄位，請詳細描述該問題，包括您預期發生的情況和實際發生的情況。請確定說明中包含了涉及到的任何擴充模組，以及您當時所使用的硬體和軟體平台（視情況而定，可以附上版本資訊）。</p>
220-
<p>每一份問題報告都會被一位開發人員查核，並由他決定要做出什麼變更來修正這個問題。每當該問題有修正動作時，您會收到更新回報。</p>
219+
<p>在「Comment」欄位，請詳細描述該問題，包括你預期發生的情況和實際發生的情況。請確定說明中包含了涉及到的任何擴充模組，以及你當時所使用的硬體和軟體平台（視情況而定，可以附上版本資訊）。</p>
220+
<p>每一份問題報告都會被一位開發人員查核，並由他決定要做出什麼變更來修正這個問題。每當該問題有修正動作時，你會收到更新回報。</p>
221221
<div class="admonition seealso">
222222
<p class="admonition-title">也參考</p>
223223
<dl class="simple">
@@ -230,7 +230,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
230230
</section>
231231
<section id="getting-started-contributing-to-python-yourself">
232232
<span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭"></a></h2>
233-
<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>
233+
<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>
234234
</section>
235235
</section>
236236

@@ -358,7 +358,7 @@ <h3>瀏覽</h3>
358358
<a href="https://www.python.org/psf/donations/">Please donate.</a>
359359
<br />
360360
<br />
361-
最後更新於 Aug 16, 2024 (09:42 UTC)。
361+
最後更新於 Aug 18, 2024 (12:45 UTC)。
362362

363363
<a href="/bugs.html">Found a bug</a>?
364364

‎c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
329329
<a href="https://www.python.org/psf/donations/">Please donate.</a>
330330
<br />
331331
<br />
332-
最後更新於 Aug 16, 2024 (09:42 UTC)。
332+
最後更新於 Aug 18, 2024 (12:45 UTC)。
333333

334334
<a href="/bugs.html">Found a bug</a>?
335335

‎c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -343,7 +343,7 @@ <h3>瀏覽</h3>
343343
<a href="https://www.python.org/psf/donations/">Please donate.</a>
344344
<br />
345345
<br />
346-
最後更新於 Aug 16, 2024 (09:42 UTC)。
346+
最後更新於 Aug 18, 2024 (12:45 UTC)。
347347

348348
<a href="/bugs.html">Found a bug</a>?
349349

‎c-api/apiabiversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -375,7 +375,7 @@ <h3>瀏覽</h3>
375375
<a href="https://www.python.org/psf/donations/">Please donate.</a>
376376
<br />
377377
<br />
378-
最後更新於 Aug 16, 2024 (09:42 UTC)。
378+
最後更新於 Aug 18, 2024 (12:45 UTC)。
379379

380380
<a href="/bugs.html">Found a bug</a>?
381381

‎c-api/arg.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -412,9 +412,9 @@ <h3>數字<a class="headerlink" href="#numbers" title="連結到這個標頭">¶
412412
<dt><code class="docutils literal notranslate"><span class="pre">C</span></code>（長度為 1 的 <a class="reference internal" href="../library/stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>）[int]</dt><dd><p>Convert a Python character, represented as a <a class="reference internal" href="../library/stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a> object of
413413
length 1, to a C <span class="c-expr sig sig-inline c"><span class="kt">int</span></span>.</p>
414414
</dd>
415-
<dt><code class="docutils literal notranslate"><span class="pre">f</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [float]</dt><dd><p>Convert a Python floating-point number to a C <span class="c-expr sig sig-inline c"><span class="kt">float</span></span>.</p>
415+
<dt><code class="docutils literal notranslate"><span class="pre">f</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [float]</dt><dd><p>將一個 Python 浮點數轉換成 C 的 :c:type:<span class="c-expr sig sig-inline c"><span class="kt">float</span></span>。</p>
416416
</dd>
417-
<dt><code class="docutils literal notranslate"><span class="pre">d</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [double]</dt><dd><p>Convert a Python floating-point number to a C <span class="c-expr sig sig-inline c"><span class="kt">double</span></span>.</p>
417+
<dt><code class="docutils literal notranslate"><span class="pre">d</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [double]</dt><dd><p>將一個 Python 浮點數轉換成 C 的 :c:type:<span class="c-expr sig sig-inline c"><span class="kt">double</span></span>。</p>
418418
</dd>
419419
<dt><code class="docutils literal notranslate"><span class="pre">D</span></code> (<a class="reference internal" href="../library/functions.html#complex" title="complex"><code class="xref py py-class docutils literal notranslate"><span class="pre">complex</span></code></a>) [Py_complex]</dt><dd><p>將一個 Python 複數轉換成 C 的 <a class="reference internal" href="complex.html#c.Py_complex" title="Py_complex"><code class="xref c c-type docutils literal notranslate"><span class="pre">Py_complex</span></code></a> 結構。</p>
420420
</dd>
@@ -706,9 +706,9 @@ <h2>Building values<a class="headerlink" href="#building-values" title="連結
706706
</dd>
707707
<dt><code class="docutils literal notranslate"><span class="pre">C</span></code>（長度為 1 的 <a class="reference internal" href="../library/stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>）[int]</dt><dd><p>將一個 C 中代表一個字元的 <span class="c-expr sig sig-inline c"><span class="kt">int</span></span> 轉換成 Python 中長度為一的 <a class="reference internal" href="../library/stdtypes.html#str" title="str"><code class="xref py py-class docutils literal notranslate"><span class="pre">str</span></code></a>。</p>
708708
</dd>
709-
<dt><code class="docutils literal notranslate"><span class="pre">d</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [double]</dt><dd><p>Convert a C <span class="c-expr sig sig-inline c"><span class="kt">double</span></span> to a Python floating-point number.</p>
709+
<dt><code class="docutils literal notranslate"><span class="pre">d</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [double]</dt><dd><p>將一個 C 的 <span class="c-expr sig sig-inline c"><span class="kt">double</span></span> 轉換成 Python 浮點數。</p>
710710
</dd>
711-
<dt><code class="docutils literal notranslate"><span class="pre">f</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [float]</dt><dd><p>Convert a C <span class="c-expr sig sig-inline c"><span class="kt">float</span></span> to a Python floating-point number.</p>
711+
<dt><code class="docutils literal notranslate"><span class="pre">f</span></code> (<a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate"><span class="pre">float</span></code></a>) [float]</dt><dd><p>將一個 C 的 <span class="c-expr sig sig-inline c"><span class="kt">float</span></span> 轉換成 Python 浮點數。</p>
712712
</dd>
713713
<dt><code class="docutils literal notranslate"><span class="pre">D</span></code> (<a class="reference internal" href="../library/functions.html#complex" title="complex"><code class="xref py py-class docutils literal notranslate"><span class="pre">complex</span></code></a>) [Py_complex *]</dt><dd><p>將一個 C 的 <a class="reference internal" href="complex.html#c.Py_complex" title="Py_complex"><code class="xref c c-type docutils literal notranslate"><span class="pre">Py_complex</span></code></a> 結構轉換成 Python 複數。</p>
714714
</dd>
@@ -886,7 +886,7 @@ <h3>瀏覽</h3>
886886
<a href="https://www.python.org/psf/donations/">Please donate.</a>
887887
<br />
888888
<br />
889-
最後更新於 Aug 16, 2024 (09:42 UTC)。
889+
最後更新於 Aug 18, 2024 (12:45 UTC)。
890890

891891
<a href="/bugs.html">Found a bug</a>?
892892

‎c-api/bool.html

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
<link rel="index" title="索引" href="../genindex.html" />
2626
<link rel="search" title="搜尋" href="../search.html" />
2727
<link rel="copyright" title="版權" href="../copyright.html" />
28-
<link rel="next" title="Floating-Point Objects" href="float.html" />
28+
<link rel="next" title="浮點數（Floating-Point）物件" href="float.html" />
2929
<link rel="prev" title="整數物件" href="long.html" />
3030

3131
<link rel="canonical" href="https://docs.python.org/3/c-api/bool.html" />
@@ -93,7 +93,7 @@ <h4>上個主題</h4>
9393
<div>
9494
<h4>下個主題</h4>
9595
<p class="topless"><a href="float.html"
96-
title="下一章">Floating-Point Objects</a></p>
96+
title="下一章">浮點數（Floating-Point）物件</a></p>
9797
</div>
9898
<div role="note" aria-label="source link">
9999
<h3>此頁面</h3>
@@ -121,7 +121,7 @@ <h3>瀏覽</h3>
121121
<a href="../py-modindex.html" title="Python 模組索引"
122122
>模組</a> |</li>
123123
<li class="right" >
124-
<a href="float.html" title="Floating-Point Objects"
124+
<a href="float.html" title="浮點數（Floating-Point）物件"
125125
accesskey="N">下一頁</a> |</li>
126126
<li class="right" >
127127
<a href="long.html" title="整數物件"
@@ -241,7 +241,7 @@ <h4>上個主題</h4>
241241
<div>
242242
<h4>下個主題</h4>
243243
<p class="topless"><a href="float.html"
244-
title="下一章">Floating-Point Objects</a></p>
244+
title="下一章">浮點數（Floating-Point）物件</a></p>
245245
</div>
246246
<div role="note" aria-label="source link">
247247
<h3>此頁面</h3>
@@ -272,7 +272,7 @@ <h3>瀏覽</h3>
272272
<a href="../py-modindex.html" title="Python 模組索引"
273273
>模組</a> |</li>
274274
<li class="right" >
275-
<a href="float.html" title="Floating-Point Objects"
275+
<a href="float.html" title="浮點數（Floating-Point）物件"
276276
>下一頁</a> |</li>
277277
<li class="right" >
278278
<a href="long.html" title="整數物件"
@@ -340,7 +340,7 @@ <h3>瀏覽</h3>
340340
<a href="https://www.python.org/psf/donations/">Please donate.</a>
341341
<br />
342342
<br />
343-
最後更新於 Aug 16, 2024 (09:42 UTC)。
343+
最後更新於 Aug 18, 2024 (12:45 UTC)。
344344

345345
<a href="/bugs.html">Found a bug</a>?
346346

0 commit comments

Comments
 (0)