Skip to content

Commit 3944e3a

Browse files
sync with cpython 19b31d10
1 parent 6369fe7 commit 3944e3a

File tree

3 files changed

+473
-488
lines changed

3 files changed

+473
-488
lines changed

c-api/unicode.po

Lines changed: 46 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ msgid ""
99
msgstr ""
1010
"Project-Id-Version: Python 3.13\n"
1111
"Report-Msgid-Bugs-To: \n"
12-
"POT-Creation-Date: 2025-05-30 00:16+0000\n"
12+
"POT-Creation-Date: 2025-05-31 00:15+0000\n"
1313
"PO-Revision-Date: 2018-05-23 14:08+0000\n"
1414
"Last-Translator: Adrian Liaw <[email protected]>\n"
1515
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -1718,30 +1718,26 @@ msgid ""
17181718
"c:macro:`!CP_ACP` code page to get the MBCS encoder."
17191719
msgstr ""
17201720

1721-
#: ../../c-api/unicode.rst:1407
1722-
msgid "Methods & Slots"
1723-
msgstr ""
1724-
1725-
#: ../../c-api/unicode.rst:1413
1721+
#: ../../c-api/unicode.rst:1409
17261722
msgid "Methods and Slot Functions"
17271723
msgstr ""
17281724

1729-
#: ../../c-api/unicode.rst:1415
1725+
#: ../../c-api/unicode.rst:1411
17301726
msgid ""
17311727
"The following APIs are capable of handling Unicode objects and strings on "
17321728
"input (we refer to them as strings in the descriptions) and return Unicode "
17331729
"objects or integers as appropriate."
17341730
msgstr ""
17351731

1736-
#: ../../c-api/unicode.rst:1419
1732+
#: ../../c-api/unicode.rst:1415
17371733
msgid "They all return ``NULL`` or ``-1`` if an exception occurs."
17381734
msgstr "如果發生例外,則回傳 ``NULL`` 或 ``-1``。"
17391735

1740-
#: ../../c-api/unicode.rst:1424
1736+
#: ../../c-api/unicode.rst:1420
17411737
msgid "Concat two strings giving a new Unicode string."
17421738
msgstr ""
17431739

1744-
#: ../../c-api/unicode.rst:1429
1740+
#: ../../c-api/unicode.rst:1425
17451741
msgid ""
17461742
"Split a string giving a list of Unicode strings. If *sep* is ``NULL``, "
17471743
"splitting will be done at all whitespace substrings. Otherwise, splits "
@@ -1750,73 +1746,73 @@ msgid ""
17501746
"list."
17511747
msgstr ""
17521748

1753-
#: ../../c-api/unicode.rst:1434 ../../c-api/unicode.rst:1444
1754-
#: ../../c-api/unicode.rst:1465 ../../c-api/unicode.rst:1478
1749+
#: ../../c-api/unicode.rst:1430 ../../c-api/unicode.rst:1440
1750+
#: ../../c-api/unicode.rst:1461 ../../c-api/unicode.rst:1474
17551751
msgid "On error, return ``NULL`` with an exception set."
17561752
msgstr "於錯誤發生時回傳 ``NULL`` 並設定例外。"
17571753

1758-
#: ../../c-api/unicode.rst:1436
1754+
#: ../../c-api/unicode.rst:1432
17591755
msgid "Equivalent to :py:meth:`str.split`."
17601756
msgstr "等價於 :py:meth:`str.split`。"
17611757

1762-
#: ../../c-api/unicode.rst:1441
1758+
#: ../../c-api/unicode.rst:1437
17631759
msgid ""
17641760
"Similar to :c:func:`PyUnicode_Split`, but splitting will be done beginning "
17651761
"at the end of the string."
17661762
msgstr ""
17671763

1768-
#: ../../c-api/unicode.rst:1446
1764+
#: ../../c-api/unicode.rst:1442
17691765
msgid "Equivalent to :py:meth:`str.rsplit`."
17701766
msgstr "等價於 :py:meth:`str.rsplit`。"
17711767

