.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH pthread_join 3 "17 مايو 2025" "صفحات دليل لينكس 6.18" .SH الاسم pthread_join \- الانضمام إلى خيط منتهٍ .SH المكتبة مكتبة مسالك POSIX (\fIlibpthread\fP،\ \fI\-lpthread\fP) .SH موجز .nf \fB#include \fP .P \fBint pthread_join(pthread_t \fP\fIthread\fP\fB, void **\fP\fIretval\fP\fB);\fP .fi .SH الوصف تنتظر الدالة \fBpthread_join\fP() انتهاء الخيط المُحدد بواسطة \fIthread\fP. إذا كان هذا الخيط قد انتهى بالفعل، فستُرجع \fBpthread_join\fP() فورًا. يجب أن يكون الخيط المُحدد بواسطة \fIthread\fP قابلًا للانضمام. .P إذا لم يكن \fIretval\fP NULL، فستنسخ \fBpthread_join\fP() حالة الخروج للخيط الهدف (أي القيمة التي قدمها الخيط الهدف إلى \fBpthread_exit\fP(3)) إلى الموقع المُشار إليه بواسطة \fIretval\fP. إذا أُلغي الخيط الهدف، فسيُوضع \fBPTHREAD_CANCELED\fP في الموقع المُشار إليه بواسطة \fIretval\fP. .P إذا حاولت خيوط متعددة في وقت واحد الانضمام إلى نفس الخيط، فالنتائج غير مُحددة. إذا أُلغي الخيط الذي يستدعي \fBpthread_join\fP()، فسيظل الخيط الهدف قابلًا للانضمام (أي لن يُفصل). .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBpthread_join\fP() 0؛ عند الخطأ، تُرجع رقم خطأ. .SH الأخطاء .TP \fBEDEADLK\fP .\" The following verified by testing on glibc 2.8/NPTL: .\" The following verified by testing on glibc 2.8/NPTL: كُشف عن طريق مسدود (مثلًا، حاول خيطان الانضمام إلى بعضهما البعض)؛ أو يُحدد \fIthread\fP الخيط المُستدعي. .TP \fBEINVAL\fP \fIthread\fP ليس خيطًا قابلاً للضم. .TP \fBEINVAL\fP .\" POSIX.1-2001 does not specify this error case. خيط آخر ينتظر بالفعل الانضمام إلى هذا الخيط. .TP \fBESRCH\fP تعذر العثور على أي خيط بالمعرف \fIthread\fP. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBpthread_join\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير POSIX.1\-2008. .SH التاريخ POSIX.1\-2001. .SH ملاحظات بعد استدعاء ناجح لـ \fBpthread_join\fP()، يُضمن للمُستدعي أن الخيط الهدف قد انتهى. قد يختار المُستدعي بعد ذلك القيام بأي تنظيف مطلوب بعد انتهاء الخيط (مثل تحرير الذاكرة أو الموارد الأخرى التي خُصصت للخيط الهدف). .P الانضمام إلى خيط سبق الانضمام إليه يُنتج سلوكًا غير مُحدد. .P الفشل في الانضمام إلى خيط قابل للانضمام (أي غير مفصول)، يُنتج "خيط زومبي". تجنب فعل هذا، لأن كل خيط زومبي يستهلك بعض موارد النظام، وعندما تتراكم خيوط زومبي كافية، لن يعود من الممكن إنشاء خيوط (أو عمليات) جديدة. .P لا يوجد نظير pthreads لـ \fIwaitpid(\-1,\ &status,\ 0)\fP، أي "الانضمام إلى أي خيط منتهٍ". إذا كنت تعتقد أنك بحاجة لهذه الوظيفة، فربما تحتاج إلى إعادة التفكير في تصميم تطبيقك. .P جميع الخيوط في العملية هي أقران: أي خيط يمكنه الانضمام إلى أي خيط آخر في العملية. .SH أمثلة انظر \fBpthread_create\fP(3). .SH "انظر أيضًا" \fBpthread_cancel\fP(3), \fBpthread_create\fP(3), \fBpthread_detach\fP(3), \fBpthread_exit\fP(3), \fBpthread_tryjoin_np\fP(3), \fBpthreads\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .