pfmt(3C)

構文

説明

pfmt() 関数は、 stream に標準形式のメッセージを書き込みます。 また、 stream へローカライズされた文字列を書き込むこともできます。 pfmt() に対する引き数は、 printf() スタイルの書式でフォーマットされます。 vpfmt() は、引き数が引き数リスト stdarg(5) を参照) で渡されること以外は、 pfmt() と同じです。

stream に表示される標準形式には、次のフィールドがあります。

label 文字列は、 setlabel(3C) で定義されます。 ラベルが定義されていない場合、このフィールドは使用されません。 severity 文字列は、 flags の severity グループで制御されます。 text 文字列は、フォーマットされたユーザー文字列です。

flags は、どのようにフォーマットするかを制御します。 制御情報は、いくつかの異なるグループに分けられます。 各グループから、１ つのフラグだけを、セットできます。

fmt 文字列には、次のフィールドがあります。

catalog は、 mkmsgs(1) で作成されたメッセージカタログであり、ローカライズされたメッセージが検索されます。 msg_number は、メッセージカタログから取り出す文字列を識別する正の索引番号です (１ から始まります)。 def_str は、 pfmt() が現在のロケールまたはデフォルトのロケールの catalog からメッセージを取り出すことができなかった場合に使用する、デフォルト文字列です。 メッセージカタログが存在しない場合、あるいは、 msg_number が範囲外の値の場合、エラーが発生します。

catalog を指定しなかった場合、 pfmt() は setcat(3C) で定義されたメッセージカタログを使用します。 MM_NOGET を flags にセットした場合、 def_str だけを、指定しなければなりません。

次のような状態の場合、 pfmt() 関数は Message not found!! を表示します。

戻り値

pfmt() と vpfmt() は、正常終了すると、書き込んだバイト数を返します。 失敗すると、負の値を返します。

例

例 １

次のようなメッセージを生成します。

例 ２

次のようなメッセージを生成します。

例 ３

次のようなメッセージを生成します。

例 ４

次のようなメッセージを生成します。

参照

mkmsgs(1), addsev(3C), gettxt(3C), setcat(3C), setlabel(3C), setlocale(3C), printf(3S), stdarg(5), thread_safety(5)

標準準拠

pfmt(): SVID3

vpfmt(): SVID3