receive Method

Reads a portion of received data into a string.

Syntax

def receive() -> str: ...

Remarks

Use this method to read out a piece of data received from the server into a string.

Note that in synchronous mode this method may block in the absence of any inbound data until the next piece of data is received from the server. Use poll to check if there is any data in the connection that is immediately available for reading.

In asynchronous mode a good time to call this method is upon receiving a read notification in on_data_received event handler. When working in asynchronous mode, this call returns immediately.

This method only returns data that arrives via the stdout channel. Use receive_from to read stderr data.