الفرق بين المراجعتين ل"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()
: تنسيق رقم للعرض.