_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_lwcsncat、_wcsncat_l、、_mbsncat、_mbsncat_l
strncmp、 、 wcsncmp、 _mbsncmp_mbsncmp_l
strncpy、、_strncpy_lwcsncpy、_wcsncpy_l、、_mbsncpy、_mbsncpy_l
_strnicmp、、_wcsnicmp_mbsnicmp、_strnicmp_l、、_wcsnicmp_l、_mbsnicmp_l
strrchr、 、 wcsrchr、 _mbsrchr_mbsrchr_l
strspn、 、 wcsspn、 _mbsspn_mbsspn_l