MPI_Comm_get_attr, funkcja

Pobiera wartość atrybutu według klucza.

Składnia

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

Parametry

• Comm
  Komunikator, do którego jest dołączony atrybut.

• comm_keyval
  Wartość klucza.

• attribute_val [out]
  Wartość atrybutu, chyba że flaga = false.

• flaga [out]
  Prawda, jeśli wyodrębniono wartość atrybutu; false, jeśli żaden atrybut nie jest skojarzony z kluczem.

Wartość zwracana

Zwraca MPI_SUCCESS po powodzeniu. W przeciwnym razie zwracana wartość jest kodem błędu.

W fortran wartość zwracana jest przechowywana w parametrze 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

Uwagi

Atrybuty muszą zostać wyodrębnione z tego samego języka, w jakim zostały wstawione za pomocą MPI_Comm_set_attr. Mimo że argument attribute_val jest zadeklarowany jako wskaźnik pustki , jest to naprawdę adres wskaźnika pustki. Aby uzyskać więcej informacji, zobacz uzasadnienie w standardzie.

Wymagania

Produkt	Pakiet redystrybucyjny HPC Pack 2012 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 R2 MS-MPI, pakiet redystrybucyjny HPC Pack 2008 MS-MPI lub narzędzia klienckie HPC Pack 2008
Nagłówek	Mpi.h; Mpif.h
Biblioteka	Msmpi.lib
DLL	Msmpi.dll

Zobacz też

Funkcje buforowania MPI