diff options
author | Thomas Heller <theller@ctypes.org> | 2008-06-11 18:40:51 (GMT) |
---|---|---|
committer | Thomas Heller <theller@ctypes.org> | 2008-06-11 18:40:51 (GMT) |
commit | 35b90202462b27a783e39762a7ec77ad9f2d7ff8 (patch) | |
tree | bb621170ec9eaf118e160dcde9fea9eac9cdd647 /Doc/library | |
parent | 2e9675adf81bd44ddc29a46f17b8c754d527b12a (diff) | |
download | cpython-35b90202462b27a783e39762a7ec77ad9f2d7ff8.zip cpython-35b90202462b27a783e39762a7ec77ad9f2d7ff8.tar.gz cpython-35b90202462b27a783e39762a7ec77ad9f2d7ff8.tar.bz2 |
Smaller doc fixes.
Diffstat (limited to 'Doc/library')
-rw-r--r-- | Doc/library/ctypes.rst | 35 |
1 files changed, 16 insertions, 19 deletions
diff --git a/Doc/library/ctypes.rst b/Doc/library/ctypes.rst index e17fd24..b968613 100644 --- a/Doc/library/ctypes.rst +++ b/Doc/library/ctypes.rst @@ -1706,16 +1706,14 @@ the windows header file is this:: LPCSTR lpCaption, UINT uType); -Here is the wrapping with ``ctypes``: +Here is the wrapping with ``ctypes``:: - :: - - >>> from ctypes import c_int, WINFUNCTYPE, windll - >>> from ctypes.wintypes import HWND, LPCSTR, UINT - >>> prototype = WINFUNCTYPE(c_int, HWND, LPCSTR, LPCSTR, UINT) - >>> paramflags = (1, "hwnd", 0), (1, "text", "Hi"), (1, "caption", None), (1, "flags", 0) - >>> MessageBox = prototype(("MessageBoxA", windll.user32), paramflags) - >>> + >>> from ctypes import c_int, WINFUNCTYPE, windll + >>> from ctypes.wintypes import HWND, LPCSTR, UINT + >>> prototype = WINFUNCTYPE(c_int, HWND, LPCSTR, LPCSTR, UINT) + >>> paramflags = (1, "hwnd", 0), (1, "text", "Hi"), (1, "caption", None), (1, "flags", 0) + >>> MessageBox = prototype(("MessageBoxA", windll.user32), paramflags) + >>> The MessageBox foreign function can now be called in these ways:: @@ -1733,16 +1731,14 @@ function retrieves the dimensions of a specified window by copying them into HWND hWnd, LPRECT lpRect); -Here is the wrapping with ``ctypes``: +Here is the wrapping with ``ctypes``:: - :: - - >>> from ctypes import POINTER, WINFUNCTYPE, windll, WinError - >>> from ctypes.wintypes import BOOL, HWND, RECT - >>> prototype = WINFUNCTYPE(BOOL, HWND, POINTER(RECT)) - >>> paramflags = (1, "hwnd"), (2, "lprect") - >>> GetWindowRect = prototype(("GetWindowRect", windll.user32), paramflags) - >>> + >>> from ctypes import POINTER, WINFUNCTYPE, windll, WinError + >>> from ctypes.wintypes import BOOL, HWND, RECT + >>> prototype = WINFUNCTYPE(BOOL, HWND, POINTER(RECT)) + >>> paramflags = (1, "hwnd"), (2, "lprect") + >>> GetWindowRect = prototype(("GetWindowRect", windll.user32), paramflags) + >>> Functions with output parameters will automatically return the output parameter value if there is a single one, or a tuple containing the output parameter @@ -1758,6 +1754,7 @@ do the error checking, and raises an exception when the api call failed:: ... if not result: ... raise WinError() ... return args + ... >>> GetWindowRect.errcheck = errcheck >>> @@ -1772,7 +1769,7 @@ instead, the normal processing will no longer take place:: ... raise WinError() ... rc = args[1] ... return rc.left, rc.top, rc.bottom, rc.right - >>> + ... >>> GetWindowRect.errcheck = errcheck >>> |