strndup

src が指す文字列から最大で size バイトのコピーを含む、ヌル終端バイト文字列へのポインタを返します。新しい文字列のための領域は malloc が呼び出されたかのようにして取得されます。最初の size バイトでヌル終端文字が見つからない場合、複製された文字列に追加されます。

返されたポインタはメモリリークを避けるために free に渡されなければなりません。

エラーが発生した場合、ヌルポインタが返され、 errno が設定される可能性があります。

パラメータ

戻り値

新しく割り当てられた文字列へのポインタ、またはエラーが発生した場合はヌルポインタ。

注記

この関数は、 POSIX strndup と同一ですが、エラー発生時に errno を設定することが許可されている（必須ではない）点が異なります。

例

#include <string.h>
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    const size_t n = 3;
    const char *src = "Replica";
    char *dup = strndup(src, n);
    printf("strndup(\"%s\", %lu) == \"%s\"\n", src, n, dup);
    free(dup);
    src = "Hi";
    dup = strndup(src, n);
    printf("strndup(\"%s\", %lu) == \"%s\"\n", src, n, dup);
    free(dup);
    const char arr[] = {'A','B','C','D'}; // NB: 末尾に '\0' なし
    dup = strndup(arr, n);
    printf("strndup({'A','B','C','D'}, %lu) == \"%s\"\n", n, dup);
    free(dup);
}

strndup("Replica", 3) == "Rep"
strndup("Hi", 3) == "Hi"
strndup({'A','B','C','D'}, 3) == "ABC"

関連項目