الفرق بين المراجعتين لصفحة: «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 الرسمي.

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