1772-
#: ../../c-api/unicode.rst:1451
1768+
#: ../../c-api/unicode.rst:1447
17731769
msgid ""
17741770
"Split a Unicode string at line breaks, returning a list of Unicode strings. "
17751771
"CRLF is considered to be one line break. If *keepends* is ``0``, the Line "
17761772
"break characters are not included in the resulting strings."
17771773
msgstr ""
17781774

1779-
#: ../../c-api/unicode.rst:1458
1775+
#: ../../c-api/unicode.rst:1454
17801776
msgid ""
17811777
"Split a Unicode string at the first occurrence of *sep*, and return a 3-"
17821778
"tuple containing the part before the separator, the separator itself, and "
17831779
"the part after the separator. If the separator is not found, return a 3-"
17841780
"tuple containing the string itself, followed by two empty strings."
17851781
msgstr ""
17861782

1787-
#: ../../c-api/unicode.rst:1463 ../../c-api/unicode.rst:1476
1783+
#: ../../c-api/unicode.rst:1459 ../../c-api/unicode.rst:1472
17881784
msgid "*sep* must not be empty."
17891785
msgstr "*sep* 不得為空。"
17901786

1791-
#: ../../c-api/unicode.rst:1467
1787+
#: ../../c-api/unicode.rst:1463
17921788
msgid "Equivalent to :py:meth:`str.partition`."
17931789
msgstr "等價於 :py:meth:`str.partition`。"
17941790

1795-
#: ../../c-api/unicode.rst:1472
1791+
#: ../../c-api/unicode.rst:1468
17961792
msgid ""
17971793
"Similar to :c:func:`PyUnicode_Partition`, but split a Unicode string at the "
17981794
"last occurrence of *sep*. If the separator is not found, return a 3-tuple "
17991795
"containing two empty strings, followed by the string itself."
18001796
msgstr ""
18011797

1802-
#: ../../c-api/unicode.rst:1480
1798+
#: ../../c-api/unicode.rst:1476
18031799
msgid "Equivalent to :py:meth:`str.rpartition`."
18041800
msgstr "等價於 :py:meth:`str.rpartition`。"
18051801

1806-
#: ../../c-api/unicode.rst:1485
1802+
#: ../../c-api/unicode.rst:1481
18071803
msgid ""
18081804
"Join a sequence of strings using the given *separator* and return the "
18091805
"resulting Unicode string."
18101806
msgstr ""
18111807

1812-
#: ../../c-api/unicode.rst:1492
1808+
#: ../../c-api/unicode.rst:1488
18131809
msgid ""
18141810
"Return ``1`` if *substr* matches ``unicode[start:end]`` at the given tail "
18151811
"end (*direction* == ``-1`` means to do a prefix match, *direction* == ``1`` "
18161812
"a suffix match), ``0`` otherwise. Return ``-1`` if an error occurred."
18171813
msgstr ""
18181814

1819-
#: ../../c-api/unicode.rst:1500
1815+
#: ../../c-api/unicode.rst:1496
18201816
msgid ""
18211817
"Return the first position of *substr* in ``unicode[start:end]`` using the "
18221818
"given *direction* (*direction* == ``1`` means to do a forward search, "
@@ -1825,7 +1821,7 @@ msgid ""
18251821
"``-2`` indicates that an error occurred and an exception has been set."
18261822
msgstr ""
18271823

1828-
#: ../../c-api/unicode.rst:1510
1824+
#: ../../c-api/unicode.rst:1506
18291825
msgid ""
18301826
"Return the first position of the character *ch* in ``unicode[start:end]`` "
18311827
"using the given *direction* (*direction* == ``1`` means to do a forward "
@@ -1835,37 +1831,37 @@ msgid ""
18351831
"set."
18361832
msgstr ""
18371833

1838-
#: ../../c-api/unicode.rst:1518
1834+
#: ../../c-api/unicode.rst:1514
18391835
msgid ""
18401836
"*start* and *end* are now adjusted to behave like ``unicode[start:end]``."
18411837
msgstr ""
18421838

