Manpages

j

z

d, i

int 引 き 数 を 符 号 付 き 10 進 表 記 に 変 換 す る 。 精 度 指 定 が あ れ ば 、 精 度 で 指 定 し た 桁 数 は 必 ず 出 力 さ れ る 。 変 換 後 の 値 が 指 定 さ れ た 桁 数 に 足 り な い 場 合 は 、 左 側 が 0 で 埋 め ら れ る 。 デ フ ォ ル ト の 精 度 は 1 で あ る 。 0 を 表 示 し よ う と し た 時 に 、 明 示 的 に 精 度 と し て 0 が 指 定 さ れ て い る と 、 出 力 は 空 文 字 列 と な る 。

e, E

double 引 き 数 を 丸 め て [−]d.ddde±dd の 形 に 変 換 す る 。 小 数 点 の 前 に は 一 桁 の 数 字 が あ り 、 小 数 点 以 下 の 桁 数 は 精 度 で 指 定 さ れ た 桁 数 に な る 。 精 度 は 指 定 さ れ な か っ た 場 合 6 と み な さ れ る 。 精 度 が 0 の 場 合 に は 、 小 数 点 以 下 は 表 示 さ れ な い 。 E 変 換 で は 、 指 数 を 表 現 す る と き に (e で は な く ) E が 使 わ れ る 。 指 数 部 分 は 少 な く と も 2桁 表 示 さ れ る 。 つ ま り 、 指 数 の 値 が 0 の 場 合 に は 、 00 と 表 示 さ れ る 。

f, F

double 引 き 数 を 丸 め て [−]ddd.ddd の 形 の 10進 表 現 に 変 換 す る 。 小 数 点 の 後 の 桁 数 は 、 精 度 で 指 定 さ れ た 値 と な る 。 精 度 が 指 定 さ れ て い な い 場 合 に は 6 と し て 扱 わ れ る 。 精 度 と し て 明 示 的 に 0 が 指 定 さ れ た と き に は 、 小 数 点 以 下 は 表 示 さ れ な い 。 小 数 点 を 表 示 す る 際 に は 、 小 数 点 の 前 に 少 な く と も 一 桁 は 数 字 が 表 示 さ れ る 。

g, G

double 引 き 数 を f か e (G 変 換 の 場 合 は F か E) の 形 式 に 変 換 す る 。 精 度 は 表 示 す る 桁 数 を 指 定 す る 。 精 度 が 指 定 さ れ な い 場 合 は 、 6桁 と み な さ れ る 。 精 度 が 0 の 場 合 は 、 1桁 と み な さ れ る 。 変 換 さ れ る 値 の 指 数 が 、 −4 よ り 小 さ い か 、 精 度 以 上 の 場 合 に 、 e 形 式 が 使 用 さ れ る 。 変 換 さ れ た 結 果 の 小 数 部 分 の 末 尾 の 0 は 削 除 さ れ る 。 小 数 点 が 表 示 さ れ る の は 、 小 数 点 以 下 に 数 字 が 少 な く と も 一 つ あ る 場 合 に だ け で あ る 。

a, A

(C99 に は あ る が SUSv2 に は な い が SUSv3 で 追 加 さ れ た ) a 変 換 で は 、 double 引 き 数 を (abcdef の 文 字 を 使 っ て ) [−]0xh.hhhhp± 形 式 の 16 進 表 記 に 変 換 す る 。 A 変 換 で は 、 前 置 文 字 列 0X, 文 字 ABCDEF, 指 数 文 字 P を 用 い る 。 小 数 点 の 前 に は 1 桁 の 16 進 数 が 置 か れ 、 小 数 点 の 後 ろ の 桁 数 は 精 度 で 指 定 さ れ た 値 と な る 。 デ フ ォ ル ト の 精 度 は 、 そ の 値 が 2 進 数 で 正 確 に 表 現 で き る 場 合 に は 、 そ の 値 を 正 確 に 表 現 で き る 桁 数 と な る 。 そ れ 以 外 の 場 合 は 、 double 型 の 値 を 区 別 す る の に 十 分 な 大 き さ と な る 。 小 数 点 の 前 の 数 字 は 、 正 規 化 さ れ て い な い 数 の 場 合 は い く つ に な る か 分 か ら な い 。 正 規 化 さ れ た 数 の 場 合 は 、 0 以 外 の 値 に な る が 、 い く つ に な る か は 分 か ら な い 。

c

