MPI_Comm_create_keyval関数

新しい属性キーを作成します。

構文

int MPIAPI MPI_Comm_create_keyval(
  _In_opt_ MPI_Comm_copy_attr_function   *comm_copy_attr_fn,
  _In_opt_ MPI_Comm_delete_attr_function *comm_delete_attr_fn,
  _Out_    int                           *comm_keyval,
  _In_opt_ void                          *extra_state
);

パラメーター

• comm_copy_attr_fn [in, optional]
  keyval のコールバック関数をコピーします。

• comm_delete_attr_fn [in, optional]
  keyval のコールバック関数を削除します。

• comm_keyval [out]
  将来のアクセスのキー値。

• extra_state [in, optional]
  コールバック関数の追加の状態。

戻り値

MPI_SUCCESS

Fortran

    MPI_COMM_CREATE_KEYVAL(COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN, COMM_KEYVAL,
            EXTRA_STATE, IERROR)
        EXTERNAL COMM_COPY_ATTR_FN, COMM_DELETE_ATTR_FN
        INTEGER COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) EXTRA_STATE

注釈

キー値はグローバルです (任意のコミュニケーターとすべてのコミュニケーターで使用できます)。

既定のコピーおよび削除関数を使用できます。 これらは MPI_COMM_NULL_COPY_FN - 空のコピー関数 MPI_COMM_NULL_DELETE_FN - 空の削除関数 MPI_COMM_DUP_FN - 単純な dup 関数です

C と Fortran には、MPI_Comm_create_keyvalが呼び出されるのと同じ言語でcopy_fnを 記述する必要 がある微妙な違いがあります。 これはほとんどのユーザーにとって問題ではありません。同じプログラムで Fortran と C の両方を使用するプログラム担当者のみが、この規則に従っていることを確認する必要があります。

要件

こちらもご覧ください

MPI キャッシュ関数

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function