Skip to content

Commit 53de3e4

Browse files
committed
Deploying to gh-pages from @ c369929 🚀
1 parent 8ce8550 commit 53de3e4

File tree

576 files changed

+889
-705
lines changed

Some content is hidden

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

576 files changed

+889
-705
lines changed

_sources/c-api/code.rst.txt

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -211,6 +211,17 @@ bound into a function.
211211
.. versionadded:: 3.12
212212
213213
214+
.. c:function:: PyObject *PyCode_Optimize(PyObject *code, PyObject *consts, PyObject *names, PyObject *lnotab_obj)
215+
216+
This is a :term:`soft deprecated` function that does nothing.
217+
218+
Prior to Python 3.10, this function would perform basic optimizations to a
219+
code object.
220+
221+
.. versionchanged:: 3.10
222+
This function now does nothing.
223+
224+
214225
.. _c_codeobject_flags:
215226
216227
Code Object Flags

_sources/c-api/dict.rst.txt

Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -431,3 +431,49 @@ Dictionary Objects
431431
it before returning.
432432
433433
.. versionadded:: 3.12
434+
435+
436+
Dictionary View Objects
437+
^^^^^^^^^^^^^^^^^^^^^^^
438+
439+
.. c:function:: int PyDictViewSet_Check(PyObject *op)
440+
441+
Return true if *op* is a view of a set inside a dictionary. This is currently
442+
equivalent to :c:expr:`PyDictKeys_Check(op) || PyDictItems_Check(op)`. This
443+
function always succeeds.
444+
445+
446+
.. c:var:: PyTypeObject PyDictKeys_Type
447+
448+
Type object for a view of dictionary keys. In Python, this is the type of
449+
the object returned by :meth:`dict.keys`.
450+
451+
452+
.. c:function:: int PyDictKeys_Check(PyObject *op)
453+
454+
Return true if *op* is an instance of a dictionary keys view. This function
455+
always succeeds.
456+
457+
458+
.. c:var:: PyTypeObject PyDictValues_Type
459+
460+
Type object for a view of dictionary values. In Python, this is the type of
461+
the object returned by :meth:`dict.values`.
462+
463+
464+
.. c:function:: int PyDictValues_Check(PyObject *op)
465+
466+
Return true if *op* is an instance of a dictionary values view. This function
467+
always succeeds.
468+
469+
470+
.. c:var:: PyTypeObject PyDictItems_Type
471+
472+
Type object for a view of dictionary items. In Python, this is the type of
473+
the object returned by :meth:`dict.items`.
474+
475+
476+
.. c:function:: int PyDictItems_Check(PyObject *op)
477+
478+
Return true if *op* is an instance of a dictionary items view. This function
479+
always succeeds.

_sources/c-api/exceptions.rst.txt

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -309,6 +309,14 @@ For convenience, some of these functions will always return a
309309
.. versionadded:: 3.4
310310
311311
312+
.. c:function:: void PyErr_RangedSyntaxLocationObject(PyObject *filename, int lineno, int col_offset, int end_lineno, int end_col_offset)
313+
314+
Similar to :c:func:`PyErr_SyntaxLocationObject`, but also sets the
315+
*end_lineno* and *end_col_offset* information for the current exception.
316+
317+
.. versionadded:: 3.10
318+
319+
312320
.. c:function:: void PyErr_SyntaxLocationEx(const char *filename, int lineno, int col_offset)
313321
314322
Like :c:func:`PyErr_SyntaxLocationObject`, but *filename* is a byte string

