وظيفة fprintf() في PHP

PHP String functions

مثال

كتابة النص في ملف النص المسمى "test.txt":

<?php
$number = 9;
$str = "Beijing";
$file = fopen("test.txt","w");
echo fprintf($file,"هناك ӣون دراجة في %s.",$number,$str);
?>

مخرجات الكود أعلاه:

40

سيتم كتابة النص التالي في ملف "test.txt":

هناك 9 مليون دراجة في بكين.

التعريف والاستخدام

تقوم وظيفة fprintf() بكتابة السلسلة التنسيقة في تيار الإخراج المحدد (مثلاً ملف أو قاعدة بيانات).

arg1،arg2،arg++ سيتم إدراج المتغير في مكان علامة النسبة المئوية (%) في السلسلة الرئيسية. هذه الوظيفة تنفذ خطوة بخطوة. في مكان رمز % الأول، أدرج arg1، في مكان رمز % الثاني، أدرج arg2، إلى آخره.

注释：إذا كان رمز % أكثر من arg إذا كان هناك متغيرات، يجب عليك استخدام علامة الاستبدال. يتم إدراج علامة الاستبدال بعد رمز %، مكونة من رقم و "\$". انظر مثال 2.

الوظائف ذات الصلة:

النحو

fprintf(stream,format,arg1,arg2,arg++)
المتغيرات الوصف
stream مطلوب. يحدد المكان الذي يتم فيه كتابة/الإدخال السلسلة.
format

مطلوب. يحدد السلسلة وكيفية تنسيق المتغيرات فيها.

القيم النمطية المحتملة:

  • %% - يعيد إدخال علامة النسبة المئوية %
  • %b - عدد ثنائي
  • %c - الحرف الذي يعادله رمز ASCII
  • %d - عدد عشري يحتوي على إشارة إيجابية أو سالبة (رقم سالب، 0، رقم إيجابي)
  • %e - استخدام نظام العد العلمي بالحروف الصغيرة (مثلاً 1.2e+2)
  • %E - استخدام نظام العد العلمي بالحروف الكبيرة (مثلاً 1.2E+2)
  • 誒دد عشري بدون إشارة إيجابية أو سالبة (أكبر أو يساوي 0)
  • %f - عدد عشري (بإعدادات محلية)
  • %F - عدد عشري (بلا إعدادات محلية)
  • %g - أقصر من %e و %f
  • %G - أقصر من %E و %f
  • %o - عدد ثنائي
  • %s - سلسلة من الأحرف
  • %x - عدد عشري (أحرف صغيرة)
  • %X - عدد عشري (أحرف كبيرة)

القيمة النمطية المضافة. يجب وضعها بين % و الحرف (مثلاً %.2f):

  • + （在数字前面加上 + 或 - 来定义数字的正负性。）
    默认地，只有负数才做标记，正数不做标记）
  • ' （规定使用什么作为填充，默认是空格。它必须与宽度指定器一起使用。
    例如：%'x20s（使用 "x" 作为填充））
  • - （左调整变量值）
  • .[0-9] （规定变量值的最小宽度）
  • .[0-9] （规定小数位数或最大字符串长度）

注释：如果使用多个额外的格式值，则必须按照上面的顺序进行使用。
arg1 必需。规定插到 format 字符串中第一个 %% 符号处的参数。
arg2 可选。规定插到 format 字符串中第二个 %% 符号处的参数。
arg++ 可选。规定插到 format 字符串中第三、四等等 %% 符号处的参数。

技术细节

返回值： 返回被写字符串的长度。
PHP 版本： 5+

更多实例

例子 1

把文本写入文件中：

<?php
$number = 123;
$file = fopen("test.txt","w");
fprintf($file,"%%f",$number);
?>

下面的文本将被写入到文件 "test.txt"：

123.000000

例子 2

使用占位符：

<?php
$number = 123;
$file = fopen("test.txt","w");
fprintf($file,"有两位小数：%1\$.2f
\n没有小数：%1\$u",$number);
?>

下面的文本将被写入到文件 "test.txt"：

有两位小数：123.00
没有小数：123

例子 3

使用 printf() 来演示所有可能的格式值：

<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50; // ASCII 字符 50 是 2
// 注释：格式值 "%%" 返回百分号
printf("%%b = %%b <br>",$num1); // 二进制数
printf("%%c = %%c <br>",$char); // ASCII 字符
printf("%%d = %%d <br>",$num1); // 带符号的十进制数
printf("%%d = %%d <br>",$num2); // 带符号的十进制数
printf("%%e = %%e <br>",$num1); // 科学计数法（小写）
printf("%%E = %%E <br>",$num1); // 科学计数法（大写）
printf("%鑾u <br>", $num1); // Unsigned decimal number (positive)
printf("%鑾u <br>", $num2); // Unsigned decimal number (negative)
printf("%%f = %f <br>", $num1); // Floating point number (dependent on local settings)
printf("%%F = %F <br>", $num1); // Floating point number (not dependent on local settings)
printf("%%g = %g <br>", $num1); // Shorter than %e and %f
printf("%%G = %G <br>", $num1); // Shorter than %E and %f
printf("%%o = %o <br>", $num1); // Octal number
printf("%%s = %s <br>", $num1); // String
printf("%%x = %x <br>", $num1); // Hexadecimal number (lowercase)
printf("%%X = %X <br>", $num1); // Hexadecimal number (uppercase)
printf("%%+d = %+d <br>", $num1); // Positive sign specifier
printf("%%+d = %+d <br>", $num2); // Negative sign specifier
?>

Run Instance

PHP String functions