strndup

 

C

编译器支持

语言

头文件

类型支持

程序实用工具

可变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间实用工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

技术规范

嵌入式处理器的扩展

动态内存扩展

浮点数扩展第 1 部分：二进制浮点数

浮点数扩展第 4 部分：补充函数

 

动态内存扩展

fmemopen

open_memstreamopen_wmemstream

asprintfaswprintfvasprintfvaswprintf

getlinegetwlinegetdelimgetwdelim

strdup

strndup

 

在头文件 <string.h> 中定义
char *strndup( const char *str, size_t size );		(动态内存 TR)

返回指向一个空终止的字节字符串的指针，该字符串包含最多 size 个字节从 str 指向的字符串中复制的字节。如果在第一个 size 个字节中没有遇到空终止符，则将其添加到复制的字符串中。

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

如果发生错误，则返回一个空指针，并且可能设置 errno。

与 Dynamic Memory TR 中的所有函数一样，strndup 仅保证在实现定义了 __STDC_ALLOC_LIB__ 并且用户在包含 string.h 之前将 __STDC_WANT_LIB_EXT2__ 定义为整数常量 1 的情况下可用。

参数

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

返回值

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

备注

该函数与 POSIX strndup 相同，只是允许，但不强制在错误时设置 errno。

示例

运行此代码

#ifdef __STDC_ALLOC_LIB__
#define __STDC_WANT_LIB_EXT2__ 1
#else
#define _POSIX_C_SOURCE 200809L
#endif
 
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    const char *s1 = "String";
    char *s2 = strndup(s1, 2);
    printf("strndup(\"String\", 2) == %s\n", s2);
    free(s2);
}

输出

strndup("String", 2) == St

另请参阅

strdup (动态内存 TR)	分配字符串的副本 (函数)
strncpystrncpy_s (C11)	从一个字符串复制一定数量的字符到另一个字符串 (函数)
malloc	分配内存 (函数)