djsundog
/
circuitpython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs/library: Add description of "index" parameter to uos.dupterm().

This commit is contained in:
Damien George 2017-06-14 16:02:57 +10:00
parent 6568001c00
commit e30ba2f1c7
1 changed files with 18 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/library/uos.rst
View File

@ -89,8 +89,22 @@ Functions
Return a bytes object with n random bytes. Whenever possible, it is Return a bytes object with n random bytes. Whenever possible, it is
generated by the hardware random number generator. generated by the hardware random number generator.
.. function:: dupterm(stream_object) .. function:: dupterm(stream_object, index=0)
Duplicate or switch MicroPython terminal (the REPL) on the passed stream-like Duplicate or switch the MicroPython terminal (the REPL) on the given stream-like
object. The given object must implement the ``readinto()`` and ``write()`` object. The *stream_object* argument must implement the ``readinto()`` and
methods. If ``None`` is passed, previously set redirection is cancelled. ``write()`` methods. The stream should be in non-blocking mode and
``readinto()`` should return ``None`` if there is no data available for reading.
After calling this function all terminal output is repeated on this stream,
and any input that is available on the stream is passed on to the terminal input.
The *index* parameter should be a non-negative integer and specifies which
duplication slot is set. A given port may implement more than one slot (slot 0
will always be available) and in that case terminal input and output is
duplicated on all the slots that are set.
If ``None`` is passed as the *stream_object* then duplication is cancelled on
the slot given by *index*.
The function returns the previous stream-like object in the given slot.