l 修 飾 子 が な け れ ば 、 int 引 き 数 を unsigned char に 変 換 し て 、 そ の 結 果 に 対 応 す る 文 字 を 出 力 す る 。 l 修 飾 子 が あ れ ば 、 wint_t (ワ イ ド 文 字 ) 引 き 数 を 、 wcrtomb(3) 関 数 を 初 期 シ フ ト 状 態 で 呼 び 出 し て マ ル チ バ イ ト 文 字 列 に 変 換 し 、 変 換 さ れ た マ ル チ バ イ ト 文 字 列 を 出 力 す る 。

s

l 修 飾 子 が な い 場 合 、 引 き 数 は const char * 型 で 文 字 型 の 配 列 へ の ポ イ ン タ ー (文 字 列 へ の ポ イ ン タ ー ) で あ る こ と が 期 待 さ れ て い る 。 配 列 中 の 文 字 は 、 終 端 の ヌ ル バ イ ト ('\0') が 出 て く る ま で 出 力 さ れ る (終 端 文 字 は 出 力 さ れ な い )。 精 度 が 指 定 さ れ て い る と 、 指 定 さ れ た 字 数 以 上 は 出 力 さ れ な い 。 精 度 が 指 定 さ れ た 場 合 に は 、 終 端 バ イ ト が 存 在 す る 必 要 は な い 。 精 度 が 指 定 さ れ て い な か っ た り 、 精 度 の 値 が 配 列 の 大 き さ よ り 大 き い 場 合 に は 、 配 列 は 終 端 の ヌ ル バ イ ト を 含 ん で い な け れ ば な ら な い 。

C

(C99, C11 に は な い が SUSv2, SUSv3, SUSv4 に は あ る ) lc と 同 じ 。 使 っ て は な ら な い 。

S

(C99, C11 に は な い が SUSv2, SUSv3, SUSv4 に は あ る ) ls と 同 じ 。 使 っ て は な ら な い 。

p

