MPI_Comm_get_attr الدالة

استرداد قيمة السمة حسب المفتاح.

بناء الجملة

int MPIAPI MPI_Comm_get_attr(
        MPI_Comm comm,
        int      comm_keyval,
  _Out_ void     *attribute_val,
  _Out_ int      *flag
);

المعلمات

• الاتصالات
  Communicator الذي يتم إرفاق السمة به.

• comm_keyval
  قيمة المفتاح.

• attribute_val [خارج]
  قيمة السمة، ما لم تكن العلامة = خطأ.

• علامة [خارج]
  صحيح إذا تم استخراج قيمة سمة؛ خطأ إذا لم تكن هناك سمة مقترنة بالمفتاح.

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

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

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

Fortran

    MPI_COMM_GET_ATTR(COMM, COMM_KEYVAL, ATTRIBUTE_VAL, FLAG, IERROR)
        INTEGER COMM, COMM_KEYVAL, IERROR
        INTEGER(KIND=MPI_ADDRESS_KIND) ATTRIBUTE_VAL
        LOGICAL FLAG

الملاحظات

يجب استخراج السمات من نفس اللغة التي تم إدراجها فيها باستخدام MPI_Comm_set_attr. على الرغم من أن الوسيطة attribute_val معلنة على أنها مؤشر فارغ ، إلا أنها حقا عنوان مؤشر الفراغ. راجع الأساس المنطقي في المعيار لمزيد من التفاصيل.

المتطلبات

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