https://github.com/python/cpython/commit/3a74d52584c4f717e02545421ca04ee2f73f7e83
commit: 3a74d52584c4f717e02545421ca04ee2f73f7e83
branch: 3.13
author: Serhiy Storchaka <storch...@gmail.com>
committer: serhiy-storchaka <storch...@gmail.com>
date: 2025-08-13T09:37:15Z
summary:
[3.13] gh-137668: Document that ord() supports also bytes and bytearray
(GH-137669) (GH-137704)
(cherry picked from commit 35759fe2faf1443455dfcb15ef7c435e34b492c7)
files:
M Doc/library/functions.rst
M Python/bltinmodule.c
M Python/clinic/bltinmodule.c.h
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 4acc24d352ac67..3bc941ef8fb3f2 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -1550,13 +1550,19 @@ are always available. They are listed here in
alphabetical order.
.. versionchanged:: 3.11
The ``'U'`` mode has been removed.
-.. function:: ord(c)
+.. function:: ord(character, /)
- Given a string representing one Unicode character, return an integer
- representing the Unicode code point of that character. For example,
+ Return the ordinal value of a character.
+
+ If the argument is a one-character string, return the Unicode code point
+ of that character. For example,
``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign)
returns ``8364``. This is the inverse of :func:`chr`.
+ If the argument is a :class:`bytes` or :class:`bytearray` object of
+ length 1, return its single byte value.
+ For example, ``ord(b'a')`` returns the integer ``97``.
+
.. function:: pow(base, exp, mod=None)
diff --git a/Python/bltinmodule.c b/Python/bltinmodule.c
index cc93424664c69c..eaadf83667262e 100644
--- a/Python/bltinmodule.c
+++ b/Python/bltinmodule.c
@@ -1969,15 +1969,21 @@ builtin_oct(PyObject *module, PyObject *number)
/*[clinic input]
ord as builtin_ord
- c: object
+ character as c: object
/
-Return the Unicode code point for a one-character string.
+Return the ordinal value of a character.
+
+If the argument is a one-character string, return the Unicode code
+point of that character.
+
+If the argument is a bytes or bytearray object of length 1, return its
+single byte value.
[clinic start generated code]*/
static PyObject *
builtin_ord(PyObject *module, PyObject *c)
-/*[clinic end generated code: output=4fa5e87a323bae71 input=3064e5d6203ad012]*/
+/*[clinic end generated code: output=4fa5e87a323bae71 input=98d38480432e1177]*/
{
long ord;
Py_ssize_t size;
diff --git a/Python/clinic/bltinmodule.c.h b/Python/clinic/bltinmodule.c.h
index f75a8d4ac0ccd4..2abdc6f3ec2ff6 100644
--- a/Python/clinic/bltinmodule.c.h
+++ b/Python/clinic/bltinmodule.c.h
@@ -806,10 +806,16 @@ PyDoc_STRVAR(builtin_oct__doc__,
{"oct", (PyCFunction)builtin_oct, METH_O, builtin_oct__doc__},
PyDoc_STRVAR(builtin_ord__doc__,
-"ord($module, c, /)\n"
+"ord($module, character, /)\n"
"--\n"
"\n"
-"Return the Unicode code point for a one-character string.");
+"Return the ordinal value of a character.\n"
+"\n"
+"If the argument is a one-character string, return the Unicode code\n"
+"point of that character.\n"
+"\n"
+"If the argument is a bytes or bytearray object of length 1, return its\n"
+"single byte value.");
#define BUILTIN_ORD_METHODDEF \
{"ord", (PyCFunction)builtin_ord, METH_O, builtin_ord__doc__},
@@ -1228,4 +1234,4 @@ builtin_issubclass(PyObject *module, PyObject *const
*args, Py_ssize_t nargs)
exit:
return return_value;
}
-/*[clinic end generated code: output=435d3f286a863c49 input=a9049054013a1b77]*/
+/*[clinic end generated code: output=f686ad843368963c input=a9049054013a1b77]*/
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: arch...@mail-archive.com
