Cライブラリのsnprintf()
の snprintf() 関数 で定義されています ヘッダー ファイルであり、指定された文字列を指定された形式で指定された長さまで保存するために使用されます。
snprintf() メソッドの特徴:
- snprintf() 関数は、一連の文字と値をフォーマットして配列バッファーに保存します。
- snprintf() 関数は、バッファに書き込まれる最大文字数 (NULL 文字の末尾を含む) を示す引数「n」を受け取ります。
- snprintf() 関数は、printf() 関数の出力をバッファにリダイレクトするために使用されます。
- snprintf() は、渡された「n」の値に関係なく、バッファーに書き込まれるはずだった文字数 (ヌル終端文字を除く) も返します。
- したがって、戻り値が負ではなく、「n」より小さい場合にのみ、文字列は期待どおりに完全に書き込まれています。
構文： snprintf() メソッドの構文は次のとおりです。
int snprintf(char *str, size_t サイズ, const char *format, …);
パラメーター：
- *str : はバッファです。 size : バッファに書き込まれる最大バイト数 (文字数) です。 format : printf の format と同じ仕様に従うフォーマット文字列を含む C 文字列 … : オプションの ( …) 引数 printf で見られる (%d, myint) のような単なる文字列形式です。
戻り値:
- 「n」が十分に大きかった場合にバッファに書き込まれる文字数。終端のヌル文字はカウントされません。
- エンコード エラーが発生した場合は、負の数が返されます。
以下は、snprintf() メソッドの動作を示す例です。
例 1:
C
// C program to demonstrate snprintf()> #include> int> main()> {> > char> buffer[50];> > char> * s => 'geeksforgeeks'> ;> > // Counting the character and storing> > // in buffer using snprintf> > printf> (> 'Writing %s onto buffer'> > ' with capacity 6'> ,> > s);> > int> j = snprintf(buffer, 6,> '%s
'> , s);> > // Print the string stored in buffer and> > // character count> > printf> (> '
String written on '> > 'buffer = %s'> , buffer);> > printf> (> '
Value returned by '> > 'snprintf() method = %d
'> , j);> > return> 0;> }> |
出力
Writing geeksforgeeks onto buffer with capacity 6 String written on buffer = geeks Value returned by snprintf() method = 14
例 2:
C
// C program to demonstrate snprintf()> #include> int> main()> {> > char> buffer[50];> > > // join two or more strings> > char> * str1 => 'quick'> ;> > char> * str2 => 'brown'> ;> > char> * str3 => 'lazy'> ;> > int> max_len => sizeof> buffer;> > int> j = snprintf(buffer, max_len,> > 'The %s %s fox jumped over the %s dog.'> ,> > str1, str2, str3);> > printf> (> '
The number of bytes printed to 'buffer' '> > '(excluding the null terminator) is %d
'> ,> > j);> > if> (j>= max_len)>> > fputs> (> 'Buffer length exceeded; string truncated'> ,> > stderr);> > puts> (> 'Joined string:'> );> > puts> (buffer);> > return> 0;> }> |
出力
The number of bytes printed to 'buffer' (excluding the null terminator) is 45 Joined string: The quick brown fox jumped over the lazy dog.
