PHP/vfprintf

(PHP 4, PHP 5, PHP 7)

تطبع الدالة vfprintf()‎ سلسلةً نصيَّةً بتنسيق معين على مجرى (stream) محدَّد.

الوصف

int vfprintf ( resource $handle , string $format , array $args )

تطبع هذه الدالة سلسلة نصيَّة بعد أن تنسِّقها وفقًا للتنسيق format إلى المجرى handle المعطى.

عمل هذه الدالة شبيه بالدالة fprintf()‎ باستثناء أنَّها تقبل مصفوفةً من المعاملات بدلًا من عدد من المعاملات المتغيِّرة.

المعاملات

handle

إشارة إلى مورد (resource) من نظام الملفات الذي يُنشَأ عادةً باستخدام الدالة fopen()‎‎.

format

راجع الدالة sprintf()‎ للاطلاع على شرح المعامل format.

القيم المعادة

يُعاد طول السلسلة النصيَّة المطبوعة على المجرى المحدَّد.

أمثلة

المثال 1: حشو الأعداد الصحيحة أصفارًا باستعمال الدالة vfprintf()‎

<?php
if (!($fp = fopen('date.txt', 'w')))
    return;

vfprintf($fp, "%04d-%02d-%02d", array($year, $month, $day));
//date.txt على الملف ISO سيُكتب التاريخ بتنسيق
?>

انظر أيضًا

• الدالة printf()‎: تطبع سلسلة نصيَّة بتنسيق معين.
• الدالة sprintf()‎: تعيد سلسلة نصيَّة بتنسيق معين.
• الدالة sscanf()‎: تفسير المدخلات من سلسلة نصيَّة وفقًا لتنسيق معين.
• الدالة fscanf()‎: تفسير المدخلات من ملف وفقًا لتنسيق معين.
• الدالة vsprintf()‎: تعيد سلسلة نصيَّة بتنسيق معين.
• الدالة number_format()‎: تُنسِّق الفاصلة العشرية وفاصلة الآلاف للعدد العشري.

مصادر

• صفحة الدالة vfprintf في توثيق PHP الرسمي.