sprintf | Programming Place Plus　Ｃ言語編　標準ライブラリのリファレンス

概要

文字の配列へ、変換指定に沿って変換された文字列を出力する。

ヘッダ

stdio.h

形式

int sprintf(char* restrict s, const char* restrict format, …);

引数

s

結果を格納する配列を指すポインタ。

format

変換指定を含んだ、あるいは含まないプレーンな文字列。

…

format に含まれている変換指定子に対応した個数のパラメータ。

戻り値

正常に終了した場合は、出力した文字数が返される（末尾のヌル文字は含まない）。エラー発生時は負数が返される。

詳細

結果を配列へ格納することを除き、printf関数と同様であり、同じ機能を持つ。
文字列s の末尾には、自動的に ‘\0’ が付加される。

注意

必要な個数の実引数が指定されていない場合の動作は未定義。余分に指定されている場合には、評価は行われるが、sprintf関数としては無視する。

結果を配列へ格納するため、printf関数と異なり、バッファオーバーフローの可能性を配慮しなければならない。変換指定子を複数使うケースでは、丁寧に最大文字数を考える必要があり、安全に使うことは難しい。

使用例

#include <stdio.h>

int main(void)
{
    char str[20];

    sprintf(str, "%d %3d %03d", 10, 10, 10);
    puts(str);
}

実行結果：

10  10 010

関連

解説章