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