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