strncpy

[stɹɪŋ ɛn ˈkɒpi] ストリンエヌコピー

1. C言語の標準ライブラリ関数の一つで、指定されたバイト数まで文字列をコピーします。特に、コピー先のバッファサイズを超えないように制限するために使用されます。

C言語における文字列操作関数の一つで、安全性の観点から導入されました。指定されたコピーバイト数（`n`）は、宛先バッファのサイズを超えないように設定することが重要です。ソース文字列が`n`文字より短い場合、残りの領域はNULL文字で埋められます。しかし、ソース文字列が`n`文字以上の場合、`n`文字だけがコピーされ、宛先バッファはNULL終端されません。このため、`strncpy`使用後には明示的なNULL終端処理が推奨されます。

char dest[10]; strncpy(dest, "hello", sizeof(dest) - 1); dest[sizeof(dest) - 1] = '\0'; (10バイトの文字配列`dest`を宣言し、"hello"を`dest`にコピーします。バッファオーバーフローを防ぐため、コピーする最大バイト数を制限し、最後にNULL終端します。)

• strncpy: C言語の標準ライブラリ関数で、文字列を安全にコピーするために使われます。
• dest: 文字列のコピー先となる宛先バッファ（文字配列）を指します。
• "hello": コピー元のソース文字列です。
• sizeof(dest) - 1: コピーする文字の最大数（バイト数）を指定します。通常、バッファの総サイズからNULL終端文字用の1バイトを引いた値です。
• dest[sizeof(dest) - 1] = '\0';: `strncpy`関数は常にNULL終端を保証しないため、コピー後に明示的にNULL文字を配列の最後に設定して、有効なC文字列として機能するようにします。

char buffer[10]; strncpy(buffer, "short", 10); (10バイトの配列`buffer`に"short"をコピーします。コピー対象の文字数が指定された最大バイト数より少ない場合、残りのバイトはNULLで埋められます。)

• char buffer[10];: 10バイトの文字配列`buffer`を宣言します。
• strncpy(buffer, "short", 10);: `buffer`に"short"をコピーします。コピー長がソース文字列より長いため、残りのバイトはNULL文字で埋められますが、文字列の末尾にNULL終端文字は自動的に追加されません。

char small_buffer[5]; strncpy(small_buffer, "longstring", 5); (5バイトの配列`small_buffer`に"longstring"をコピーします。コピー長がバッファサイズと同じかそれ以上の場合、ソース文字列が切り詰められ、バッファは自動的にNULL終端されません。)

• char small_buffer[5];: 5バイトの文字配列`small_buffer`を宣言します。
• strncpy(small_buffer, "longstring", 5);: `small_buffer`に"longstring"の最初の5文字をコピーします。コピー長がバッファサイズと同じため、バッファはNULL終端されません。

関連

• strcpy
• strncpy_s
• strlcpy
• memcpy
• memset
• C language
• buffer overflow
• string handling