mpi4py 中的 info 和 assertion

本文从本人简书博客同步过来

在上一篇中我们介绍了 mpi4py 中的错误处理，下面我们将介绍 mpi4py 中的 info 和 assertion。

MPI 允许用户提供两种类型的与应用有关的信息：hints 和 assertions。hints 是应用中所做的有助于提高程序性能的选项，MPI 实现可以忽略用户提供的 hints 而不影响程序的正确性；assertions 是用户（编程者）给 MPI 实现的有关其应用程序行为的保证——如果程序给出的某个 assertion 并不正确，MPI 实现可能会产生错误的结果。在 MPI 中大多数的 hints 都是通过 MPI.Info 对象传递给 MPI 实现的，而 assertions 则是传递给一些 MPI 函数/方法的整数值。用户可以不提供 hints 或 assertions，应用程序可以在不提供它们的情况下正确运行，但是，提供合适的 hints 或正确的 assertions 可以提高应用程序的性能。hints 和 assetions 都是可移植的。除了 MPI 标准提供的 hints 外，不同的 MPI 实现可能会定义额外的不同的 hints，用户应该查看相关的文档以了解可用的 hints 及其作用。

MPI-2 引进了 Info 对象，MPI 中的很多函数都使用了 info 参数，Info 参数以 <key，value> 字符串二元组的形式定义信息。MPI 本身也使用一些预留的关键字来保存环境与外部交互，以及其他一些属性信息。关键字和值分别由 MPI.MAX_INFO_KEY 和 MPI.MAX_INFO_VAL 定义上限。

hints 和 Info 对象

一般接口

MPI.Info.Create(type cls)

创建一个 Info 对象，将其 <key，value> 二元组初始化为空。

MPI.Info.Dup(self)

复制当前 Info 对象，包括其中的 <key，value> 二元组。

MPI.Info.Delete(self, key)

从当前 Info 对象中删除 <key，value> 二元组，如果 key 参数指定的关键字不存在，则会抛出 MPI.Exception 异常。

MPI.Info.Free(self)

删除并释放当前 Info 对象，将其值设置为 MPI.INFO_NULL。

MPI.Info.Set(self, key, value)

为当前 Info 对象设置二元组 <key，value>，如果 key 所指定的关键字已经存在，则覆盖其原有的值。如果 key 或 value 参数的字符串长度超过上限，则会抛出 MPI.Exception 异常。

MPI.Info.Get(self, key, int maxlen=-1)

从当前 Info 对象中获取关键字 key 的值，如果该关键字不存在，则返回 None。maxlen 是获取的值的最大长度，如果该长度小于值的实际长度，则返回的是被截断的值，maxlen 如果为小于 0 或大于 MPI.MAX_INFO_VAL，则会使用 MPI.MAX_INFO_VAL。

MPI.Info.Get_nkeys(self)

返回当前 Info 对象中定义的关键字总数。

MPI.Info.Get_nthkey(self, int n)

返回当前 Info 对象中第 n