strdup

 

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 *strdup( const char *src );		(自 C23 起)

返回一個指向以空字元結尾的位元組字串的指標，該字串是 src 所指向的字串的副本。新字串的空間獲取方式如同呼叫了 malloc。返回的指標必須傳遞給 free 以避免記憶體洩漏。

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

引數

src

-

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

返回值

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

注意

該函式與 POSIX strdup 相同。

示例

執行此程式碼

#include <string.h>
#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    const char *s1 = "Duplicate me!";
    char *s2 = strdup(s1);
    printf("s2 = \"%s\"\n", s2);
    free(s2);
}

輸出

s2 = "Duplicate me!"

參閱

strndup (C23)	分配一個指定大小的字串副本 (函式)
strcpystrcpy_s (C11)	將一個字串複製到另一個字串 (函式)
malloc	分配記憶體 (函式)
free	釋放先前分配的記憶體 (函式)