1843-
#: ../../c-api/unicode.rst:1525
1839+
#: ../../c-api/unicode.rst:1521
18441840
msgid ""
18451841
"Return the number of non-overlapping occurrences of *substr* in "
18461842
"``unicode[start:end]``. Return ``-1`` if an error occurred."
18471843
msgstr ""
18481844

1849-
#: ../../c-api/unicode.rst:1532
1845+
#: ../../c-api/unicode.rst:1528
18501846
msgid ""
18511847
"Replace at most *maxcount* occurrences of *substr* in *unicode* with "
18521848
"*replstr* and return the resulting Unicode object. *maxcount* == ``-1`` "
18531849
"means replace all occurrences."
18541850
msgstr ""
18551851

1856-
#: ../../c-api/unicode.rst:1539
1852+
#: ../../c-api/unicode.rst:1535
18571853
msgid ""
18581854
"Compare two strings and return ``-1``, ``0``, ``1`` for less than, equal, "
18591855
"and greater than, respectively."
18601856
msgstr ""
18611857

1862-
#: ../../c-api/unicode.rst:1542
1858+
#: ../../c-api/unicode.rst:1538
18631859
msgid ""
18641860
"This function returns ``-1`` upon failure, so one should call :c:func:"
18651861
"`PyErr_Occurred` to check for errors."
18661862
msgstr ""
18671863

1868-
#: ../../c-api/unicode.rst:1548
1864+
#: ../../c-api/unicode.rst:1544
18691865
msgid ""
18701866
"Compare a Unicode object with a char buffer which is interpreted as being "
18711867
"UTF-8 or ASCII encoded and return true (``1``) if they are equal, or false "
@@ -1874,66 +1870,66 @@ msgid ""
18741870
"is returned."
18751871
msgstr ""
18761872

1877-
#: ../../c-api/unicode.rst:1555 ../../c-api/unicode.rst:1576
1873+
#: ../../c-api/unicode.rst:1551 ../../c-api/unicode.rst:1572
18781874
msgid "This function does not raise exceptions."
18791875
msgstr "此函式不會引發例外。"
18801876

1881-
#: ../../c-api/unicode.rst:1562
1877+
#: ../../c-api/unicode.rst:1558
18821878
msgid ""
18831879
"Similar to :c:func:`PyUnicode_EqualToUTF8AndSize`, but compute *string* "
18841880
"length using :c:func:`!strlen`. If the Unicode object contains null "
18851881
"characters, false (``0``) is returned."
18861882
msgstr ""
18871883

1888-
#: ../../c-api/unicode.rst:1571
1884+
#: ../../c-api/unicode.rst:1567
18891885
msgid ""
18901886
"Compare a Unicode object, *unicode*, with *string* and return ``-1``, ``0``, "
18911887
"``1`` for less than, equal, and greater than, respectively. It is best to "
18921888
"pass only ASCII-encoded strings, but the function interprets the input "
18931889
"string as ISO-8859-1 if it contains non-ASCII characters."
18941890
msgstr ""
18951891

1896-
#: ../../c-api/unicode.rst:1581
1892+
#: ../../c-api/unicode.rst:1577
18971893
msgid "Rich compare two Unicode strings and return one of the following:"
18981894
msgstr ""
18991895

1900-
#: ../../c-api/unicode.rst:1583
1896+
#: ../../c-api/unicode.rst:1579
19011897
msgid "``NULL`` in case an exception was raised"
19021898
msgstr ""
19031899

1904-
#: ../../c-api/unicode.rst:1584
1900+
#: ../../c-api/unicode.rst:1580
19051901
msgid ":c:data:`Py_True` or :c:data:`Py_False` for successful comparisons"
19061902
msgstr ""
19071903

1908-
#: ../../c-api/unicode.rst:1585
1904+
#: ../../c-api/unicode.rst:1581
19091905
msgid ":c:data:`Py_NotImplemented` in case the type combination is unknown"
19101906
msgstr ""
19111907

