merge the io-c branch: C implementation of the io module · python/cpython@4fa88fa (original) (raw)

`@@ -6,6 +6,8 @@

`

6

6

`.. moduleauthor:: Guido van Rossum guido@python.org

`

7

7

`.. moduleauthor:: Mike Verdone mike.verdone@gmail.com

`

8

8

`.. moduleauthor:: Mark Russell mark.russell@zen.co.uk

`

``

9

`+

.. moduleauthor:: Antoine Pitrou solipsis@pitrou.net

`

``

10

`+

.. moduleauthor:: Amaury Forgeot d'Arc amauryfa@gmail.com

`

9

11

`.. sectionauthor:: Benjamin Peterson benjamin@python.org

`

10

12

``

11

13

`` The :mod:io module provides the Python interfaces to stream handling. The

``

`@@ -364,6 +366,11 @@ I/O Base Classes

`

364

366

`` A :exc:BlockingIOError is raised if the underlying raw stream has no

``

365

367

` data at the moment.

`

366

368

``

``

369

`+

.. method:: read1([n])

`

``

370

+

``

371

`+

Read and return up to n bytes, with at most one call to the underlying

`

``

372

`` +

raw stream's :meth:~RawIOBase.read method.

``

``

373

+

367

374

` .. method:: readinto(b)

`

368

375

``

369

376

` Read up to len(b) bytes into bytearray b and return the number of bytes

`

`@@ -501,7 +508,7 @@ Buffered Streams

`

501

508

``

502

509

`` The constructor creates a :class:BufferedWriter for the given writeable

``

503

510

` raw stream. If the buffer_size is not given, it defaults to

`

504

``

`` -

:data:DEAFULT_BUFFER_SIZE. If max_buffer_size is omitted, it defaults to

``

``

511

`` +

:data:DEFAULT_BUFFER_SIZE. If max_buffer_size is omitted, it defaults to

``

505

512

` twice the buffer size.

`

506

513

``

507

514

`` :class:BufferedWriter provides or overrides these methods in addition to

``