Deploying to gh-pages from @ 1c1c864 🚀

python · Aug 28, 2024 · d999020 · d999020
1 parent bccd528
commit d999020
Show file tree

Hide file tree

Showing 540 changed files with 716 additions and 809 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 95672da2a7bca6d65c95c8dafe0f7466
+config: 2b1915377ac5817e2b5ab6694dc2f7b7
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/_sources/c-api/tuple.rst.txt b/_sources/c-api/tuple.rst.txt
@@ -33,25 +33,27 @@ Tuple Objects
 
 .. c:function:: PyObject* PyTuple_New(Py_ssize_t len)
 
-   Return a new tuple object of size *len*, or ``NULL`` on failure.
+   Return a new tuple object of size *len*,
+   or ``NULL`` with an exception set on failure.
 
 
 .. c:function:: PyObject* PyTuple_Pack(Py_ssize_t n, ...)
 
-   Return a new tuple object of size *n*, or ``NULL`` on failure. The tuple values
+   Return a new tuple object of size *n*,
+   or ``NULL`` with an exception set on failure. The tuple values
    are initialized to the subsequent *n* C arguments pointing to Python objects.
    ``PyTuple_Pack(2, a, b)`` is equivalent to ``Py_BuildValue("(OO)", a, b)``.
 
 
 .. c:function:: Py_ssize_t PyTuple_Size(PyObject *p)
 
    Take a pointer to a tuple object, and return the size of that tuple.
+   On error, return ``-1`` and with an exception set.
 
 
 .. c:function:: Py_ssize_t PyTuple_GET_SIZE(PyObject *p)
 
-   Return the size of the tuple *p*, which must be non-``NULL`` and point to a tuple;
-   no error checking is performed.
+   Like :c:func:`PyTuple_Size`, but without error checking.
 
 
 .. c:function:: PyObject* PyTuple_GetItem(PyObject *p, Py_ssize_t pos)
@@ -74,8 +76,10 @@ Tuple Objects
 .. c:function:: PyObject* PyTuple_GetSlice(PyObject *p, Py_ssize_t low, Py_ssize_t high)
 
    Return the slice of the tuple pointed to by *p* between *low* and *high*,
-   or ``NULL`` on failure.  This is the equivalent of the Python expression
-   ``p[low:high]``.  Indexing from the end of the tuple is not supported.
+   or ``NULL`` with an exception set on failure.
+
+   This is the equivalent of the Python expression ``p[low:high]``.
+   Indexing from the end of the tuple is not supported.
 
 
 .. c:function:: int PyTuple_SetItem(PyObject *p, Py_ssize_t pos, PyObject *o)
@@ -132,6 +136,8 @@ type.
    Create a new struct sequence type from the data in *desc*, described below. Instances
    of the resulting type can be created with :c:func:`PyStructSequence_New`.
 
+   Return ``NULL`` with an exception set on failure.
+
 
 .. c:function:: void PyStructSequence_InitType(PyTypeObject *type, PyStructSequence_Desc *desc)
 
@@ -140,8 +146,8 @@ type.
 
 .. c:function:: int PyStructSequence_InitType2(PyTypeObject *type, PyStructSequence_Desc *desc)
 
-   The same as ``PyStructSequence_InitType``, but returns ``0`` on success and ``-1`` on
-   failure.
+   Like :c:func:`PyStructSequence_InitType`, but returns ``0`` on success
+   and ``-1`` with an exception set on failure.
 
    .. versionadded:: 3.4
 
@@ -198,6 +204,8 @@ type.
    Creates an instance of *type*, which must have been created with
    :c:func:`PyStructSequence_NewType`.
 
+   Return ``NULL`` with an exception set on failure.
+
 
 .. c:function:: PyObject* PyStructSequence_GetItem(PyObject *p, Py_ssize_t pos)
 

diff --git a/about.html b/about.html
@@ -319,7 +319,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/bugs.html b/bugs.html
@@ -358,7 +358,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/abstract.html b/c-api/abstract.html
@@ -329,7 +329,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/allocation.html b/c-api/allocation.html
@@ -343,7 +343,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/apiabiversion.html b/c-api/apiabiversion.html
@@ -375,7 +375,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/arg.html b/c-api/arg.html
@@ -886,7 +886,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/bool.html b/c-api/bool.html
@@ -340,7 +340,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/buffer.html b/c-api/buffer.html
@@ -1013,7 +1013,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/bytearray.html b/c-api/bytearray.html
@@ -399,7 +399,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/bytes.html b/c-api/bytes.html
@@ -520,7 +520,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/call.html b/c-api/call.html
@@ -655,7 +655,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/capsule.html b/c-api/capsule.html
@@ -440,7 +440,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/cell.html b/c-api/cell.html
@@ -340,7 +340,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/code.html b/c-api/code.html
@@ -595,7 +595,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/codec.html b/c-api/codec.html
@@ -444,7 +444,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/complex.html b/c-api/complex.html
@@ -438,7 +438,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/concrete.html b/c-api/concrete.html
@@ -463,7 +463,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/contextvars.html b/c-api/contextvars.html
@@ -450,7 +450,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/conversion.html b/c-api/conversion.html
@@ -389,7 +389,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/coro.html b/c-api/coro.html
@@ -318,7 +318,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/datetime.html b/c-api/datetime.html
@@ -629,7 +629,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/descriptor.html b/c-api/descriptor.html
@@ -333,7 +333,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/dict.html b/c-api/dict.html
@@ -642,7 +642,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/exceptions.html b/c-api/exceptions.html
@@ -1689,7 +1689,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/file.html b/c-api/file.html
@@ -365,7 +365,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/float.html b/c-api/float.html
@@ -488,7 +488,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/frame.html b/c-api/frame.html
@@ -499,7 +499,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/function.html b/c-api/function.html
@@ -467,7 +467,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/gcsupport.html b/c-api/gcsupport.html
@@ -610,7 +610,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/gen.html b/c-api/gen.html
@@ -327,7 +327,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/hash.html b/c-api/hash.html
@@ -349,7 +349,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/import.html b/c-api/import.html
@@ -618,7 +618,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/index.html b/c-api/index.html
@@ -416,7 +416,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/init.html b/c-api/init.html
@@ -2479,7 +2479,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?
 

diff --git a/c-api/init_config.html b/c-api/init_config.html
@@ -1924,7 +1924,7 @@ <h3>瀏覽</h3>
 <a href="https://www.python.org/psf/donations/">Please donate.</a>
 <br />
     <br />
-      最後更新於 Aug 27, 2024 (04:09 UTC)。
+      最後更新於 Aug 28, 2024 (13:21 UTC)。
 
       <a href="/bugs.html">Found a bug</a>?