الفرق بين المراجعتين ل"PHP/fprintf"
< PHP
اذهب إلى التنقل
اذهب إلى البحث
هارون-بوكرش (نقاش | مساهمات) (أنشأ الصفحة ب'<noinclude>{{DISPLAYTITLE:الدالة fprintf() في PHP}}</noinclude>') |
|||
| (مراجعتان متوسطتان بواسطة مستخدمين اثنين آخرين غير معروضتين) | |||
| سطر 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]] | ||
المراجعة الحالية بتاريخ 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(): تنسيق رقم للعرض.