.\" -*- 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 scanf 3 "21 سبتمبر 2025" "صفحات دليل لينكس 6.18" .SH الاسم scanf, fscanf, vscanf, vfscanf \- تحويل تنسيق ملف الإدخال .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint scanf(const char *restrict \fP\fIformat\fP\fB, ...);\fP \fBint fscanf(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, ...);\fP .P \fB#include \fP .P \fBint vscanf(const char *restrict \fP\fIformat\fP\fB, va_list \fP\fIap\fP\fB);\fP \fBint vfscanf(FILE *restrict \fP\fIstream\fP\fB,\fP \fB const char *restrict \fP\fIformat\fP\fB, va_list \fP\fIap\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBvscanf\fP(), \fBvfscanf\fP(): .nf _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L .fi .SH الوصف عائلة دوال \fBscanf\fP() تمسح الإدخال المنسق مثل \fBsscanf\fP(3)، لكنها تقرأ من \fIFILE\fP. من الصعب جدًا استخدام هذه الدوال بشكل صحيح، ومن الأفضل قراءة سطور كاملة باستخدام \fBfgets\fP(3) أو \fBgetline\fP(3) وتحليلها لاحقًا باستخدام \fBsscanf\fP(3) أو دوال أكثر تخصصًا مثل \fBstrtol\fP(3). .P تقرأ دالة \fBscanf\fP() الإدخال من دفق الإدخال القياسي \fIstdin\fP وتقرأ \fBfscanf\fP() الإدخال من مؤشر الدفق \fIstream\fP. .P دالة \fBvfscanf\fP() مماثلة لـ \fBvfprintf\fP(3) وتقرأ الإدخال من مؤشر الدفق \fIstream\fP باستخدام قائمة وسائط متغيرة من المؤشرات (انظر \fBstdarg\fP(3). دالة \fBvscanf\fP() مماثلة لـ \fBvprintf\fP(3) وتقرأ من الإدخال القياسي. .SH "قيمة الإرجاع" عند النجاح، تعيد هذه الدوال عدد عناصر المدخلات التي طابقت وجرى تعيينها بنجاح؛ وقد يكون هذا العدد أقل من المزود، أو حتى صفرًا في حالة فشل المطابقة المبكر. .P تُعاد القيمة \fBEOF\fP إذا وُصلت نهاية الإدخال قبل إتمام أول تحويل ناجح أو حدوث فشل مطابقة. تُعاد \fBEOF\fP أيضًا إذا حدث خطأ قراءة، وفي هذه الحالة يُضبط مؤشر الخطأ للدفق (انظر \fBferror\fP(3))، ويُضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء .TP \fBEAGAIN\fP وُسِم واصف الملف الأساسي لـ \fIstream\fP كغير محظور، وستحجب عملية القراءة. .TP \fBEBADF\fP واصف الملف الأساسي لـ \fIstream\fP غير صالح، أو غير مفتوح للقراءة. .TP \fBEILSEQ\fP تسلسل بايتات الدخل لا يشكل محرفاً صالحاً. .TP \fBEINTR\fP قُطعت عملية القراءة بواسطة إشارة؛ انظر \fBsignal\fP(7). .TP \fBEINVAL\fP لا توجد وسائط كافية؛ أو أن التنسيق \fIformat\fP هو NULL. .TP \fBENOMEM\fP نفدت الذاكرة. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBscanf\fP(), \fBfscanf\fP(), \fBvscanf\fP(), \fBvfscanf\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) .TE .SH المعايير C11, POSIX.1\-2008. .SH التاريخ C99، POSIX.1\-2001. .SH تحذيرات تجعل هذه الدوال التمييز بين الأسطر الجديدة والمسافات البيضاء الأخرى صعبًا. هذا يمثل مشكلة خاصة مع الإدخال المخزن مؤقتًا سطريًا، مثل دفق الإدخال القياسي. .P لا تستطيع هذه الدوال الإبلاغ عن الأخطاء بعد آخر مواصفات تحويل غير مكبوتة. .SH العلل من المستحيل معرفة عدد المحارف التي استهلكتها هذه الدوال من دفق الإدخال بدقة، لأنها تبلغ فقط عن عدد التحويلات الناجحة. على سبيل المثال، إذا كان الإدخال هو "123\[rs]n\ a"، فستستهلك \fIscanf(\[dq]%d\ %d\[dq], &a, &b)\fP الأرقام، والسطر الجديد، والمسافة، ولكن ليس الحرف a. هذا يجعل التعافي من الإدخال غير الصالح صعبًا. .SH "انظر أيضًا" \fBfgets\fP(3), \fBgetline\fP(3), \fBsscanf\fP(3) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .