الدالة fprintf()‎ في 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);

// 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 الرسمي.

‎