sprintf

文字列書式に従って文字配列に書き込みます． 

#include <stdio.h>

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

sprintf 関数は formatが指す書式文字列に従って s が指す文字配列へ書き込みを行います．文字配列に書き込んだ文字列の後にはナル文字 ('\0') が書き込まれます．

領域の重なり合うオブジェクト間でコピーが行われるとき，その動作は未定義です．

sprintf の動作は生成された出力をストリーム (stream) ではなく，引数 s で指定する配列に書き込むことを除いて fprintf と同じです．

注意!
sprintf はバッファオーバーフロー (buffer over-flow) を発生させやすい関数の 1 つです．

引数

  • s: 文字配列 (ここに書き込まれる)
  • format: 書式文字列 (詳しくは printf の書式文字列を参照してください)

戻り値

  • 成功した場合: 書き込んだ文字数 (終端ナル文字は含めない)
  • 失敗した場合: 負の値

C言語サンプルプログラム

sprintf 関数を使用して文字配列に書き込むサンプルプログラムを以下に示します．

/* header files */
#include <stdio.h>
#include <stdlib.h>

/* macros */
#define N 256

/* main */
int main(void) {
    char s[N] = {'\0'};
    char name[] = "ペパーミント・パティ";
    char sex[] = "女性";
    int age = 7;

    sprintf(s, "%sさんは%d歳の%sです．", name, age, sex);

    printf("%s\n", s);

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムの実行結果は以下のようになります．

ペパーミント・パティさんは7歳の女性です．