From 7e6f8a7f5b8ba9357673235347a497c6ee565261 Mon Sep 17 00:00:00 2001 From: Tomas R Date: Fri, 2 Jan 2026 20:18:32 +0100 Subject: [PATCH] gh-76187: Document the `c` typecode for `multiprocessing.Array`. (GH-132504) * Document the `c` typecode for `multiprocessing.Array`. * Add quotes * Mention that 'w' is not supported (cherry picked from commit 136f6d835588e0f72cecdff855afc8f424381ed5) Co-authored-by: Tomas R. --- Doc/library/multiprocessing.rst | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/Doc/library/multiprocessing.rst b/Doc/library/multiprocessing.rst index e923a8a8df5739..70e493b3d4dc75 100644 --- a/Doc/library/multiprocessing.rst +++ b/Doc/library/multiprocessing.rst @@ -1624,11 +1624,14 @@ inherited by child processes. value is actually a synchronized wrapper for the array. *typecode_or_type* determines the type of the elements of the returned array: - it is either a ctypes type or a one character typecode of the kind used by - the :mod:`array` module. If *size_or_initializer* is an integer, then it - determines the length of the array, and the array will be initially zeroed. - Otherwise, *size_or_initializer* is a sequence which is used to initialize - the array and whose length determines the length of the array. + it is either a :ref:`ctypes type ` or a one + character typecode of the kind used by the :mod:`array` module with the + exception of ``'w'``, which is not supported. In addition, the ``'c'`` + typecode is an alias for :class:`ctypes.c_char`. If *size_or_initializer* + is an integer, then it determines the length of the array, and the array + will be initially zeroed. Otherwise, *size_or_initializer* is a sequence + which is used to initialize the array and whose length determines the length + of the array. If *lock* is ``True`` (the default) then a new lock object is created to synchronize access to the value. If *lock* is a :class:`Lock` or