diff options
| author | Mariatta <Mariatta@users.noreply.github.com> | 2017-05-27 14:23:26 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2017-05-27 14:23:26 (GMT) |
| commit | f931fd1c2ad969db72460d3ab41e3d1a4a62c371 (patch) | |
| tree | bb2fc5383a8aa9ac97c271d6c6aae34a1450fa9c | |
| parent | a92adf8f0782a1ccdc68942767bdb357a9281b30 (diff) | |
| download | cpython-f931fd1c2ad969db72460d3ab41e3d1a4a62c371.zip cpython-f931fd1c2ad969db72460d3ab41e3d1a4a62c371.tar.gz cpython-f931fd1c2ad969db72460d3ab41e3d1a4a62c371.tar.bz2 | |
bpo-30470: Deprecate invalid ctypes call protection on Windows. (GH-1810)
Calling Ctypes functions is deprecated in 3.6.2 and will be removed in 3.7
| -rw-r--r-- | Doc/library/ctypes.rst | 20 | ||||
| -rw-r--r-- | Misc/NEWS | 3 |
2 files changed, 9 insertions, 14 deletions
diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst index b18ce93..edec764 100644 --- a/Doc/library/ctypes.rst +++ b/Doc/library/ctypes.rst @@ -161,22 +161,14 @@ as the NULL pointer):: 0x1d000000 >>> -:mod:`ctypes` tries to protect you from calling functions with the wrong number -of arguments or the wrong calling convention. Unfortunately this only works on -Windows. It does this by examining the stack after the function returns, so -although an error is raised the function *has* been called:: +.. note:: - >>> windll.kernel32.GetModuleHandleA() # doctest: +WINDOWS - Traceback (most recent call last): - File "<stdin>", line 1, in <module> - ValueError: Procedure probably called with not enough arguments (4 bytes missing) - >>> windll.kernel32.GetModuleHandleA(0, 0) # doctest: +WINDOWS - Traceback (most recent call last): - File "<stdin>", line 1, in <module> - ValueError: Procedure probably called with too many arguments (4 bytes in excess) - >>> + :mod:`ctypes` may raise a :exc:`ValueError` after calling the function, if + it detects that an invalid number of arguments were passed. This behavior + should not be relied upon. It is deprecated in 3.6.2, and will be removed + in 3.7. -The same exception is raised when you call an ``stdcall`` function with the +:exc:`ValueError` is raised when you call an ``stdcall`` function with the ``cdecl`` calling convention, or vice versa:: >>> cdll.kernel32.GetModuleHandleA(None) # doctest: +WINDOWS @@ -341,6 +341,9 @@ Extension Modules Library ------- +- bpo-30470: Deprecate invalid ctypes call protection on Windows. Patch by + Mariatta Wijaya. + - bpo-30414: multiprocessing.Queue._feed background running thread do not break from main loop on exception. |