MPI_Comm_size الدالة

يسترد عدد العمليات المتضمنة في موصل، أو العدد الإجمالي للعمليات المتاحة.

بناء الجملة

int MPIAPI MPI_Comm_size(
        MPI_Comm comm,
  _Out_ int      *size
);

المعلمات

• الاتصالات
  الموصل المراد تقييمه. حدد ثابت MPI_COMM_WORLD لاسترداد العدد الإجمالي للعمليات المتاحة.

• الحجم [خارج]
  عند العودة، يشير إلى عدد العمليات في المجموعة للمتصل.

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

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

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

Fortran

    MPI_COMM_SIZE(COMM,SIZE,IERROR)
        INTEGER COMM, SIZE, IERROR

الملاحظات

تمكن هذه الدالة المستخدم من استرداد حجم المجموعة باستدعاء دالة واحدة. وإلا، سيكون من الضروري إنشاء مجموعة مؤقتة باستخدام الدالة MPI_Comm_group ، والحصول على حجم المجموعة باستخدام الدالة MPI_Group_size ، ثم تحرير المجموعة المؤقتة باستخدام الدالة MPI_Group_free .

غالبا ما تستخدم هذه الدالة مع الدالة MPI_Comm_rank لتحديد مقدار التزامن المتوفر لمكتبة أو برنامج معين. تشير الدالة MPI_Comm_rank إلى مرتبة العملية التي تستدعيها في النطاق من 0 إلى الحجم-1، حيث يتم استرداد الحجم باستخدام الدالة MPI_Comm_size .

ملاحظة

لا توجد طريقة قياسية لتغيير عدد العمليات بعد إجراء التهيئة.

 

المتطلبات

منتج	حزمة 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 Communicator

MPI_Comm_rank