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

Determine whether a message from the given source and with the specified tag is available, but don't try to receive the message. This routine will return immediately, regardless of whether a message is available, so it is useful for polling to determine whether any messages need to be handled at this time. If your program can't do any work until a message arrives (and the message is guaranteed to arrive, eventually), use Probe(Int32, Int32) instead.

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

Syntax

C#
public Status ImmediateProbe(
	int source,
	int tag
)
Visual Basic (Declaration)
Public Function ImmediateProbe ( _
	source As Integer, _
	tag As Integer _
) As Status
Visual C++
public:
Status^ ImmediateProbe(
	int source, 
	int tag
)

Parameters

source
Type: System..::.Int32
The process that sent (or that will send) the message. This must be a value in [0, Size-1), or the special value anySource. If it is anySource, then we can match a message sent by any other process in this communicator.
tag
Type: System..::.Int32
A message "tag" that identifies this particular kind of message. Only messages sent with this tag will be matched by this call. The special value anyTag permits messages sent with any tag value to be received.

Return Value

If a message is available, a Status object containing information about that message. Otherwise, returns null.

See Also