Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cpython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
0
Issues
0
List
Boards
Labels
Milestones
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Kirill Smelkov
cpython
Commits
ab792ac7
Commit
ab792ac7
authored
9 years ago
by
Larry Hastings
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Doc clarification / edification on the semantics of the 'w*' format unit.
parent
8d11ccce
No related merge requests found
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
12 additions
and
5 deletions
+12
-5
Doc/c-api/arg.rst
Doc/c-api/arg.rst
+1
-1
Doc/glossary.rst
Doc/glossary.rst
+11
-4
No files found.
Doc/c-api/arg.rst
View file @
ab792ac7
...
...
@@ -152,7 +152,7 @@ Unless otherwise stated, buffers are not NUL-terminated.
any conversion. Raises :exc:`TypeError` if the object is not a Unicode
object. The C variable may also be declared as :c:type:`PyObject\*`.
``w*`` (
:class:`bytearray` or read-write byte-oriented buffer
) [Py_buffer]
``w*`` (
read-write :term:`bytes-like object`
) [Py_buffer]
This format accepts any object which implements the read-write buffer
interface. It fills a :c:type:`Py_buffer` structure provided by the caller.
The buffer may contain embedded null bytes. The caller have to call
...
...
This diff is collapsed.
Click to expand it.
Doc/glossary.rst
View file @
ab792ac7
...
...
@@ -88,10 +88,17 @@ Glossary
bytes
-
like
object
An
object
that
supports
the
:
ref
:`
bufferobjects
`,
like
:
class
:`
bytes
`,
:
class
:`
bytearray
`
or
:
class
:`
memoryview
`.
Bytes
-
like
objects
can
be
used
for
various
operations
that
expect
binary
data
,
such
as
compression
,
saving
to
a
binary
file
or
sending
over
a
socket
.
Some
operations
need
the
binary
data
to
be
mutable
,
in
which
case
not
all
bytes
-
like
objects
can
apply
.
be
used
for
various
operations
that
work
with
binary
data
;
these
include
compression
,
saving
to
a
binary
file
,
and
sending
over
a
socket
.
Some
operations
need
the
binary
data
to
be
mutable
.
The
documentation
often
refers
to
these
as
"read-write bytes-like objects"
.
Example
mutable
buffer
objects
include
:
class
:`
bytearray
`
and
a
:
class
:`
memoryview
`
of
a
:
class
:`
bytearray
`.
Other
operations
require
the
binary
data
to
be
stored
in
immutable
objects
(
"read-only bytes-like objects"
);
examples
of
these
include
:
class
:`
bytes
`
and
a
:
class
:`
memoryview
`
of
a
:
class
:`
bytes
`
object
.
bytecode
Python
source
code
is
compiled
into
bytecode
,
the
internal
representation
...
...
This diff is collapsed.
Click to expand it.
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment