_strdup
, _wcsdup
, _mbsdup
重複字串。
重要
在 Windows 執行階段中執行的應用程式中無法使用 _mbsdup
。 如需詳細資訊,請參閱 CRT functions not supported in Universal Windows Platform apps (通用 Windows 平台應用程式中不支援的 CRT 函式)。
語法
char *_strdup(
const char *strSource
);
wchar_t *_wcsdup(
const wchar_t *strSource
);
unsigned char *_mbsdup(
const unsigned char *strSource
);
參數
strSource
以 Null 結束的來源字串。
傳回值
每個函式都會傳回復制字串的儲存位置指標,如果 NULL
無法配置儲存體,則傳回 。
備註
函 _strdup
式會呼叫 malloc
來配置儲存空間以供 複本 strSource
使用,然後複製到 strSource
配置的空間。
_wcsdup
和 _mbsdup
分別是 _strdup
的寬字元版本和多位元組字元版本。 的引數和傳回值 _wcsdup
是寬字元字串。 的引數和傳回值 _mbsdup
是多位元組字元字串。 除此之外,這三個函式的行為相同。
根據預設,此函式的全域狀態會限定于應用程式。 若要變更此行為,請參閱 CRT 中的全域狀態。
泛型文字常式對應
TCHAR.H 常規 |
_UNICODE 和 _MBCS 未定義 |
_MBCS 定義 |
_UNICODE 定義 |
---|---|---|---|
_tcsdup |
_strdup |
_mbsdup |
_wcsdup |
因為 _strdup
呼叫 malloc
來配置複本 strSource
的儲存空間,所以最好一律呼叫 呼叫 _strdup
所傳回之指標上的常式來釋放此記憶體 free
。
如果 _DEBUG
已定義 和 _CRTDBG_MAP_ALLOC
, _strdup
而且 _wcsdup
會由 對 _strdup_dbg
和 _wcsdup_dbg
的呼叫取代,以允許偵錯記憶體配置。 如需詳細資訊,請參閱 _strdup_dbg
和 _wcsdup_dbg
。
需求
常式 | 必要的標頭 |
---|---|
_strdup |
<string.h> |
_wcsdup |
<string.h> 或 <wchar.h> |
_mbsdup |
<mbstring.h> |
如需相容性詳細資訊,請參閱相容性。
範例
// crt_strdup.c
#include <string.h>
#include <stdio.h>
int main( void )
{
char buffer[] = "This is the buffer text";
char *newstring;
printf( "Original: %s\n", buffer );
newstring = _strdup( buffer );
printf( "Copy: %s\n", newstring );
free( newstring );
}
Original: This is the buffer text
Copy: This is the buffer text
另請參閱
字串操作
memset
, wmemset
strcat
, wcscat
, _mbscat
strcmp
, wcscmp
, _mbscmp
strncat
, _strncat_l
, wcsncat
, _wcsncat_l
, _mbsncat
, _mbsncat_l
strncmp
, wcsncmp
, _mbsncmp
, _mbsncmp_l
strncpy
, _strncpy_l
, wcsncpy
, _wcsncpy_l
, _mbsncpy
, _mbsncpy_l
_strnicmp
, _wcsnicmp
, _mbsnicmp
, _strnicmp_l
, _wcsnicmp_l
, _mbsnicmp_l
strrchr
, wcsrchr
, _mbsrchr
, _mbsrchr_l
strspn
, wcsspn
, _mbsspn
, _mbsspn_l
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應