Função MPI_Compare_and_swap

Executa uma operação remota de comparação e troca atômica.

Sintaxe

int MPIAPI MPI_Compare_and_swap(
  _In_  void         *origin_addr,
  _In_  void         *compare_addr,
  _Out_ void         *result_addr,
        MPI_Datatype datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        MPI_Win      win
);

Parâmetros

• origin_addr [in]
  endereço inicial do buffer

• compare_addr [in]
  endereço inicial do comparebuffer

• result_addr [out]
  endereço inicial do buffer de resultados

• datatype
  tipo de dados de cada entrada em todos os buffers

• target_rank
  classificação de destino

• target_disp
  deslocamento do início da janela até o início do buffer de destino

• win
  objeto window

Retornar valor

Retorna MPI_SUCCESS em caso de êxito. Caso contrário, o valor retornado será um código de erro.

Em Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_COMPARE_AND_SWAP(ORIGIN_ADDR, COMPARE_ADDR, RESULT_ADDR,
                DATATYPE, TARGET_RANK, TARGET_DISP, WIN, IERROR)
        <type> ORIGIN_ADDR(*), COMPARE_ADDR(*), RESULT_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER DATATYPE, TARGET_RANK, WIN, IERROR

Comentários

Essa função compara um elemento do tipo datatype no buffer de comparação compare_addr com o buffer no deslocamento target_disp na janela de destino especificada por target_rank e win e substitui o valor no destino pelo valor no buffer de origem origin_addr se o buffer de comparação e o buffer de destino forem idênticos. O valor original no destino é retornado no buffer result_addr. O tipo de dados de parâmetro deve pertencer a uma das seguintes categorias de tipos de dados predefinidos: inteiro C, inteiro Fortran, lógico, tipos de várias linguagens ou Byte. Os buffers de origem e resultado (origin_addr e result_addr) devem ser não contíguos.

Requisitos

Produto	Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008
parâmetro	Mpi.h; Mpif.h
Biblioteca	Msmpi.lib
DLL	Msmpi.dll

Confira também

Funções de comunicação de One-Sided MPI