From 8f06247b51924245ff1777bbf46aee9f38237c8e Mon Sep 17 00:00:00 2001
From: Guido van Rossum <guido@python.org>
Date: Thu, 14 Aug 1997 19:50:37 +0000
Subject: Added buffer_info() docs.

---
 Doc/lib/libarray.tex | 10 ++++++++++
 1 file changed, 10 insertions(+)

(limited to 'Doc/lib/libarray.tex')

diff --git a/Doc/lib/libarray.tex b/Doc/lib/libarray.tex
index eb76251645..145bb4f702 100644
--- a/Doc/lib/libarray.tex
+++ b/Doc/lib/libarray.tex
@@ -60,6 +60,16 @@ The length in bytes of one array item in the internal representation.
 Append a new item with value \var{x} to the end of the array.
 \end{funcdesc}
 
+\begin{funcdesc}{buffer_info}{}
+Return a tuple \code{(\var{address}, var{length})} giving the current
+memory address and the length in bytes of the buffer used to hold
+array's contents.  This is occasionally useful when working with
+low-level (and inherently unsafe) I/O interfaces that require memory
+addresses, such as certain \code{ioctl} operations.  The returned
+numbers are valid as long as the array exists and no length-changing
+operations are applied to it.
+\end{funcdesc}
+
 \begin{funcdesc}{byteswap}{x}
 ``Byteswap'' all items of the array.  This is only supported for
 integer values.  It is useful when reading data from a file written
-- 
cgit v1.2.1

