a0IFPut()

Starts a non-blocking put to a pipe.


Syntax

a0tError a0IFPut(
a0tPipe *pipe,
a0tRequest *request,
a0tFormat *format,
void *address,
int count );

Arguments

Namerd/wrDescription
pipe read Pipe to put to.
request write Request descriptor to hold the status.
format read Format of the data to send.
address write Address of the data to send.
count read Number of elements to send.

Description

This starts a non-blocking put to a given pipe pipe. A request is posted to send the data described by format, starting at address, with count elements. This request can cause a message to be immediately sent to the destination node or not, depending on the protocol used and the space left in the buffer of the pipe.

On return of this function, the variable pointed by request contains an opaque request that can be used later to test or wait the completion or check the status of the operation.


Return Values

If an error condition occurs, it returns the error code, otherwise it returns A0ErrOk. Possible values are as follows:
Error CodeDescription
A0Err...Some error occurred.
A0ErrOkSuccessful completion.

See Also

a0FPut() a0IFGet() a0FGet() a0IFSend() a0UseFormats() a0NewMapFormat() a0NewFunctionFormat() a0NewPipe() a0WaitRequest() a0TestRequest()