الفرق بين المراجعتين لصفحة: «PHP/fprintf»

المراجعة الحالية بتاريخ 16:39، 5 أبريل 2018

(‎(PHP 5, PHP 7

تكتب الدالة ‎fprintf()‎ سلسلةً نصيةً منسقةً إلى مجرى (stream) معيّن.

الوصف

‎int fprintf ( resource $handle , string $format [, mixed $args [, mixed $... ]] )

تَكتُب الدالة ‎fprintf()‎ سلسلة نصية منسقة وِفق المعامل format إلى مجرى يُحدَّد من المعامل handle.

المعاملات

`handle`

مؤشر إلى موارد نظام الملفات، الذي يُنشَأ عادةً عبر الدالة fopen()‎.

`format`

اطلع على الدالة sprintf()‎ لتفاصيل أكثر عن المعامل format.

`args`

أول وسيط مُمرَّر إلى إلى سلسلة التنسيق.

`…`

بقية الوسائط المُمرَّرة إلى سلسلة التنسيق.

القيم المعادة

تُعيد الدالة fprintf()‎ طول السلسة النصية المكتوبة.

أمثلة

المثال 1: مثال عن الدالة ‎fprintf()‎ لإضافة أصفار بادئة إلى الأعداد عند اللزوم

<?php
if (!($fp = fopen('date.txt', 'w'))) {
    return;
}

fprintf($fp, "%04d-%02d-%02d", $year, $month, $day);
?>

المثال 2: مثال عن تنسيق العُمُلات باستخدام الدالة fprintf()‎

‎<?php
if (!($fp = fopen('currency.txt', 'w'))) {
   return;
}

$money1 = 68.75;
$money2 = 54.35;
$money = $money1 + $money2;

$len = fprintf($fp, '%01.2f', $money);
//كتابة السلسلة النصية “123.10” إلى الملف

echo "wrote $len bytes to currency.txt";
// استخدام القيمة المُعادة من الدالة لمعرفة عدد البايتات التي كتبت إلى الملف
?>

انظر أيضًا

printf()‎: عرض سلسلة نصية منسقة.
sprintf()‎: إعادة سلسلة نصية منسقة.
sscanf()‎: إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين.
fscanf()‎: إدخال بيانات إلى النظام من ملف حسب تنسيق معين.
vsprintf()‎: إعادة سلسلة نصية منسقة.
number_format()‎: تنسيق رقم للعرض.

مصادر

صفحة الدالة fprintf‎ في توثيق PHP الرسمي.

@@ سطر 1: / سطر 1: @@
-<noinclude>{{DISPLAYTITLE:الدالة fprintf()‎ في PHP}}</noinclude>
+<noinclude>{{DISPLAYTITLE:الدالة <code>fprintf()‎</code> في PHP}}</noinclude>
+(‎(PHP 5, PHP 7
+تكتب الدالة ‎<code>fprintf()‎</code> سلسلةً نصيةً منسقةً إلى مجرى (stream) معيّن.
+== الوصف ==
+<syntaxhighlight lang="php">
+‎int fprintf ( resource $handle , string $format [, mixed $args [, mixed $... ]] )
+</syntaxhighlight>تَكتُب الدالة ‎<code>fprintf()</code>‎ سلسلة نصية منسقة وِفق المعامل <code>format</code> إلى مجرى يُحدَّد من المعامل <code>handle</code>.
+== المعاملات ==
+=== <code>handle</code> ===
+مؤشر إلى موارد نظام الملفات، الذي يُنشَأ عادةً عبر الدالة <code>[[PHP/fopen|fopen()‎]]</code>.
+=== <code>format</code> ===
+اطلع على الدالة <code>[[PHP/sprintf|sprintf()‎]]</code> لتفاصيل أكثر عن المعامل <code>format</code>.
+=== <code>args</code> ===
+أول وسيط مُمرَّر إلى إلى سلسلة التنسيق.
+=== <code>…</code> ===
+بقية الوسائط المُمرَّرة إلى سلسلة التنسيق.
+== القيم المعادة ==
+تُعيد الدالة <code>fprintf()‎</code> طول السلسة النصية المكتوبة.
+== أمثلة ==
+المثال 1: مثال عن الدالة ‎<code>fprintf()</code>‎ لإضافة أصفار بادئة إلى الأعداد عند اللزوم<syntaxhighlight lang="php">
+<?php
+if (!($fp = fopen('date.txt', 'w'))) {
+    return;
+}
+fprintf($fp, "%04d-%02d-%02d", $year, $month, $day);
+?>
+</syntaxhighlight>المثال 2: مثال عن تنسيق العُمُلات باستخدام الدالة <code>fprintf()‎</code><syntaxhighlight lang="php">
+‎<?php
+if (!($fp = fopen('currency.txt', 'w'))) {
+   return;
+}
+$money1 = 68.75;
+$money2 = 54.35;
+$money = $money1 + $money2;
+$len = fprintf($fp, '%01.2f', $money);
+//كتابة السلسلة النصية “123.10” إلى الملف
+echo "wrote $len bytes to currency.txt";
+// استخدام القيمة المُعادة من الدالة لمعرفة عدد البايتات التي كتبت إلى الملف
+?>
+</syntaxhighlight>
+== انظر أيضًا ==
+* <code>[[PHP/printf|printf()‎]]</code>: عرض سلسلة نصية منسقة.
+* <code>[[PHP/sprintf|sprintf()‎]]</code>: إعادة سلسلة نصية منسقة.
+* <code>[[PHP/sscanf|sscanf()‎]]</code>: إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين.
+* <code>[[PHP/fscanf|fscanf()‎]]</code>: إدخال بيانات إلى النظام من ملف حسب تنسيق معين.
+* <code>[[PHP/vsprintf|vsprintf()‎]]</code>: إعادة سلسلة نصية منسقة.
+* <code>[[PHP/number format|number_format()‎]]</code>: تنسيق رقم للعرض.
+== مصادر ==
+* [http://php.net/manual/en/function.fprintf.php صفحة الدالة fprintf‎ في توثيق PHP الرسمي].
+[[تصنيف:PHP]]
+[[تصنيف:PHP Function]]
+[[تصنيف:PHP String]]