مشاركة عبر


MPI_Group_difference الدالة

إنشاء مجموعة جديدة من الفرق بين مجموعتين موجودتين.

بناء الجملة

int MPIAPI MPI_Group_difference(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

المعلمات

  • group1
    المجموعة الأولى.

  • group2
    المجموعة الثانية.

  • مجموعة جديدة [خارج]
    مؤشر إلى مؤشر يمثل مجموعة جديدة تحتوي على جميع العناصر في المجموعة الأولى غير الموجودة في المجموعة الثانية. ترجع الدالة MPI_GROUP_EMPTY إذا كانت المجموعة الجديدة فارغة.

القيمة المُرجعة

إرجاع MPI_SUCCESS عند النجاح. وإلا، فإن القيمة المرجعة هي رمز خطأ.

في Fortran، يتم تخزين القيمة المرجعة في المعلمة IERROR .

Fortran

    MPI_GROUP_DIFFERENCE(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

الملاحظات

هذه عملية محلية. يمكن للعمليات المختلفة تحديد مجموعات مميزة. يمكن أن تحدد العملية مجموعة لا تتضمن نفسها.

لا يوفر تنفيذ MPI آلية لبناء مجموعة من البداية، ولكن فقط من المجموعات الموجودة. يمكن استرداد المجموعة الأساسية، التي يتم تعريف جميع المجموعات الأخرى عليها، باستخدام الدالة MPI_Comm_group . إنها المجموعة المقترنة MPI_COMM_WORLD الموصل الأولي.

المتطلبات

منتج

حزمة HPC Pack 2012 MS-MPI القابلة لإعادة التوزيع، حزمة HPC Pack 2008 R2 MS-MPI القابلة لإعادة التوزيع، حزمة HPC Pack 2008 MS-MPI القابلة لإعادة التوزيع أو حزمة HPC Pack 2008 للعميل

الرأس

Mpi.h؛ Mpif.h

المكتبة

Msmpi.lib

Dll

Msmpi.dll

راجع أيضًا

وظائف مجموعة MPI

MPI_Comm_group