strndup

 

C

编译器支持

语言

头文件

类型支持

程序实用程序

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用程序

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

字符串库

字节字符串

多字节字符串

宽字符串

 

以空字符结尾的字节字符串

函数
字符操作
isalnum isalpha islower isupper isdigit isxdigit isblank (C99)	iscntrl isgraph isspace isprint ispunct tolower toupper
转换为和从数值格式转换
atoiatolatoll (C99) atof strtolstrtoll (C99) strtoulstrtoull (C99)	strtoimaxstrtoumax (C99)(C99) strtofstrtodstrtold (C99)(C99) strfromfstrfromdstrfroml (C23)(C23)(C23)
字符串操作
strcpystrcpy_s (C11) strncpystrncpy_s (C11) strcatstrcat_s (C11)	strncatstrncat_s (C11) strxfrm strdup (C23) strndup (C23)
字符串检查
strlenstrnlen_s (C11) strcmp strncmp strcoll strchr strrchr	strspn strcspn strpbrk strstr strtokstrtok_s (C11)
内存操作
memchr memcmp memsetmemset_explicitmemset_s (C23)(C11)	memcpymemcpy_s (C11) memmovememmove_s (C11) memccpy (C23)
其他
strerrorstrerror_sstrerrorlen_s (C11)(C11)

 

在头文件 <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"

参见

strdup (C23)	分配一个字符串的副本 (函数)
strcpystrcpy_s (C11)	将一个字符串复制到另一个字符串 (函数)
malloc	分配内存 (函数)
free	释放之前分配的内存 (函数)