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而不進行填充。