大网数据广告活动
PHP 语言与运行手册

str_pad · 使用另一个字符串填充字符串为指定长度

· 52CE 我爱测

该函数返回 string 被从左端、右端或者同时两端被填充到制定长度后的结果。如果可选的 pad_string 参数没有被指定,string 将被空格字符填充,否则它将被 pad_string 填充到指定长度。

str_pad

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

str_pad — 使用另一个字符串填充字符串为指定长度

说明

function str_pad(
    string $string,
    int $length,
    string $pad_string = " ",
    int $pad_type = STR_PAD_RIGHT
): string

该函数返回 string 被从左端、右端或者同时两端被填充到制定长度后的结果。如果可选的 pad_string 参数没有被指定,string 将被空格字符填充,否则它将被 pad_string 填充到指定长度。

参数

string

输入字符串。

length

填充字符串到最后的长度。 如果 length 的值是负数,小于或者等于输入字符串的长度,不会发生任何填充,并会返回 string。

pad_string

注意:

如果填充字符的长度不能被 pad_string 整除,那么 pad_string 可能会被缩短。

pad_type

可选的 pad_type 参数的可能值为 STR_PAD_RIGHT,STR_PAD_LEFT 或 STR_PAD_BOTH。如果没有指定 pad_type,则假定它是 STR_PAD_RIGHT。

返回值

返回填充后的字符串。

示例

示例 #1 str_pad() 示例

<?php
$input = "Alien";
echo str_pad($input, 10), PHP_EOL;                      // 输出 "Alien     "
echo str_pad($input, 10, "-=", STR_PAD_LEFT), PHP_EOL;  // 输出 "-=-=-Alien"
echo str_pad($input, 10, "_", STR_PAD_BOTH), PHP_EOL;   // 输出 "__Alien___"
echo str_pad($input,  6, "___"), PHP_EOL;               // 输出 "Alien_"
echo str_pad($input,  3, "*"), PHP_EOL;                 // 输出 "Alien"
?>

参见

  • mb_str_pad() - Pad a multibyte string to a certain length with another multibyte string

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。