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