共用方式為

MPI_Comm_get_name函式

  • 發行項

從 communicator 傳回列印名稱。

語法

int MPIAPI MPI_Comm_get_name(
        MPI_Comm                                                    comm,
        _Out_z_cap_post_count_(MPI_MAX_OBJECT_NAME,*resultlen) char *comm_name,
  _Out_ int                                                         *resultlen
);

參數

  • 通訊
    要取得名稱的 Communicator。

  • comm_name
    在輸出中，包含 communicator 的名稱。 它必須是大小至少 MPI_MAX_OBJECT_NAME的數位。

  • resultlen [out]
    名稱中的字元數。

傳回值

傳回成功 時MPI_SUCCESS 。 否則，傳回值是錯誤碼。

在 Fortran 中，傳回值會儲存在 IERROR 參數中。

Fortran

    MPI_COMM_GET_NAME(COMM, COMM_NAME, RESULTLEN, IERROR)
        INTEGER COMM, RESULTLEN, IERROR
        CHARACTER*(*) COMM_NAME

規格需求

產品

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

另請參閱

MPI 其他函式