関数・クラス解説
vfprintf
version:PHP 5, PHP 7 (公式)フォーマットされた文字列をストリームに書き込む
公式リファレンス
書式
vfprintf ( resource $handle , string $format , array $args ) : int
説明
format によって作成された文字列を handle で指定したストリームに書き込みます。
fprintf() と同様の動作をしますが、 可変引数ではなく引数の配列を受け取って処理します。
パラメータ
- handle
- format
- 0個以上のディレクティブで構成されるフォーマット文字列: 変換結果に直接コピーされる通常文字列 (% は除きます) と、変換仕様。 これらのいずれも、自分が持つパラメータを取得します。 変換の仕様は、以下のプロトタイプに従います: %[argnum$][flags][width][.precision]specifier.
Argnum
何個の引数を変換の対象にするかを指定するために、 数値の後にドル記号 $ を続けます。フラグ一覧 フラグ 説明 - 与えられたフィールドの幅を左寄せにします。 右寄せがデフォルトです。 + 正の数値の前に付ける + 符号です; デフォルトは、負の数にだけマイナスの符号が数値の前に付きます。 (space) スペースに変換される詰め物です。 これがデフォルトです。 0 数値の左側を0埋めします。 s 指定子を使うと、 右側にも0埋めできます。 '(char) 指定された (char) で埋めます。 Width
(最小で)何文字がこの変換結果に含まれるかを数値で指定します。Precision
ピリオド . の後に数値を続けますが、 その意味は指定子に依存します:- e, E, f と F 指定子の場合: 小数点の後に表示する桁数 (デフォルトでは、この値は6です)
- g と G 指定子の場合: 表示する最大の有効桁数
- 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 指定子に似ていますが、 E と f を使います。 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 - args
返値
出力された文字列の長さを返します。
注意
警告 c 指定子はパディングと幅を無視します
サンプル
例1 vfprintf(): 数値のゼロ埋め
if (!($fp = fopen('date.txt', 'w')))
return;
vfprintf($fp, "%04d-%02d-%02d", array($year, $month, $day));
// ISO 形式にフォーマットした日付を date.txt に書き込みます
参考
ワード検索
※入力キーワードが、関数名・説明文・タグに含まれるものを検索関数名アルファベット別
最終更新一覧
●stristr
大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却
●stripslashes
バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く
●stripos
大文字小文字を区別せずに文字列が最初に現れる位置を取得する
●stripcslashes
addcslashes() でクォートされた文字列をアンクォートする
●strip_tags
文字列から HTML と PHP のタグを除去して返却
●strcspn
指定した文字が最初に現れる位置を調べる
●strcoll
ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する
●strcmp
2つの文字列を比較し同じか（あるいは大小）を判定する
●strchr
strstr() のエイリアス
●strcasecmp
2つの文字列を比較（大文字小文字を区別せず同じとみなす）
カテゴリー一覧
PHP の振る舞いの変更
音声フォーマットの操作
認証サービス
コマンドライン関連
圧縮およびアーカイブ
暗号
データベース関連
日付および時刻関連
ファイルシステム
自然言語および文字エンコーディング
画像処理および作成
メール関連
数学
テキスト以外の MIME 型
プロセス制御
その他の基本モジュール
その他のサービス
検索エンジン用の拡張モジュール
サーバー固有のモジュール
セッション関連
テキスト処理
変数・データ型関連
ウェブサービス
Windows 用のモジュール
XML 操作
GUI用の拡張モジュール