strdup

 

C

編譯器支援

語言

標頭檔案

型別支援

程式工具

變參函式支援

錯誤處理

動態記憶體管理

字串庫

演算法

數值

日期和時間工具

輸入/輸出支援

本地化支援

併發支援 (C11)

技術規範

符號索引

 

技術規範

嵌入式處理器擴充套件

動態記憶體擴充套件

浮點擴充套件第1部分：二進位制浮點

浮點擴充套件第4部分：補充函式

 

動態記憶體擴充套件

fmemopen

open_memstreamopen_wmemstream

asprintfaswprintfvasprintfvaswprintf

getlinegetwlinegetdelimgetwdelim

strdup

strndup

 

定義於標頭檔案 <string.h>
char * strdup( const char *str1 );		(動態記憶體 TR)

返回一個指向空終止位元組字串的指標，該字串是 str1 所指向字串的副本。返回的指標必須傳遞給 free 以避免記憶體洩漏。

如果發生錯誤，則返回空指標，並可能設定 errno。

與動態記憶體 TR 中的所有函式一樣，僅當實現定義了 __STDC_ALLOC_LIB__ 且使用者在包含 string.h 之前將 __STDC_WANT_LIB_EXT2__ 定義為整數常量 1 時，才保證 strdup 可用。

引數

str1

-

指向要複製的以空字元結尾的位元組字串的指標

返回值

指向新分配字串的指標，如果發生錯誤則為 null 指標。

注意

該函式與 POSIX strdup 相同。

示例

執行此程式碼

#ifdef __STDC_ALLOC_LIB__
#define __STDC_WANT_LIB_EXT2__ 1
#else
#define _POSIX_C_SOURCE 200809L
#endif
 
#include <string.h>
#include <assert.h>
#include <stdlib.h>
 
int main(void)
{
    const char *s1 = "String";
    char *s2 = strdup(s1);
    assert(strcmp(s1, s2) == 0);
    free(s2);
}

另請參閱

strndup (動態記憶體 TR)	分配一個指定大小的字串副本 (函式)
strcpystrcpy_s (C11)	將一個字串複製到另一個字串 (函式)
malloc	分配記憶體 (函式)