Teuchos - Trilinos Tools Package Version of the Day
Loading...
Searching...
No Matches
Public Member Functions | List of all members
Teuchos::MpiCommRequest< OrdinalType > Class Template Reference

MPI implementation of CommRequest. More...

#include <Teuchos_DefaultMpiComm_decl.hpp>

Inheritance diagram for Teuchos::MpiCommRequest< OrdinalType >:
Teuchos::MpiCommRequestBase< OrdinalType > Teuchos::CommRequest< OrdinalType > Teuchos::Describable Teuchos::LabeledObject

Public Member Functions

 MpiCommRequest ()
 Default constructor.
 
 MpiCommRequest (MPI_Request rawMpiRequest, const ArrayView< char >::size_type numBytesInMessage)
 Constructor (from a raw MPI_Request).
 
ArrayView< char >::size_type numBytes () const
 Number of bytes in the nonblocking send or receive request.
 
virtual ~MpiCommRequest ()
 Destructor; cancels the request if it is still pending.
 
- Public Member Functions inherited from Teuchos::MpiCommRequestBase< OrdinalType >
 MpiCommRequestBase ()
 Default constructor.
 
 MpiCommRequestBase (MPI_Request rawMpiRequest)
 Constructor (from a raw MPI_Request).
 
MPI_Request releaseRawMpiRequest ()
 Return and relinquish ownership of the raw MPI_Request.
 
bool isNull () const
 Whether the raw MPI_Request is MPI_REQUEST_NULL.
 
RCP< CommStatus< OrdinalType > > wait ()
 Wait on this communication request to complete.
 
RCP< CommStatus< OrdinalType > > cancel ()
 Cancel the communication request, and return its status.
 
virtual ~MpiCommRequestBase ()
 Destructor; cancels the request if it is still pending.
 
- Public Member Functions inherited from Teuchos::CommRequest< OrdinalType >
virtual ~CommRequest ()
 Destructor; cancels the request if it is still pending.
 
- Public Member Functions inherited from Teuchos::Describable
virtual std::string description () const
 Return a simple one-line description of this object.
 
virtual void describe (FancyOStream &out, const EVerbosityLevel verbLevel=verbLevel_default) const
 Print the object with some verbosity level to a FancyOStream.
 
void describe (std::ostream &out, const EVerbosityLevel verbLevel=verbLevel_default) const
 Version of describe() that takes an std::ostream instead of a FancyOStream.
 
virtual ~Describable ()
 Destructor (marked virtual for memory safety of derived classes).
 
- Public Member Functions inherited from Teuchos::LabeledObject
 LabeledObject ()
 Construct with an empty label.
 
virtual ~LabeledObject ()
 
virtual void setObjectLabel (const std::string &objectLabel)
 Set the object label (see LabeledObject).
 
virtual std::string getObjectLabel () const
 Get the object label (see LabeledObject).
 

Additional Inherited Members

- Static Public Attributes inherited from Teuchos::Describable
static const EVerbosityLevel verbLevel_default = VERB_DEFAULT
 Default value for the verbLevel argument of describe().
 

Detailed Description

template<class OrdinalType>
class Teuchos::MpiCommRequest< OrdinalType >

MPI implementation of CommRequest.

Template Parameters
OrdinalTypeSame as the template parameter of Comm.

This class wraps MPI_Request, which is MPI's reification of a nonblocking communication operation.

Users would not normally create an instance of this class. Calls to nonblocking communication operations (such as ireceive() or isend()) return a pointer to a CommRequest. If the Comm is an MpiComm, then the returned CommRequest is an MpiCommRequest.

Users might wish to create an MpiCommRequest directly if they want to encapsulate an MPI_Request returned by an external library or by their own code.

Definition at line 136 of file Teuchos_DefaultMpiComm_decl.hpp.

Constructor & Destructor Documentation

◆ MpiCommRequest() [1/2]

template<class OrdinalType >
Teuchos::MpiCommRequest< OrdinalType >::MpiCommRequest ( )

Default constructor.

◆ MpiCommRequest() [2/2]

template<class OrdinalType >
Teuchos::MpiCommRequest< OrdinalType >::MpiCommRequest ( MPI_Request  rawMpiRequest,
const ArrayView< char >::size_type  numBytesInMessage 
)

Constructor (from a raw MPI_Request).

◆ ~MpiCommRequest()

Destructor; cancels the request if it is still pending.

Member Function Documentation

◆ numBytes()

template<class OrdinalType >
ArrayView< char >::size_type Teuchos::MpiCommRequest< OrdinalType >::numBytes ( ) const

Number of bytes in the nonblocking send or receive request.

Remembering this is inexpensive, and is also useful for debugging (e.g., for detecting whether the send and receive have matching message lengths).


The documentation for this class was generated from the following file: