Delen via


MPI_Comm_get_attr functie

Hiermee wordt de kenmerkwaarde opgehaald op basis van sleutel.

Syntaxis

int MPIAPI MPI_Comm_get_attr(
        MPI_Comm comm,
        int      comm_keyval,
  _Out_ void     *attribute_val,
  _Out_ int      *flag
);

Parameters

  • Comm
    Communicator waaraan het kenmerk is gekoppeld.

  • comm_keyval
    Sleutelwaarde.

  • attribute_val [uit]
    Kenmerkwaarde, tenzij vlag = onwaar.

  • vlag [uit]
    Waar als een kenmerkwaarde is geëxtraheerd; false als er geen kenmerk is gekoppeld aan de sleutel.

Retourwaarde

Retourneert MPI_SUCCESS bij succes. Anders is de retourwaarde een foutcode.

In Fortran wordt de retourwaarde opgeslagen in de parameter IERROR .

Fortran

    MPI_COMM_GET_ATTR(COMM, COMM_KEYVAL, ATTRIBUTE_VAL, FLAG, IERROR)
        INTEGER COMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) ATTRIBUTE_VAL
        LOGICAL FLAG

Opmerkingen

Kenmerken moeten worden geëxtraheerd uit dezelfde taal als waarin ze zijn ingevoegd met MPI_Comm_set_attr. Hoewel het argument attribute_val is gedeclareerd als ongeldige aanwijzer, is het in feite het adres van een ongeldige aanwijzer. Zie de reden in de standaard voor meer informatie.

Vereisten

Product

HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package of HPC Pack 2008 Client Utilities

Header

Mpi.h; Mpif.h

Bibliotheek

Msmpi.lib

DLL

Msmpi.dll

Zie ook

MPI-cachefuncties