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 起)

返回一個指向以空字元結尾的位元組字串的指標，該字串包含最多 size 個位元組的副本，這些位元組來自 src 指向的字串。新字串的空間是透過呼叫 malloc 獲得的。如果在前 size 個位元組中沒有遇到空終止符，它將被附加到複製的字串中。

返回的指標必須傳遞給 free 以避免記憶體洩漏。

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

引數

src	-	指向要複製的以空字元結尾的位元組字串的指標
size	-	從 src 複製的最大位元組數

返回值

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

注意

此函式與 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	釋放先前分配的記憶體 (函式)