[This is preliminary documentation and is subject to change.]

Non-blocking receive of an array of values. This routine will initiate a request to receive data and then return immediately. The data may be received in the background. To test for or force the completion of the communication, then access the received data, use the returned ReceiveRequest object.

Namespace:  MPI
Assembly:  MPI (in MPI.dll)
Version: (


public ReceiveRequest ImmediateReceive<T>(
	int source,
	int tag,
	T[] values
Visual Basic (Declaration)
Public Function ImmediateReceive(Of T) ( _
	source As Integer, _
	tag As Integer, _
	values As T() _
) As ReceiveRequest
Visual C++
generic<typename T>
ReceiveRequest^ ImmediateReceive(
	int source, 
	int tag, 
	array<T>^ values


Type: System..::.Int32
Rank of the source process to receive data from. Alternatively, use anySource to receive a message from any other process.
Type: System..::.Int32
The tag that identifies the message to be received. Alternatively, use anyTag to receive a message with any tag.
Type: array< T >[]()[]
An array into which the values will be received. This array must be large enough to accommodate all of the data sent by the source process.

Type Parameters

Any serializable type.

Return Value

A request object that allows one to test or force the completion of this receive request, and retrieve the resulting value. The object retrieved from the request object will be values.

See Also