_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