str_pad()函数—用法及示例

函数名称：str_pad()

适用版本：PHP 4, PHP 5, PHP 7

函数说明：str_pad()函数用于将字符串填充为指定的长度。如果需要填充的长度小于原字符串的长度，则不进行填充。

语法：str_pad(string $input, int $pad_length, string $pad_string [, int $pad_type = STR_PAD_RIGHT]) : string

参数说明：

• $input：要填充的字符串。
• $pad_length：填充后的总长度。
• $pad_string：用于填充的字符串。
• $pad_type（可选）：填充的类型，默认为STR_PAD_RIGHT。可选值有：
  • STR_PAD_LEFT：在字符串左侧填充。
  • STR_PAD_RIGHT：在字符串右侧填充。
  • STR_PAD_BOTH：在字符串的两侧填充。

返回值：返回填充后的字符串。

示例1：

$input = "Hello";
$pad_length = 10;
$pad_string = "-";
$result = str_pad($input, $pad_length, $pad_string);
echo $result;  // 输出 "Hello-----"

示例2：

$input = "Hello";
$pad_length = 10;
$pad_string = "-";
$pad_type = STR_PAD_LEFT;
$result = str_pad($input, $pad_length, $pad_string, $pad_type);
echo $result;  // 输出 "-----Hello"

示例3：

$input = "Hello";
$pad_length = 10;
$pad_string = "-";
$pad_type = STR_PAD_BOTH;
$result = str_pad($input, $pad_length, $pad_string, $pad_type);
echo $result;  // 输出 "--Hello---"

注意事项：

• 如果$pad_length小于等于$input的长度，不会进行填充。
• $pad_string的长度不限制，如果$pad_string的长度大于需要填充的长度，会截断$pad_string。
• 如果$pad_type参数非法，将会返回原字符串$input而不进行填充。