diff options
| author | Stefan Krah <skrah@bytereef.org> | 2014-04-26 20:50:25 (GMT) |
|---|---|---|
| committer | Stefan Krah <skrah@bytereef.org> | 2014-04-26 20:50:25 (GMT) |
| commit | 32ae4378b945b55d482539f83fdd0aeac8b6f375 (patch) | |
| tree | 52c7606056cd2ae7bf26736353d4a0d8573b318e | |
| parent | 807c9da951e8596e9b9c90e4406b7087a2cdef04 (diff) | |
| download | cpython-32ae4378b945b55d482539f83fdd0aeac8b6f375.zip cpython-32ae4378b945b55d482539f83fdd0aeac8b6f375.tar.gz cpython-32ae4378b945b55d482539f83fdd0aeac8b6f375.tar.bz2 | |
Issue #17145: Document array.array buffer interface limitations.
| -rw-r--r-- | Doc/c-api/buffer.rst | 6 |
1 files changed, 4 insertions, 2 deletions
diff --git a/Doc/c-api/buffer.rst b/Doc/c-api/buffer.rst index e028369..74693ac 100644 --- a/Doc/c-api/buffer.rst +++ b/Doc/c-api/buffer.rst @@ -21,8 +21,10 @@ first. Two examples of objects that support the buffer interface are strings and arrays. The string object exposes the character contents in the buffer -interface's byte-oriented form. An array can also expose its contents, but it -should be noted that array elements may be multi-byte values. +interface's byte-oriented form. An array can only expose its contents via the +old-style buffer interface. This limitation does not apply to Python 3, +where :class:`memoryview` objects can be constructed from arrays, too. +Array elements may be multi-byte values. An example user of the buffer interface is the file object's :meth:`write` method. Any object that can export a series of bytes through the buffer |