void * ポ イ ン タ ー 引 き 数 を (%#x や %#lx の よ う な ) 16 進 数 で 出 力 す る 。

こ れ ま で に 書 き 込 ま れ た 文 字 数 が 対 応 す る 引 き 数 が 指 す 整 数 に 格 納 さ れ る 。 こ の 引 き 数 は int * 系 で な け れ ば な ら ず 、 そ の サ イ ズ は 指 定 さ れ た 整 数 の 長 さ 修 飾 子 (省 略 可 能 ) と 一 致 し て い な け れ ば な ら な い 。 引 き 数 の 変 換 は 行 わ れ な い 。 変 換 指 定 に フ ラ グ 、 フ ィ ー ル ド 幅 、 精 度 に 含 ま れ て い た 場 合 の 動 作 は 不 定 で あ る 。
m

(glibc で の 拡 張 ) strerror(errno) の 出 力 を 表 示 す る 。 引 き 数 は 必 要 な い 。

%

'%' 文 字 を 出 力 す る 。 変 換 さ れ る 引 き 数 は 無 い 。 変 換 指 定 全 体 を 書 く と "%%" と な る 。

準 拠

fprintf(), printf(), sprintf(), vprintf(), vfprintf(), vsprintf() 関 数 は 、 C89 と C99 に 準 拠 し て い る 。 snprintf() と vsnprintf() は C99 に 準 拠 し て い る 。

snprintf() の 返 り 値 を 見 る と 、 SUSv2 と C99 標 準 は 互 い に 矛 盾 し て い る 。 SUSv2 で は 、 snprintf() が size=0 で 呼 び 出 さ れ た 場 合 、 1 未 満 の 値 を 何 か 返 り 値 と す る よ う に 規 定 し て い る 。 一 方 C99 で は 、 こ の よ う な 場 合 str を NULL と し 、 返 り 値 と し て (通 常 通 り ) 出 力 バ ッ フ ァ ー が 十 分 な 大 き さ が あ っ た 場 合 に 出 力 さ れ る で あ ろ う 文 字 数 を 返 す 。 SUSv3 や そ れ 以 降 で は C99 の snprintf() の 規 定 に あ わ せ た も の と な っ て い る 。

glibc 2.1 で は 、 長 さ 修 飾 子 hh, j, t, z と 変 換 文 字 a, A が 追 加 さ れ た 。

glibc 2.2 で は 、 C99 で 規 定 さ れ た 意 味 で の 変 換 文 字 F と フ ラ グ 文 字 I が 追 加 さ れ た 。

注 意

テ キ ス ト を buf に 追 加 す る の に 、 軽 率 に も 次 の よ う な コ ー ド を 使 っ て い る プ ロ グ ラ ム が あ る 。

sprintf(buf, "%s some further text", buf); し か し な が ら 、 標 準 規 格 で は 、 sprintf(), snprintf(), vsprintf(), vsnprintf() の 呼 び 出 し に お い て 、 コ ピ ー 元 と コ ピ ー 先 の バ ッ フ ァ ー が 重 な っ て い た 場 合 の 結 果 は 不 定 で あ る 、 と 明 記 さ れ て い る 。 使 用 す る gcc(1) の バ ー ジ ョ ン や 指 定 し た コ ン パ イ ラ の オ プ シ ョ ン 次 第 で は 、 上 記 の よ う な 呼 び 出 し で 、 期 待 し た 結 果 が 得 ら れ 「 な い 」 こ と が あ る 。

glibc の snprintf() と vsnprintf() の 実 装 は 、 バ ー ジ ョ ン 2.1 以 降 は C99 標 準 に 準 拠 し て お り 、 上 記 の 通 り の 動 作 を す る 。 glibc 2.0.6 ま で は 、 出 力 が 切 り 詰 め ら れ た 場 合 は −1 を 返 す 。

バ グ

sprintf() と vsprintf() は 勝 手 に 十 分 に 長 い 文 字 列 領 域 が あ る と 仮 定 す る の で 、 呼 び 出 し 側 は 実 際 の 領 域 か ら あ ふ れ な い よ う に 注 意 し な け れ ば な ら な い 。 し か し 、 こ れ を 保 証 す る こ と が 不 可 能 な 場 合 が 多 い 。 生 成 さ れ る 文 字 列 の 長 さ は ロ ケ ー ル 依 存 で あ り 、 予 測 が 難 し い こ と に 注 意 。 代 わ り に snprintf() と vsnprintf() (ま た は asprintf(3) と vasprintf(3)) を 使 う こ と 。

printf(foo); の よ う な コ ー ド は し ば し ば バ グ を 引 き 起 こ す 。 な ぜ な ら foo に % 文 字 が 含 ま れ て る か も し れ な い か ら で あ る 。 foo が 信 頼 で き な い ユ ー ザ ー 入 力 か ら 作 ら れ て い る 場 合 に は 、 そ の 中 に %n が 含 ま れ て い る こ と が あ り 、 printf() 呼 び 出 し 時 に メ モ リ ー へ の 書 き 込 み が 起 こ り 、 セ キ ュ リ テ ィ ー ホ ー ル を 作 る こ と に な る か も し れ な い 。

例

Pi を 5 桁 で 出 力 す る 。

#include <math.h>
#include <stdio.h>
fprintf(stdout, "pi = %.5f\n", 4 * atan(1.0)); 日 付 と 時 間 を "Sunday, July 3, 10:02" の 形 式 で 出 力 す る 。 (weekday と month は 文 字 列 へ の ポ イ ン タ ー で あ る )

#include <stdio.h>
fprintf(stdout, "%s, %s %d, %.2d:%.2d\n",

#include <stdio.h>
fprintf(stdout, format,

format は ロ ケ ー ル に 依 存 し て お り 、 引 き 数 の 順 番 を 変 え る こ と も で き る 。 format が

"%1$s, %3$d. %2$s, %4$d:%5$.2d\n" で あ れ ば 、 "Sonntag, 3. Juli, 10:02" と い う 結 果 に な る 。 十 分 に 大 き な 文 字 列 領 域 を 確 保 し て 、 そ こ に メ ッ セ ー ジ を 格 納 す る に は (glibc 2.0 と glibc 2.1 の 両 方 で 正 し く 動 作 す る コ ー ド ):

#include <stdio.h>
#include <stdlib.h>
#include <stdarg.h>

char *
make_message(const char *fmt, ...)
{
int n;
int size = 100; /* Guess we need no more than 100 bytes */
char *p, *np;
va_list ap;

p = malloc(size);
if (p == NULL)
return NULL;

while (1) {

/* Try to print in the allocated space */

va_start(ap, fmt);
n = vsnprintf(p, size, fmt, ap);
va_end(ap);

/* Check error code */

if (n < 0) {
free(p);
return NULL; }

/* If that worked, return the string */

if (n < size)
return p;

/* Else try again with more space */

size = n + 1; /* Precisely what is needed */

np = realloc(p, size);
if (np == NULL) {
free(p);
return NULL; }
else {
p = np; } } } バ ー ジ ョ ン 2.0.6 よ り 前 の glibc で 切 り 詰 め が 起 こ っ た 場 合 、 切 り 詰 め は 適 切 に 処 理 さ れ ず 、 エ ラ ー と し て 扱 わ れ る 。

関 連 項 目

printf(1), asprintf(3), dprintf(3), scanf(3), setlocale(3), wcrtomb(3), wprintf(3), locale(5)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。