Send data asynchronously over a connection (Socket, Context or Stream).
send_aio(con, data, mode = c("serial", "raw", "next"), timeout = NULL)a Socket, Context or Stream.
an object (a vector, if mode = 'raw').
[default 'serial'] one of 'serial' to send serialised R objects, 'raw' to send atomic vectors of any type as a raw byte vector, or 'next' to send in a new R-compatible serialisation format. For Streams, 'raw' is the only option and this argument is ignored. Use 'serial' to ensure perfect reproducibility within R, although 'raw' must be used when interfacing with external applications which do not understand R serialisation. Alternatively, for performance, specify an integer position in the vector of choices e.g. 1L for 'serial' or 2L for 'raw' etc.
[default NULL] integer value in milliseconds or NULL, which applies a socket-specific default, usually the same as no timeout.
A 'sendAio' (object of class 'sendAio') (invisibly).
Async send is always non-blocking and returns a 'sendAio' immediately.
For a 'sendAio', the send result is available at $result. An
'unresolved' logical NA is returned if the async operation is yet to
complete. The resolved value will be zero on success, or else an integer
error code.
To wait for and check the result of the send operation, use
call_aio on the returned 'sendAio' object.
Alternatively, to stop the async operation, use stop_aio.
pub <- socket("pub", dial = "inproc://nanonext")
res <- send_aio(pub, data.frame(a = 1, b = 2), timeout = 100)
res
#> < sendAio >
#> - $result for send result
res$result
#> [1] 0
res <- send_aio(pub, "example message", mode = "raw", timeout = 100)
call_aio(res)$result
#> [1] 0
close(pub)