萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP str_pad() 函式完整指南:字串填充補零實作

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 (兩側, 不均則右側多一個)

實用範例

1. 數字編號補零 (最常見用途)

<?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
)
*/
?>

2. 固定寬度欄位對齊 (報表輸出)

<?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
*/
?>

3. 兩側填充置中效果

<?php
$title = "歡迎光臨";
echo str_pad($title, 20, '-', STR_PAD_BOTH) . "\n";
// 輸出: ------歡迎光臨------- (左6右7,右側多一)
?>

4. 多字元填充模式

<?php
echo str_pad("A", 10, "-=", STR_PAD_LEFT) . "\n";
// 輸出: -=-=-=-=A (填充字串循環使用)
?>

常見陷阱與注意事項

  • 多位元組字元:中文字佔 3 位元組 (UTF-8),str_pad 按位元組計算,會導致視覺寬度不符。解決:mb_str_pad (PHP 8.3+) 或自行實作
  • 負數長度:PHP 8.0+ 拋出 ValueError,舊版本回傳原字串
  • $pad_string 為空字串:不填充,直接回傳原字串

多位元組安全版實作 (PHP < 8.3)

<?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";
// 輸出: ・・測試・・ (視覺寬度正確)
?>
copyright © 萬盛學電腦網 all rights reserved