MPI_Get_accumulate işlevi

Atomik okuma-değiştirme-yazma gerçekleştirir ve birikmesi işleminden önce verileri döndürür.

Söz dizimi

int MPIAPI MPI_Get_accumulate(
  _In_  void         *origin_addr,
        int          origin_count,
        MPI_Datatype origin_datatype,
  _Out_ void         *result_addr,
        int          result_count,
        MPI_Datatype result_datatype,
        int          target_rank,
        MPI_Aint     target_disp,
        int          target_count,
        MPI_Datatype datatype,
        MPI_Op       op,
        MPI_Win      win
);

Parametreler

• origin_addr [in]
  arabelleğin ilk adresi

• origin_count
  arabellekteki girdi sayısı

• origin_datatype
  her arabellek girişinin veri türü

• result_addr [out]
  sonuç arabelleğinin ilk adresi

• result_count
  sonuç arabelleğindeki girdi sayısı

• result_datatype
  sonuç arabelleğindeki her girişin veri türü

• target_rank
  hedefin sırası

• target_disp
  pencerenin başından hedef arabelleğin başına yer değiştirme

• target_count
  hedef arabellekteki girdi sayısı

• Datatype
  hedef arabellekteki her girişin veri türü

• Op
  önceden tanımlanmış azaltma işlemi

• Kazanmak
  pencere nesnesi

Döndürülen değer

Başarılı MPI_SUCCESS döndürür. Aksi takdirde, dönüş değeri bir hata kodudur.

Fortran'da dönüş değeri IERROR parametresinde depolanır.

Fortran

    MPI_GET_ACCUMULATE(ORIGIN_ADDR, ORIGIN_COUNT, ORIGIN_DATATYPE, RESULT_ADDR, RESULT_COUNT, RESULT_DATATYPE,
                TARGET_RANK, TARGET_DISP, TARGET_COUNT, TARGET_DATATYPE, OP, WIN, IERROR)
        <type> ORIGIN_ADDR(*), RESULT_ADDR(*)
        INTEGER(KIND=MPI_ADDRESS_KIND) TARGET_DISP
        INTEGER ORIGIN_COUNT, ORIGIN_DATATYPE, RESULT_COUNT, RESULT_DATATYPE, TARGET_RANK, TARGET_COUNT,
        TARGET_DATATYPE, OP, WIN, IERROR

Açıklamalar

kaynak arabelleğinden (origin_addr) uzaklıktaki arabelleğe origin_datatype türdekitarget_disp origin_count öğeleri, target_rank ve win tarafından belirtilen hedef pencerede, işlem işlemini kullanarak ve sonuç arabelleğine dönüş result_addr hedef arabelleğin içeriğini biriktirmeden önce, target_disp tarafından belirtilen, target_count ve target_datatype. Kaynaktan hedefe aktarılan veriler, kesilmeden hedef arabelleğe sığmalıdır. Benzer şekilde, hedeften çıkışa kopyalanan verilerin kesme olmadan sonuç arabelleğine sığması gerekir.

Kaynak ve sonuç arabellekleri (origin_addr ve result_addr) kopuk olmalıdır. Her veri türü bağımsız değişkeni, tüm temel bileşenlerin aynı önceden tanımlanmış veri türüne sahip olduğu önceden tanımlanmış bir veri türü veya türetilmiş bir veri türü olmalıdır. Tüm veri türü bağımsız değişkenleri önceden tanımlanmış aynı veri türünden oluşturulmalıdır. İşlem işlemi , önceden tanımlanmış türdeki öğelere uygulanır. target_datatype çakışan girişleri belirtmemelidir ve hedef arabelleğin hedef pencereye veya dinamik bir penceredeki ekli belleğe sığması gerekir. İşlem her temel veri türü için atomik olarak yürütülür.

Gereksinimler

Ayrıca bkz.

MPI One-Sided İletişim İşlevleri