Skip to content

snprintf.md

Latest commit

 

History

History
73 lines (54 loc) · 2.46 KB

snprintf.md

File metadata and controls

73 lines (54 loc) · 2.46 KB
Raw

snprintf

  • cstdio[meta header]
  • std[meta namespace]
  • function[meta id-type]
  • cpp11[meta cpp]
namespace std {
  int snprintf(char* buffer, size_t n, const char* format, ...);
}
  • size_t[link /reference/cstddef/size_t.md]

概要

書式を指定して、文字数の上限つきで文字列領域に出力する。

出力される文字数は、ヌル文字を含めてn文字以下に制限される。nが0より大きい場合、出力の末尾には必ずヌル文字が書き込まれる。

戻り値

nが十分に大きければ書き込まれたはずの文字数（ヌル文字を含まない）を返す。出力エラーが発生した場合は負の値を返す。

つまり、戻り値がn以上である場合は、出力が切り詰められたことを意味する。

備考

  • sprintf()と違って書き込む文字数の上限を指定できるため、バッファオーバーランを避けられる
  • nが0の場合、bufferはヌルポインタでもよく、なにも書き込まれない。この性質を利用して、必要なバッファサイズを事前に求められる
  • C++の文字列フォーマットには、型安全なstd::format()（C++20）も使用できる

例

#include <cstdio>

int main()
{
  char buffer[8];

  // バッファに収まる場合
  int len = std::snprintf(buffer, sizeof(buffer), "%d-%d", 12, 34);
  std::printf("%s (%d)\n", buffer, len);

  // バッファに収まらない場合は切り詰められる。
  // 戻り値は、収まったとしたら必要だった文字数
  len = std::snprintf(buffer, sizeof(buffer), "%d-%d", 123456, 789);
  std::printf("%s (%d)\n", buffer, len);
}
  • std::snprintf[color ff0000]
  • std::printf[link printf.md]

出力

12-34 (5)
123456- (10)

処理系

備考

  • 動作確認した範囲での最小バージョンを記載している。Clangは3.4（Compiler Explorerで利用できる最古のバージョン）、Visual C++は2019（同左）で動作を確認しており、それ以前のバージョンでも使用できる可能性がある

関連項目