الدالة fprintf()‎ في PHP

من موسوعة حسوب
< PHP

(‎(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()‎: تنسيق رقم للعرض.

مصادر