[3.12] gh-107659: Improve wording of the description of ctypes.pointer and ctypes.POINTER (GH-107769) (#108163)

gh-107659: Improve wording of the description of `ctypes.pointer` and `ctypes.POINTER` (GH-107769)
(cherry picked from commit beffb30dc7)

Co-authored-by: Tomas R <tomas.roun8@gmail.com>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Kumar Aditya <kumaraditya@python.org>
This commit is contained in:
Miss Islington (bot) 2023-08-20 06:50:09 -07:00 committed by GitHub
parent fbe1cff015
commit 590bc6a226
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -2029,17 +2029,17 @@ Utility functions
specifying an address, or a ctypes instance. specifying an address, or a ctypes instance.
.. function:: POINTER(type) .. function:: POINTER(type, /)
This factory function creates and returns a new ctypes pointer type. Pointer Create and return a new ctypes pointer type. Pointer types are cached and
types are cached and reused internally, so calling this function repeatedly is reused internally, so calling this function repeatedly is cheap.
cheap. *type* must be a ctypes type. *type* must be a ctypes type.
.. function:: pointer(obj) .. function:: pointer(obj, /)
This function creates a new pointer instance, pointing to *obj*. The returned Create a new pointer instance, pointing to *obj*.
object is of the type ``POINTER(type(obj))``. The returned object is of the type ``POINTER(type(obj))``.
Note: If you just want to pass a pointer to an object to a foreign function Note: If you just want to pass a pointer to an object to a foreign function
call, you should use ``byref(obj)`` which is much faster. call, you should use ``byref(obj)`` which is much faster.