توابع vsprintf() در PHP

PHP String函数

مثال

نوشتن رشته‌ی قالب‌بندی شده به متغیرها:

<?php
$number = 9;
$str = "Beijing";
$txt = vsprintf("There are 쥕lion bicycles in %s.",array($number,$str));
echo $txt;
?>

运行实例

تعریف و استفاده

توابع vsprintf() رشته‌ی قالب‌بندی شده را به متغیرها می‌نویسد.

با تفاوت sprintf()، پارامترها در vsprintf() در یک آرایه قرار دارند. عناصر آرایه در نقاط علامت‌گذاری‌دهنده‌ی درصد (%) در رشته‌ی اصلی جایگزین می‌شوند. این تابع به صورت مرحله‌ای اجرا می‌شود. در اولین علامت‌گذاری‌دهنده‌ی %، اولین عنصر آرایه جایگزین می‌شود، در دومین علامت‌گذاری‌دهنده‌ی %، دومین عنصر آرایه جایگزین می‌شود و به همین ترتیب.

توضیحات:اگر نشانه‌های % بیشتر از arg اگر پارامترهایی داشته باشید، باید از نگه‌دارنده استفاده کنید. نگه‌دارنده پس از % قرار می‌گیرد و شامل عدد و "\$" است. به مثال 2 مراجعه کنید.

توضیح:دستگاه‌های مرتبط:

قانون‌نویسی

vsprintf(format,argarray)
پارامترها توضیحات
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] (تعیین تعداد اعشار یا طول حداکثر رشته)

توضیحات:اگر از چندین مقادیر فرمت شده استفاده شود، آن‌ها باید به ترتیب بالا استفاده شوند و تغییر نکنند.
argarray ضروری. یک آرایه با پارامترها که در آن‌ها قرار می‌گیرند format در جای % در رشته.

جزئیات فنی

مقدار بازگشتی: ارائه مقادیر آرایه به صورت رشته‌ی فرمت شده.
نسخه PHP: 4.1.0+

مثال‌های بیشتر

مثال 1

استفاده از مقادیر فرمت شده %f:

<?php
$num1 = 123;
$num2 = 456;
$txt = vsprintf("%f%f",array($num1,$num2));
echo $txt;
?>

运行实例

مثال 2

استفاده از نشان‌گر:

<?php
$number = 123;
$txt = vsprintf("دو علامت عدد اعشار：%1\$.2f<br>بدون علامت عدد اعشار：%1\$u",array($number));
echo $txt;
?>

运行实例

مثال 3

استفاده از sprintf() برای نمایش همه فرمت‌های ممکن:

<?php
$num1 = 123456789;
$num2 = -123456789;
$char = 50; // ASCII 字符 50 است 2
// 注释：格式值 "%%" 返回百分号
echo sprintf("%%b = %b",$num1)."<br>"; // 二进制数
echo sprintf("%%c = %c",$char)."<br>"; // ASCII 字符
echo sprintf("%%d = %d",$num1)."<br>"; // 带符号的十进制数
echo sprintf("%%d = %d",$num2)."<br>"; // 带符号的十进制数
echo sprintf("%%e = %e",$num1)."<br>"; // 科学计数法（小写）
echo sprintf("%%E = %E",$num1)."<br>"; // 科学计数法（大写）
echo sprintf("%鑾u",$num1)."<br>"; // 不带符号的十进制数（正）
echo sprintf("%鑾u",$num2)."<br>"; // 不带符号的十进制数（负）
echo sprintf("%%f = %f",$num1)."<br>"; // 浮点数（视本地设置）
echo sprintf("%%F = %F",$num1)."<br>"; // 浮点数（不视本地设置）
echo sprintf("%%g = %g",$num1)."<br>"; // 短于 %e 和 %f
echo sprintf("%%G = %G",$num1)."<br>"; // 短于 %E 和 %f
echo sprintf("%%o = %o",$num1)."<br>"; // 八进制数
echo sprintf("%%s = %s",$num1)."<br>"; // 字符串
echo sprintf("%%x = %x",$num1)."<br>"; // 十六进制数（小写）
echo sprintf("%%X = %X",$num1)."<br>"; // 十六进制数（大写）
echo sprintf("%%+d = %+d",$num1)."<br>"; // 符号说明符（正）
echo sprintf("%%+d = %+d",$num2)."<br>"; // 符号说明符（负）
?>

运行实例

例子4

字符串说明符的演示：

<?php
$str1 = "Hello";
$str2 = "Hello world!";
echo vsprintf("[%s]",array($str1))."<br>";
echo vsprintf("[%8s]",array($str1))."<br>";
echo vsprintf("[%-8s]",array($str1))."<br>";
echo vsprintf("[%08s]",array($str1))."<br>";
echo vsprintf("[%'*8s]",array($str1))."<br>";
echo vsprintf("[%8.8s]",array($str2))."<br>";
?>

运行实例

PHP String函数