1912-
#: ../../c-api/unicode.rst:1587
1908+
#: ../../c-api/unicode.rst:1583
19131909
msgid ""
19141910
"Possible values for *op* are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:"
19151911
"`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, and :c:macro:`Py_LE`."
19161912
msgstr ""
19171913

1918-
#: ../../c-api/unicode.rst:1593
1914+
#: ../../c-api/unicode.rst:1589
19191915
msgid ""
19201916
"Return a new string object from *format* and *args*; this is analogous to "
19211917
"``format % args``."
19221918
msgstr ""
19231919

1924-
#: ../../c-api/unicode.rst:1599
1920+
#: ../../c-api/unicode.rst:1595
19251921
msgid ""
19261922
"Check whether *substr* is contained in *unicode* and return true or false "
19271923
"accordingly."
19281924
msgstr ""
19291925

1930-
#: ../../c-api/unicode.rst:1602
1926+
#: ../../c-api/unicode.rst:1598
19311927
msgid ""
19321928
"*substr* has to coerce to a one element Unicode string. ``-1`` is returned "
19331929
"if there was an error."
19341930
msgstr ""
19351931

1936-
#: ../../c-api/unicode.rst:1608
1932+
#: ../../c-api/unicode.rst:1604
19371933
msgid ""
19381934
"Intern the argument :c:expr:`*p_unicode` in place. The argument must be the "
19391935
"address of a pointer variable pointing to a Python Unicode string object. "
@@ -1944,47 +1940,47 @@ msgid ""
19441940
"interns it."
19451941
msgstr ""
19461942

1947-
#: ../../c-api/unicode.rst:1615
1943+
#: ../../c-api/unicode.rst:1611
19481944
msgid ""
19491945
"(Clarification: even though there is a lot of talk about references, think "
19501946
"of this function as reference-neutral. You must own the object you pass in; "
19511947
"after the call you no longer own the passed-in reference, but you newly own "
19521948
"the result.)"
19531949
msgstr ""
19541950

1955-
#: ../../c-api/unicode.rst:1620
1951+
#: ../../c-api/unicode.rst:1616
19561952
msgid ""
19571953
"This function never raises an exception. On error, it leaves its argument "
19581954
"unchanged without interning it."
19591955
msgstr ""
19601956

1961-
#: ../../c-api/unicode.rst:1623
1957+
#: ../../c-api/unicode.rst:1619
19621958
msgid ""
19631959
"Instances of subclasses of :py:class:`str` may not be interned, that is, :c:"
19641960
"expr:`PyUnicode_CheckExact(*p_unicode)` must be true. If it is not, then -- "
19651961
"as with any other error -- the argument is left unchanged."
19661962
msgstr ""
19671963

1968-
#: ../../c-api/unicode.rst:1627
1964+
#: ../../c-api/unicode.rst:1623
19691965
msgid ""
19701966
"Note that interned strings are not “immortal”. You must keep a reference to "
19711967
"the result to benefit from interning."
19721968
msgstr ""
19731969

1974-
#: ../../c-api/unicode.rst:1633
1970+
#: ../../c-api/unicode.rst:1629
19751971
msgid ""
19761972
"A combination of :c:func:`PyUnicode_FromString` and :c:func:"
19771973
"`PyUnicode_InternInPlace`, meant for statically allocated strings."
19781974
msgstr ""
19791975

1980-
#: ../../c-api/unicode.rst:1636
1976+
#: ../../c-api/unicode.rst:1632
19811977
msgid ""
19821978
"Return a new (\"owned\") reference to either a new Unicode string object "
19831979
"that has been interned, or an earlier interned string object with the same "
19841980
"value."
19851981
msgstr ""
19861982

1987-
#: ../../c-api/unicode.rst:1640
1983+
#: ../../c-api/unicode.rst:1636
19881984
msgid ""
19891985
"Python may keep a reference to the result, or make it :term:`immortal`, "
19901986
"preventing it from being garbage-collected promptly. For interning an "

0 commit comments

Comments
 (0)