MPI_Bsend 函数

项目
12/27/2023

将数据发送到缓冲模式下的指定进程。当可以安全地重用发送缓冲区时，此函数将返回。

语法

int MPIAPI MPI_Bsend(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

参数

buf [in， optional]
指向包含要发送的数据的缓冲区的指针。
计数
缓冲区数组中的元素数。如果消息的数据部分为空，请将 count 参数设置为 0。
datatype
缓冲区中元素的数据类型。
dest
通信器中由 comm 参数指定的目标进程的排名。
标签
可用于区分不同类型的消息的消息标记。
comm
通信器的句柄。

返回值

返回成功 时MPI_SUCCESS 。否则，返回值为错误代码。

在 Fortran 中，返回值存储在 IERROR 参数中。

Fortran

    MPI_BSEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

注解

此函数是本地函数，它可以成功完成发送操作，而不会发生匹配的接收操作。

无论是否已发布匹配的接收操作，都可以启动此函数。它可以在发布匹配的接收之前完成发送操作。其完成不依赖于匹配的接收操作的发生。如果调用此函数且未发布匹配的接收操作，则 MPI 实现必须缓冲传出消息，以便发送调用可以返回。

如果缓冲区空间不足，此函数将返回错误。可用缓冲区空间量由用户使用 MPI_Buffer_attach 函数控制。

要求

产品	HPC Pack 2012 MS-MPI 可再发行程序包、HPC Pack 2008 R2 MS-MPI 可再发行程序包、HPC Pack 2008 MS-MPI 可再发行程序包或 HPC Pack 2008 客户端实用工具
标头	Mpi.h;Mpif.h
库	Msmpi.lib
DLL	Msmpi.dll