Php/docs/function.printf

提供:Dev Guides
< Php
移動先:案内検索

printf

(PHP 4, PHP 5, PHP 7)

printfフォーマット済みの文字列を出力する


説明

printf ( string $format , mixed ...$values ) : int

format にしたがって、出力を生成します。


パラメータ

format

0個以上のディレクティブで構成されるフォーマット文字列: 変換結果に直接コピーされる通常文字列 (% は除きます) と、変換仕様。 これらのいずれも、自分が持つパラメータを取得します。

変換の仕様は、以下のプロトタイプに従います: %[argnum$][flags][width][.precision]specifier.

Argnum

何個の引数を変換の対象にするかを指定するために、 数値の後にドル記号 $ を続けます。

フラグ一覧
フラグ 説明
- 与えられたフィールドの幅を左寄せにします。

右寄せがデフォルトです。

+ 正の数値の前に付ける + 符号です;

デフォルトは、負の数にだけマイナスの符号が数値の前に付きます。

(space) スペースに変換される詰め物です。

これがデフォルトです。

0 数値の左側を0埋めします。

s 指定子を使うと、 右側にも0埋めできます。

'(char) 指定された (char) で埋めます。
Width

(最小で)何文字がこの変換結果に含まれるかを数値で指定します。

Precision

ピリオド . の後に数値を続けますが、 その意味は指定子に依存します:

  • e, E, fF 指定子の場合: 小数点の後に表示する桁数 (デフォルトでは、この値は6です)
  • gG 指定子の場合: 表示する最大の有効桁数
  • s 指定子の場合: 文字列を切り捨てる時点、つまり、文字列の最大の長さを設定します。

注意:

明示的に精度を指定せず、ピリオドを指定した場合、精度は0として扱われます。

注意:

位置を示す指定子に、PHP_INT_MAX を超える値を指定すると、警告が発生します。

指定子の一覧
指定子 説明
% 文字通り、パーセント文字です。

引数は不要です。

b 引数は数値として扱われ、バイナリ値として表現されます。
c 引数は数値として扱われ、ASCII文字として表現されます。
d 引数は数値として扱われ、(符号付き)小数値として表現されます。
e 引数は科学的記法で表現された値(e.g. 1.2e+2)として扱われます。

PHP 5.2.1 以降では、precision 指定子が小数点以降の桁数を表します。 それより前のバージョンでは、(ひと桁少ない) 有効桁数として解釈されていました。

E e 指定子に似ていますが、

大文字を使います(e.g. 1.2E+2)

f 引数は小数として扱われ、浮動小数値として表現されます(ロケールを考慮します)。
F 引数は小数として扱われ、浮動小数値として表現されます(ロケールを考慮しません)。

PHP 5.0.3 以降で利用可能です

g

汎用フォーマット

P を精度を表す、ゼロでない値とします。 精度が省略された場合、Pの値は6です。 精度に0を指定した場合、Pの値は1になります。 この場合、 E 指定子の変換結果は、 X乗になります。

P > X ≥ −4 の場合、E 指定子の変換結果となり、精度は、P − (X + 1) になります。 そうでない場合、e 指定子の変換結果となり、 精度は、P - 1 になります。

G g 指定子に似ていますが、

Ef を使います。

o 引数は数値として扱われ、8進数値として表現されます。
s 引数は文字列として扱われ、文字列として表現されます。
u 引数は数値として扱われ、符号なし小数値として表現されます。
x 引数は数値として扱われ、16進数値(小文字)として表現されます。
X 引数は数値として扱われ、16進数値(大文字)として表現されます。

警告

c 指定子はパディングと幅を無視します

警告

文字列と width 指定子を、1文字の表現に1バイト以上必要な文字セットと一緒に使おうとすると、 期待しない結果になるかもしれません。

値は、指定子の型に合うように強制されます:

型のハンドリング
指定子
string s
integer d,

u, c, o, x, X, b

double g,

G, e, E, f, F

values


返り値

出力した文字列の長さを返します。


例1 printf(): various examples

<?php$n =  43951789;$u = -43951789;$c = 65; // ASCII の 65番目は 'A'// %% は、リテラル '%' 文字を出力することに注意printf("%%b = '%b'\n", $n); // バイナリ表現printf("%%c = '%c'\n", $c); // ASCII 文字を出力。chr() 関数と同じprintf("%%d = '%d'\n", $n); // 標準的な整数表現printf("%%e = '%e'\n", $n); // 科学的記法printf("%%u = '%u'\n", $n); // 正の整数の符号なし整数表現printf("%%u = '%u'\n", $u); // 負の整数の符号なし整数表現printf("%%f = '%f'\n", $n); // 浮動小数点表現printf("%%o = '%o'\n", $n); // 8進数表現printf("%%s = '%s'\n", $n); // 文字列表現printf("%%x = '%x'\n", $n); // 16進数の表現(小文字)printf("%%X = '%X'\n", $n); // 16進数の表現(大文字)printf("%%+d = '%+d'\n", $n); // 正の整数値の符号printf("%%+d = '%+d'\n", $u); // 負の整数値の符号?>

上の例の出力は以下となります。


%b = '10100111101010011010101101'
%c = 'A'
%d = '43951789'
%e = '4.39518e+7'
%u = '43951789'
%u = '4251015507'
%f = '43951789.000000'
%o = '247523255'
%s = '43951789'
%x = '29ea6ad'
%X = '29EA6AD'
%+d = '+43951789'
%+d = '-43951789'

例2 printf(): 文字列の指定子

<?php$s = 'monkey';$t = 'many monkeys';printf("[%s]\n",      $s); // 通常の文字列出力printf("[%10s]\n",    $s); // スペースで右寄せにするprintf("[%-10s]\n",   $s); // スペースで左寄せにするprintf("[%010s]\n",   $s); // ゼロ埋めは文字列でも機能しますprintf("[%'#10s]\n",  $s); // '#' 文字を使ったカスタムの文字埋めprintf("[%10.9s]\n", $t); // 右寄せ。但し8文字で切り捨てprintf("[%-10.9s]\n", $t); // 左寄せ。但し8文字で切り捨て?>

上の例の出力は以下となります。


[monkey]
[    monkey]
[monkey    ]
[0000monkey]
[####monkey]
[ many monk]
[many monk ]

参考

  • print - 文字列を出力する
  • sprintf() - フォーマットされた文字列を返す
  • fprintf() - フォーマットされた文字列をストリームに書き込む
  • vprintf() - フォーマットされた文字列を出力する
  • vsprintf() - フォーマットされた文字列を返す
  • vfprintf() - フォーマットされた文字列をストリームに書き込む
  • sscanf() - フォーマット文字列に基づき入力を処理する
  • fscanf() - フォーマットに基づきファイルからの入力を処理する
  • number_format() - 数字を千位毎にグループ化してフォーマットする
  • date() - ローカルの日付/時刻を書式化する
  • flush() - システム出力バッファをフラッシュする