MPI_Comm_create_keyval funkce

Článek
12/27/2023

Vytvoří nový klíč atributu.

Syntaxe

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
);

Parametry

comm_copy_attr_fn [v, volitelné]
Funkce kopírování zpětného volání pro keyval
comm_delete_attr_fn [v, volitelné]
Odstraňte funkci zpětného volání pro keyval.
comm_keyval [ven]
Hodnota klíče pro budoucí přístup.
extra_state [v, volitelné]
Stav navíc pro funkce zpětného volání

Vrácená hodnota

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

Poznámky

Klíčové hodnoty jsou globální (dostupné pro všechny komunikátory).

K dispozici jsou výchozí funkce kopírování a odstranění. Jedná se o MPI_COMM_NULL_COPY_FN – prázdná funkce kopírování MPI_COMM_NULL_DELETE_FN – prázdná funkce delete MPI_COMM_DUP_FN – jednoduchá funkce dup.

Mezi jazykem C a Fortran jsou drobné rozdíly, které vyžadují, aby copy_fn být napsány ve stejném jazyce, ze kterého je MPI_Comm_create_keyval volána. To by neměl být problém pro většinu uživatelů; Pouze programátoři používající Fortran i C ve stejném programu musí mít jistotu, že toto pravidlo dodržují.

Požadavky

Produkt	HPC Pack 2012 MS-MPI Redistributable Package, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package nebo HPC Pack 2008 Client Utilities
Hlavička	Mpi.h; Mpif.h
Knihovna	Msmpi.lib
DLL	Msmpi.dll

Viz také

Funkce ukládání do mezipaměti MPI

MPI_Comm_copy_attr_function

MPI_Comm_delete_attr_function

Sdílet prostřednictvím