命名空间
变体
操作

strndup

来自 cppreference.cn
< c‎ | string‎ | byte
定义于头文件 <string.h>
char *strndup( const char *src, size_t size );
(C23 起)

返回一个指向空终止字节字符串的指针,该字符串包含从 src 指向的字符串复制的最多 size 个字节。新字符串的空间如同调用 malloc 获取。如果在前 size 个字节中未遇到空终止符,则将其附加到复制的字符串。

返回的指针必须传递给 free 以避免内存泄漏。

如果发生错误,则返回空指针,并且可能设置 errno

内容

[编辑] 参数

src - 指向要复制的空终止字节字符串的指针
size - src 复制的最大字节数

[编辑] 返回值

指向新分配的字符串的指针,如果发生错误,则为空指针。

[编辑] 注解

该函数与 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: no trailing '\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"

[编辑] 参见

(C23)
分配字符串的副本
(函数) [编辑]
将一个字符串复制到另一个字符串
(函数) [编辑]
分配内存
(函数) [编辑]
释放先前分配的内存
(函数) [编辑]