strlcpy

• srcからdestに、最大n-1バイトを複写する。
• destに複写された文字列の最後は、必ずNUL文字で終わる(サイズnが0で無い場合)。
• nは、destで確保されたバッファーのサイズのsizeofを格納するのが一般的な用法である。
• srcとdestが重なっていた場合の挙動は未定義である。

• strncpyは、srcがnより長い場合、destがNUL文字で終わらないという欠点があるが、strlcpyはこの問題が解決されている。
• strncpyは、srcがnより短い場合、残りをNUL文字で埋めるが、strlcpyにはそのような機能はない。

/usr/src/lib/libc/string/strncpy.cで、次のように定義されている(FreeBSD 8.0時点)。

size_t
strlcpy(char * __restrict dst, const char * __restrict src, size_t siz)
{
    char *d = dst;
    const char *s = src;
    size_t n = siz;

    /* Copy as many bytes as will fit */
    if (n != 0) {
        while (--n != 0) {
            if ((*d++ = *s++) == '\0')
                break;
        }
    }

    /* Not enough room in dst, add NUL and traverse rest of src */
    if (n == 0) {
        if (siz != 0)
            *d = '\0';      /* NUL-terminate dst */
        while (*s++)
            ;
    }

    return(s - src - 1);    /* count does not include NUL */
}

カーネル用の処理は/usr/src/sys/libkern/strlcpy.cにあり、処理の内容は概ね同じだが、こちらはK&Rスタイルであるなど若干の相違がある。