_sources/c-api/veryhigh.rst.txt

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -100,18 +100,12 @@ the same library that the Python runtime is using.
100100
Otherwise, Python may not handle script file with LF line ending correctly.
101101
102102
103-
.. c:function:: int PyRun_InteractiveOne(FILE *fp, const char *filename)
104-
105-
This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below,
106-
leaving *flags* set to ``NULL``.
107-
108-
109-
.. c:function:: int PyRun_InteractiveOneFlags(FILE *fp, const char *filename, PyCompilerFlags *flags)
103+
.. c:function:: int PyRun_InteractiveOneObject(FILE *fp, PyObject *filename, PyCompilerFlags *flags)
110104
111105
Read and execute a single statement from a file associated with an
112106
interactive device according to the *flags* argument. The user will be
113-
prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from the
114-
:term:`filesystem encoding and error handler`.
107+
prompted using ``sys.ps1`` and ``sys.ps2``. *filename* must be a Python
108+
:class:`str` object.
115109
116110
Returns ``0`` when the input was
117111
executed successfully, ``-1`` if there was an exception, or an error code
@@ -120,6 +114,19 @@ the same library that the Python runtime is using.
120114
:file:`Python.h`, so must be included specifically if needed.)
121115
122116
117+
.. c:function:: int PyRun_InteractiveOne(FILE *fp, const char *filename)
118+
119+
This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below,
120+
leaving *flags* set to ``NULL``.
121+
122+
123+
.. c:function:: int PyRun_InteractiveOneFlags(FILE *fp, const char *filename, PyCompilerFlags *flags)
124+
125+
Similar to :c:func:`PyRun_InteractiveOneObject`, but *filename* is a
126+
:c:expr:`const char*`, which is decoded from the
127+
:term:`filesystem encoding and error handler`.
128+
129+
123130
.. c:function:: int PyRun_InteractiveLoop(FILE *fp, const char *filename)
124131
125132
This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` below,

_sources/tutorial/stdlib.rst.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -183,13 +183,13 @@ protocols. Two of the simplest are :mod:`urllib.request` for retrieving data
183183
from URLs and :mod:`smtplib` for sending mail::
184184

185185
>>> from urllib.request import urlopen
186-
>>> with urlopen('http://worldtimeapi.org/api/timezone/etc/UTC.txt') as response:
186+
>>> with urlopen('https://docs.python.org/3/') as response:
187187
... for line in response:
188188
... line = line.decode() # Convert bytes to a str
189-
... if line.startswith('datetime'):
189+
... if 'updated' in line:
190190
... print(line.rstrip()) # Remove trailing newline
191191
...
192-
datetime: 2022-01-01T01:36:47.689215+00:00
192+
Last updated on Nov 11, 2025 (20:11 UTC).
193193

194194
>>> import smtplib
195195
>>> server = smtplib.SMTP('localhost')

about.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -314,7 +314,7 @@ <h3>導航</h3>
314314
<a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
315315
<br>
316316
<br>
317-
最後更新於 11月 12, 2025 (18:33 UTC)。
317+
最後更新於 11月 13, 2025 (23:18 UTC)。
318318

319319
<a href="/bugs.html">發現 bug</a>
320320

bugs.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -229,7 +229,7 @@ <h2>說明文件的錯誤<a class="headerlink" href="#documentation-bugs" title=
229229
</section>
230230
<section id="getting-started-contributing-to-python-yourself">
231231
<span id="contributing-to-python"></span><h2>開始讓自己貢獻 Python<a class="headerlink" href="#getting-started-contributing-to-python-yourself" title="連結到這個標頭"></a></h2>
232-
<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>
232+
<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>
233233
</section>
234234
</section>
235235

@@ -351,7 +351,7 @@ <h3>導航</h3>
351351
<a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
352352
<br>
353353
<br>
354-
最後更新於 11月 12, 2025 (18:33 UTC)。
354+
最後更新於 11月 13, 2025 (23:18 UTC)。
355355

356356
<a href="/bugs.html">發現 bug</a>
357357

c-api/abstract.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -323,7 +323,7 @@ <h3>導航</h3>
323323
<a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
324324
<br>
325325
<br>
326-
最後更新於 11月 12, 2025 (18:33 UTC)。
326+
最後更新於 11月 13, 2025 (23:18 UTC)。
327327

328328
<a href="/bugs.html">發現 bug</a>
329329

c-api/allocation.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -532,7 +532,7 @@ <h3>導航</h3>
532532
<a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
533533
<br>
534534
<br>
535-
最後更新於 11月 12, 2025 (18:33 UTC)。
535+
最後更新於 11月 13, 2025 (23:18 UTC)。
536536

537537
<a href="/bugs.html">發現 bug</a>
538538

c-api/apiabiversion.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -471,7 +471,7 @@ <h3>導航</h3>
471471
<a href="https://www.python.org/psf/donations/">敬請捐贈。</a>
472472
<br>
473473
<br>
474-
最後更新於 11月 12, 2025 (18:33 UTC)。
474+
最後更新於 11月 13, 2025 (23:18 UTC)。
475475

476476
<a href="/bugs.html">發現 bug</a>
477477

0 commit comments

Comments
 (0)