MPI_Comm_size関数
コミュニケーターに関係するプロセスの数、または使用可能なプロセスの合計数を取得します。
構文
int MPIAPI MPI_Comm_size(
MPI_Comm comm,
_Out_ int *size
);
パラメーター
comm
評価するコミュニケーター。 使用可能なプロセスの合計数を取得するには、MPI_COMM_WORLD定数を指定します。size [out]
戻り時に、コミュニケーターのグループ内のプロセスの数を示します。
戻り値
成功 したMPI_SUCCESS を返します。 それ以外の場合、戻り値はエラー コードです。
Fortran では、戻り値は IERROR パラメーターに格納されます。
Fortran
MPI_COMM_SIZE(COMM,SIZE,IERROR)
INTEGER COMM, SIZE, IERROR
注釈
この関数を使用すると、ユーザーは 1 つの関数呼び出しでグループ サイズを取得できます。 それ以外の場合は、 MPI_Comm_group 関数を使用して一時グループを作成し、 MPI_Group_size 関数を使用してグループのサイズを取得し、 MPI_Group_free 関数を使用して一時グループを解放する必要があります。
この関数は、多くの場合、特定のライブラリまたはプログラムで使用できるコンカレンシーの量を決定するために、 MPI_Comm_rank 関数と共に使用されます。 MPI_Comm_rank関数は、0 から size-1 までの範囲で呼び出すプロセスのランクを示します。ここで、size は MPI_Comm_size 関数を使用して取得されます。
Note
初期化が行われた後にプロセスの数を変更する標準的な方法はありません。
要件
製品 |
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 |