str_pad() 是 PHP 字串處理的實用函式,可將字串填充至指定長度。常用於編號補零、固定寬度輸出、表格對齊等場景。
str_pad(string $string, int $length, string $pad_string = " ", int $pad_type = STR_PAD_RIGHT): string
| 參數 | 說明 |
|---|---|
$string | 要填充的原始字串 |
$length | 目標長度。小於原字串長度則不處理 |
$pad_string | 填充字元 (預設空白)。可為多字元 |
$pad_type | 填充方向:STR_PAD_RIGHT (預設, 右側)STR_PAD_LEFT (左側)STR_PAD_BOTH (兩側, 不均則右側多一個) |
<?php
$cardCount = 10;
$cards = [];
for ($i = 1; $i <= $cardCount; $i++) {
// 左側補 0 至 10 位
$cards[] = str_pad($i, 10, '0', STR_PAD_LEFT);
}
print_r($cards);
/*
Array
(
[0] => 0000000001
[1] => 0000000002
[2] => 0000000003
[3] => 0000000004
[4] => 0000000005
[5] => 0000000006
[6] => 0000000007
[7] => 0000000008
[8] => 0000000009
[9] => 0000000010
)
*/
?>
<?php
$products = [
['id' => 1, 'name' => '筆記型電腦', 'price' => 35000],
['id' => 2, 'name' => '滑鼠', 'price' => 500],
['id' => 3, 'name' => '機械鍵盤', 'price' => 3200],
];
echo "ID 名稱 價格\n";
echo "---------------------------\n";
foreach ($products as $p) {
$id = str_pad($p['id'], 4, ' ', STR_PAD_LEFT);
$name = str_pad(mb_substr($p['name'], 0, 12), 12, ' ', STR_PAD_RIGHT);
$price = str_pad(number_format($p['price']), 8, ' ', STR_PAD_LEFT);
echo "{$id} {$name} {$price}\n";
}
/*
ID 名稱 價格
---------------------------
1 筆記型電腦 35,000
2 滑鼠 500
3 機械鍵盤 3,200
*/
?>
<?php
$title = "歡迎光臨";
echo str_pad($title, 20, '-', STR_PAD_BOTH) . "\n";
// 輸出: ------歡迎光臨------- (左6右7,右側多一)
?>
<?php
echo str_pad("A", 10, "-=", STR_PAD_LEFT) . "\n";
// 輸出: -=-=-=-=A (填充字串循環使用)
?>
str_pad 按位元組計算,會導致視覺寬度不符。解決:mb_str_pad (PHP 8.3+) 或自行實作$pad_string 為空字串:不填充,直接回傳原字串<?php
function mb_str_pad($string, $length, $pad_string = ' ', $pad_type = STR_PAD_RIGHT, $encoding = 'UTF-8') {
$str_len = mb_strlen($string, $encoding);
if ($str_len >= $length) return $string;
$pad_len = $length - $str_len;
$pad_str_len = mb_strlen($pad_string, $encoding);
if ($pad_str_len === 0) return $string;
$repeat = ceil($pad_len / $pad_str_len);
$padding = str_repeat($pad_string, $repeat);
$padding = mb_substr($padding, 0, $pad_len, $encoding);
switch ($pad_type) {
case STR_PAD_LEFT:
return $padding . $string;
case STR_PAD_BOTH:
$left = floor($pad_len / 2);
$right = $pad_len - $left;
return mb_substr($padding, 0, $left, $encoding) . $string . mb_substr($padding, 0, $right, $encoding);
default: // STR_PAD_RIGHT
return $string . $padding;
}
}
// 測試中文
echo mb_str_pad("測試", 10, "・", STR_PAD_BOTH) . "\n";
// 輸出: ・・測試・・ (視覺寬度正確)
?>