使用 sprintf 对齐字符串输出的技巧

gitbox 2025-05-08

在 PHP 编程中，我们经常需要格式化字符串输出，以便让输出内容更清晰、易于阅读。PHP 提供了多种格式化输出的方法，其中最常用的就是 sprintf 函数。sprintf 函数可以用于创建格式化字符串，并允许我们对齐输出内容。接下来，我们将介绍如何使用 sprintf 函数来实现字符串的对齐。

什么是 sprintf 函数？

php 中的 sprintf 函数用于格式化字符串输出，它的基本语法如下：

sprintf(format, arg1, arg2, ...)

format：指定输出字符串的格式。
arg1, arg2, ...：根据格式化字符串中的格式控制符，传入相应的参数。

在格式化字符串中，我们可以使用占位符来定义参数的格式，如整数、浮动数值或字符串。

字符串对齐的基本方法

使用 sprintf 函数进行字符串对齐时，我们主要使用格式控制符中的宽度和对齐符号。具体来说，常用的对齐方式包括左对齐、右对齐和居中对齐。

1. 右对齐

默认情况下，sprintf 会将输出内容右对齐。如果你不指定其他格式控制符，sprintf 会自动将内容右对齐。

<?php
$name = "Alice";
$age = 30;
echo sprintf("|%-10s|%-3d|\n", $name, $age);
?>

在上面的代码中，%-10s 使得字符串左对齐并占据 10 个字符的宽度，而 %-3d 使得数字占据 3 个字符的宽度。

输出结果：

|Alice     |30 |

2. 左对齐

如果你希望内容左对齐，可以使用 - 符号。

<?php
$name = "Alice";
$age = 30;
echo sprintf("|%-10s|%-3d|\n", $name, $age);
?>

这将导致输出内容左对齐，占据指定的宽度：

|Alice     |30 |

3. 居中对齐

居中对齐需要稍微复杂一点的操作，因为 sprintf 默认并不支持居中对齐。但是，我们可以通过巧妙利用宽度和填充字符来实现居中对齐。

<?php
function centerAlign($str, $width) {
    $padding = $width - strlen($str);
    $left = floor($padding / 2);
    $right = ceil($padding / 2);
    return str_repeat(" ", $left) . $str . str_repeat(" ", $right);
}

$name = "Alice";
$age = 30;
echo "|" . centerAlign($name, 10) . "|";
echo centerAlign($age, 3) . "|\n";
?>

该函数首先计算左右两边的空白区域，然后将字符串填充到中间。这将实现居中对齐。

输出结果：

|  Alice   | 30 |

实际应用：对齐 URL 输出

有时我们需要输出类似 URL 的字符串，可能需要进行格式化对齐。假设我们有一个列表，包含多个 URL 和它们的描述。我们希望将 URL 对齐。以下是一个使用 sprintf 格式化对齐 URL 输出的示例：

<?php
$urls = [
    "https://gitbox.net/first-url" => "First description",
    "https://gitbox.net/second-url" => "Second description",
    "https://gitbox.net/third-url" => "Third description"
];

echo sprintf("|%-35s|%-20s|\n", "URL", "Description");
echo str_repeat("-", 60) . "\n";

foreach ($urls as $url => $desc) {
    echo sprintf("|%-35s|%-20s|\n", $url, $desc);
}
?>

这段代码将输出一个 URL 列表，并确保每个 URL 都按固定宽度对齐。由于我们将 URL 的域名替换成了 gitbox.net，所以输出结果如下：

|URL                                |Description          |
------------------------------------------------------------
|https://gitbox.net/first-url       |First description    |
|https://gitbox.net/second-url      |Second description   |
|https://gitbox.net/third-url       |Third description    |

sprintf