.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2003, Andries E. Brouwer .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH aio_write 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم aio_write \- كتابة غير متزامنة .SH المكتبة مكتبة الوقت الحقيقي (\fIlibrt\fP،\ \fI\-lrt\fP) .SH موجز .nf \fB#include \fP .P \fBint aio_write(struct aiocb *\fP\fIaiocbp\fP\fB);\fP .fi .SH الوصف الدالة \fBaio_write\fP() تصطف طلب الإدخال/الإخراج الموصوف بالمخزن المؤقت المشار إليه بواسطة \fIaiocbp\fP. هذه الدالة هي النظير غير المتزامن لـ \fBwrite\fP(2). وسيطات الاستدعاء .P .in +4n .EX write(fd, buf, count) .EE .in .P تتوافق (بالترتيب) مع الحقول \fIaio_fildes\fP و \fIaio_buf\fP و \fIaio_nbytes\fP للبنية التي يشير إليها \fIaiocbp\fP. (راجع \fBaio\fP(7) لوصف بنية \fIaiocb\fP.) .P إذا لم يُضبط \fBO_APPEND\fP، تُكتب البيانات بدءًا من الموضع المطلق \fIaiocbp\->aio_offset\fP، بغض النظر عن إزاحة الملف. إذا ضُبط \fBO_APPEND\fP، تُكتب البيانات في نهاية الملف بنفس ترتيب استدعاءات \fBaio_write\fP(). بعد الاستدعاء، تكون قيمة إزاحة الملف غير محددة. .P يعني "غير متزامن" أن هذا الاستدعاء يعود حالما يُصطف الطلب؛ قد تكون الكتابة قد اكتملت أو لا عند عودة الاستدعاء. يُختبر الاكتمال باستخدام \fBaio_error\fP(3). يمكن الحصول على حالة الإرجاع لعملية إدخال/إخراج مكتملة بواسطة \fBaio_return\fP(3). يمكن الحصول على إعلام غير متزامن باكتمال الإدخال/الإخراج بضبط \fIaiocbp\->aio_sigevent\fP بشكل مناسب؛ انظر \fBsigevent\fP(3type) للتفاصيل. .P إذا كان \fB_POSIX_PRIORITIZED_IO\fP معرفا، وهذا الملف يدعمه، فإن العملية غير المتزامنة تُقدم بأولوية تساوي أولوية العملية المستدعِيَة ناقص \fIaiocbp\->aio_reqprio\fP. .P يُتجاهَل الحقل \fIaiocbp\->aio_lio_opcode\fP. .P لا تُكتب أي بيانات إلى ملف عادي بعد أقصى إزاحة له. .SH "قيمة الإرجاع" عند النجاح، يُعاد 0. عند حدوث خطأ، لا يوضع الطلب في الدور، ويُعاد \-1، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. إذا اكتشف الخطأ لاحقًا، سيجري الإبلاغ عنه عبر \fBaio_return\fP(3) (يعيد الحالة \-1) و \fBaio_error\fP(3) (حالة الخطأ\[em]أياً كان ما قد يحصل عليه المرء في \fIerrno\fP، مثل \fBEBADF\fP). .SH الأخطاء .TP \fBEAGAIN\fP نفاد الموارد. .TP \fBEBADF\fP \fIaio_fildes\fP ليس واصف ملف صالحًا مفتوحًا للكتابة. .TP \fBEFBIG\fP الملف هو ملف عادي، ونريد كتابة بايت واحد على الأقل، لكن موضع البداية عند أو بعد أقصى إزاحة لهذا الملف. .TP \fBEINVAL\fP واحد أو أكثر من \fIaio_offset\fP، \fIaio_reqprio\fP، \fIaio_nbytes\fP غير صالح. .TP \fBENOSYS\fP \fBaio_write\fP() غير مطبقة. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBaio_write\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير POSIX.1\-2008. .SH التاريخ glibc 2.1. POSIX.1\-2001. .SH ملاحظات .\" or the control block of the operation من الجيد تصفير كتلة التحكم قبل الاستخدام. يجب ألا تُغير كتلة التحكم أثناء تنفيذ عملية الكتابة. يجب ألا يُوصل إلى منطقة المخزن المؤقت التي تُكتب أثناء العملية وإلا قد تحدث نتائج غير محددة. يجب أن تظل مناطق الذاكرة المعنية صالحة. .P تؤدي عمليات الإدخال/الإخراج المتزامنة التي تحدد نفس بنية \fIaiocb\fP إلى نتائج غير محددة. .SH "انظر أيضًا" \fBaio_cancel\fP(3), \fBaio_error\fP(3), \fBaio_fsync\fP(3), \fBaio_read\fP(3), \fBaio_return\fP(3), \fBaio_suspend\fP(3), \fBlio_listio\fP(3), \fBaio\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 .