الفرق بين المراجعتين لصفحة: «PHP/fprintf»
< PHP
هارون-بوكرش (نقاش | مساهمات) أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة fprintf() في PHP}}</noinclude>' |
هارون-بوكرش (نقاش | مساهمات) لا ملخص تعديل |
||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:الدالة fprintf() في PHP}}</noinclude> | <noinclude>{{DISPLAYTITLE:الدالة fprintf() في PHP}}</noinclude> | ||
((PHP 5, PHP 7 | |||
تكتب الدالة fprintf() سلسلةً نصيةً منسقةً إلى مجرى (stream) معيّن. | |||
=== الوصف === | |||
<syntaxhighlight lang="php"> | |||
int fprintf ( resource $handle , string $format [, mixed $args [, mixed $... ]] ) | |||
</syntaxhighlight>تَكتُب الدالة fprintf() سلسلة نصية منسقة وِفق المعامل format إلى مجرى يُحدَّد من المعامل handle. | |||
=== المعاملات === | |||
==== handle ==== | |||
مؤشر إلى موارد نظام الملفات، الذي يُنشَأ عادةً عبر الدالة fopen(). | |||
==== format ==== | |||
اطلع على الدالة sprintf() لتفاصيل أكثر عن المعامل format. | |||
==== args ==== | |||
أول وسيط مُمرَّر إلى إلى سلسلة التنسيق. | |||
==== … ==== | |||
بقية الوسائط المُمرَّرة إلى سلسلة التنسيق. | |||
=== القيم المعادة === | |||
تُعيد الدالة fprintf() طول السلسة النصية المكتوبة. | |||
=== أمثلة === | |||
==== المثال 1: مثال عن الدالة fprintf() لإضافة أصفار بادئة إلى الأعداد عند اللزوم ==== | |||
<syntaxhighlight lang="php"> | |||
<?php | |||
if (!($fp = fopen('date.txt', 'w'))) { | |||
return; | |||
} | |||
fprintf($fp, "%04d-%02d-%02d", $year, $month, $day); | |||
// will write the formatted ISO date to date.txt | |||
?> | |||
</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(): عرض سلسلة نصية منسقة. | |||
* sprintf(): إعادة سلسلة نصية منسقة. | |||
* sscanf(): إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين. | |||
* fscanf(): إدخال بيانات إلى النظام من ملف حسب تنسيق معين. | |||
* vsprintf(): إعادة سلسلة نصية منسقة. | |||
* number_format(): تنسيق رقم للعرض. | |||
=== مصادر === | |||
* صفحة الدالة fprintf في توثيق PHP الرسمي. | |||
| |||
مراجعة 13:23، 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);
// will write the formatted ISO date to date.txt
?>
المثال 2: مثال عن تنسيق العُمُلات باستخدام الدالة fprintf()
<?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";
// استخدام القيمة المُعادة من الدالة لمعرفة عدد البايتات التي كتبت إلى الملف
?>
انظر أيضًا
- printf(): عرض سلسلة نصية منسقة.
- sprintf(): إعادة سلسلة نصية منسقة.
- sscanf(): إدخال بيانات إلى النظام من سلسلة نصية حسب تنسيق معين.
- fscanf(): إدخال بيانات إلى النظام من ملف حسب تنسيق معين.
- vsprintf(): إعادة سلسلة نصية منسقة.
- number_format(): تنسيق رقم للعرض.
مصادر
- صفحة الدالة fprintf في توثيق PHP الرسمي.