在上一篇中我们介绍了 mpi4py 中的 info 和 assertion，下面我们将介绍 mpi4py 中的 Status 对象。

在 MPI-1 中，Status 对象仅用于点到点通信，而 MPI-2 则在通用化请求以及并行 I/O 中使用 Status 对象。因此新的 MPI.Status 对象在不同上下文环境下，可能存在有效域或无效域，特别是在通用化请求操作中，应用程序需要在回调函数中设置某些状态信息。为管理泛化后的 MPI.Status 对象，MPI-2 新增加了下列函数：MPI.Status.Set_elements 和 MPI.Status.Set_cancelled。

需要注意的是，Status 对象最好对应每个操作单独使用，而不推荐复用的方式。此外，如果在通用化请求中需要传递额外信息，则不应修改 Status 对象中各域的语义，而推荐借助 extra_status 参数传递信息。通用化请求将在下一篇中介绍。

下面给出 MPI.Status 对象的方法接口。

MPI.Status.Get_source(self)

获得并返回接收消息的源。也可以通过属性 source 获取。

MPI.Status.Set_source(self, int source)

设置接收消息的源。也可以通过属性 source 设置。

MPI.Status.Get_tag(self)

获得并返回接收消息的 tag。也可以通过属性 tag 获取。

MPI.Status.Set_tag(self, int tag)

设置接收消息的tag。也可以通过属性 tag 设置。

MPI.Status.Get_error(self)

获得接收消息的错误。也可以通过属性 error 获取。

MPI.Status.Set_error(self, int error)

设置接收消息的错误。也可以通过属性 error 设置。

MPI.Status.Get_count(self, Datatype datatype=BYTE)

返回接收到的元素个数（以 datatype 为单位计算）。如果 datatype 的 size 为 0，该方法也会返回 0；如果接收到的数据不是 datatype 的整数倍，则会返回 MPI.UNDEFINED。也可以通过属性 count 获取以 MPI.BYTE 为单位的计数。

MPI.Status.Get_elements(self, Datatype datatype)

返回 datatype 中的基本数据类型的个数。如果支持 MPI-3，mpi4py 实际调用的是 MPI_Get_elements_x 以支持大的计数。

MPI.Status.Set_elements(self, Datatype datatype, Count count)

设置 datatype 中的基本数据类型的个数。如果支持 MPI-3，mpi4py 实际调用的是 MPI_Status_set_elements_x 以支持大的计数。

MPI.Status.Is_cancelled(self)

检测某个通信请求是否被取消。也可用通过属性 cancelled 来查询。

MPI.Status.Set_cancelled(self, bool flag)

将取消状态设置为 flag。注意：该方法只能用于通用化请求的回调函数中。

例程

下面给出使用例程。

# status.py

"""
Demonstrates the usage of MPI.Status.

Run this with 2 processes like:
$ mpiexec -n 2 python status.py
"""

import numpy as np
from mpi4py import MPI


comm = MPI.COMM_WORLD
rank = comm.rank

status = MPI.Status()
print 'status.source == MPI.ANY_SOURCE:', status.source == MPI.ANY_SOURCE
print 'status.tag == MPI.ANY_TAG:', status.tag == MPI.ANY_TAG
print 'status.error == MPI.SUCCESS:', status.error == MPI.SUCCESS
print 'MPI.UNDEFINED = %d' % MPI.UNDEFINED

comm.Barrier()

if rank == 0:
    send_buf = np.arange(10, dtype='i')
    # send 10 MPI.INTs, 40 MPI.BYTEs
    comm.Send(send_buf, dest=1, tag=0)

    # create a datatype and send it (multiple of sizeof(int))
    send_type = MPI.Datatype.Create_struct([1, 16], [0, 4], [MPI.INT, MPI.CHAR])
    send_type.Commit()
    # send 1 MPI.INT, 16 MPI.CHARs (= 4 MPI.INTs), 1 + 16 basic elements
    comm.Send([send_buf, 1, send_type], dest=1, tag=1)
    send_type.Free()

    # create a datatype and send it (not a multiple of sizeof(int))
    send_type = MPI.Datatype.Create_struct([1, 17], [0, 4], [MPI.INT, MPI.CHAR])
    send_type.Commit()
    # send 1 MPI.INT, 17 MPI.CHARs (not a multiple of MPI.INT), 1 + 17 basic elements
    comm.Send([send_buf, 1, send_type], dest=1, tag=2)
    send_type.Free()
elif rank == 1:
    recv_buf = np.full(10, -1, dtype='i')
    # receive 10 ints
    status = MPI.Status()
    comm.Recv(recv_buf, source=0, tag=0, status=status)
    print
    print 'Get count with MPI.INT:', status.Get_count(MPI.INT)
    print 'Get elements with MPI.INT:', status.Get_elements(MPI.INT)
    print 'Get count with MPI.BYTE:', status.Get_count(MPI.BYTE)
    print 'Get elements with MPI.BYTE:', status.Get_elements(MPI.BYTE)
    print

    # create a datatype and receive it
    recv_type = MPI.Datatype.Create_struct([1, 36], [0, 4], [MPI.INT, MPI.CHAR])
    recv_type.Commit()
    status = MPI.Status()
    comm.Recv([recv_buf, 1, recv_type], source=0, tag=1, status=status)
    print 'Get count with MPI.INT:', status.Get_count(MPI.INT)
    print 'Get elements with MPI.INT:', status.Get_elements(MPI.INT)
    print 'Get count with recv_type:', status.Get_count(recv_type)
    print 'Get elements with recv_type:', status.Get_elements(recv_type)
    print

    status = MPI.Status()
    comm.Recv([recv_buf, 1, recv_type], source=0, tag=2, status=status)
    print 'Get count with MPI.INT:', status.Get_count(MPI.INT)
    print 'Get elements with MPI.INT:', status.Get_elements(MPI.INT)
    print 'Get count with recv_type:', status.Get_count(recv_type)
    print 'Get elements with recv_type:', status.Get_elements(recv_type)

    recv_type.Free()

运行结果如下：

$ mpiexec -n 2 python status.py
status.source == MPI.ANY_SOURCE: True
status.tag == MPI.ANY_TAG: True
status.error == MPI.SUCCESS: True
MPI.UNDEFINED = -32766
status.source == MPI.ANY_SOURCE: True
status.tag == MPI.ANY_TAG: True
status.error == MPI.SUCCESS: True
MPI.UNDEFINED = -32766

Get count with MPI.INT: 10
Get elements with MPI.INT: 10
Get count with MPI.BYTE: 40
Get elements with MPI.BYTE: 40

Get count with MPI.INT: 5
Get elements with MPI.INT: 5
Get count with recv_type: -32766
Get elements with recv_type: 17

Get count with MPI.INT: -32766
Get elements with MPI.INT: -32766
Get count with recv_type: -32766
Get elements with recv_type: 18

以上介绍了 mpi4py 中的 Status 对象，在下一篇中我们将介绍 mpi4py 中的通用化请求。