phpで半角文字列に指定の長さまでスペース埋めしたい

Question

実現したいこと

半角で40文字いっていない場合は半角スペースで埋めたい。

該当のソースコード

sprintf("%-40s", 'ﾃｽﾄﾃｽﾄﾃ');

実際に下記の様に追加は出来ているのですが、
合計26文字にしかなりません。
'ﾃｽﾄﾃｽﾄﾃ '

試したこと

調べているのですが、どれも固定数を追加などで自分の求めているものに行きついていません。
https://qiita.com/tksnino/items/7188b95ea7f8e3a3b8dc

ご教授お願い致します。

Answer 1

mb_strwidth() を利用するとよいかもしれません。

PHP: mb_strwidth - Manual

mb_strwidth(string $string, ?string $encoding = null): int

文字列 string の幅を返します。半角文字は 1 として、全角文字は 2 として数えます。 東アジアの文字の長さに関する詳細は http://www.unicode.org/reports/tr11/ を参照ください。

<?php

$str = 'ﾃｽﾄﾃｽﾄﾃ';
$pad_width = 40 - mb_strwidth($str);
$str .= str_repeat(' ', $pad_width > 0 ? $pad_width : 0);
var_dump(mb_strwidth($str));
var_dump($str);

// int(40)
// string(54) "ﾃｽﾄﾃｽﾄﾃ                                 "

Comments

[otn]

なるほど。こんな関数もあったのですね。知りませんでした。
Unicodeにしかない文字も扱えますが、普通にシフトJISにあって幅2とみて欲しい ★ や ● ◎ などが 幅1 となってしまいますので、結局は、「対象となる文字列に、どんな文字があり得るか」次第ですかね。
あとフォントか。★ などが半角幅になるフォントがあるのならそれを使えば、これらの文字を使っていても mb_strwidth で解決です。

※ WindowsのWindowsTerminalで、"あ" と "★" の幅が違うので困ってまして、これらの文字がmb_strwidthでどうなんだろうと思って確認すると1でしたのでコメントしました。

もしかして、設定でこれら ambiguous widthの文字幅をなんと見るかの変更が出来るかと思いリファレンスを検索してみましたが、分からず。

Answer 2

普通のPHPのコードはUTF-8で書くので、半角カナも、ほとんどの全角日本語文字も両方とも3バイトです。キーボードから直接打てる半角英数記号は1バイトです。
半角カナが1バイトで、全角日本語文字が2バイトなのは、Shift_JISくらいですので、普通の等幅フォントを使うイメージで、「半角英数字記号や半角カナは幅1、全角日本語文字は幅2」として幅40にしたいのであれば、一旦Shift_JISに変換すると分かり易いです。
ただし、「UTF-8にはあるが、Shift_JISには無い文字」がいろいろあるので、そういう文字があると化けます。例えば「⒜」とか「㐂」とか。

$x='ﾃｽﾄﾃｽﾄﾃ';
$y=mb_convert_encoding(
    sprintf("%-40s", mb_convert_encoding($x,"SJIS-WIN","UTF-8")),
    "UTF-8","SJIS-WIN");
echo "1234567890123456789012345678901234567890\n";
echo $y."!\n";

コードでは、Shift_JISより若干使える文字が多いSJIS-WIN（Windows-31J：WindowsのシフトJISの拡張版）にしてます。
Windows-31Jにない文字も扱いたいなら面倒でわかりにくいプログラムになると思います。

Answer 3

半角で40文字
全角の場合はどの様にするのでしょうか？
とりあえず、全角半角問わず（＝英数も含む）40文字であるとします。
こんな感じでも実現できます。

$limit = 40;
$src = 'ﾃｽﾄﾃｽﾄﾃ';
var_dump(mb_substr($src . str_repeat(' ', $limit), 0, $limit));

ですが...

どれも固定数を追加などで自分の求めているものに行きついていません。
参照先の最後に mb_str_pad() についての記述がありますが、これは期待に副うモノではありませんか？
＿＿PHP8.3以上なら関数定義は不要（公式に取り込まれた）
＿＿https://www.php.net/manual/ja/function.mb-str-pad.php

Answer 4

おそらく半角カタカナが1文字3バイト、7文字で合計21バイト。
不足の19文字を追加して26文字になっていると思います。

下記のようにすれば40文字になりますが、全角文字も1文字になるのでご注意ください。

$n = 40;
$s='ﾃｽﾄﾃｽﾄﾃ';
$x = mb_strlen($s);
if ($x < $n) {
    $s .= str_repeat(' ', $n - $x);
}
echo $s;