_strdup、_wcsdup、_mbsdup

發行項
06/09/2015

重複字串。

重要

_mbsdup 無法用於在 Windows 執行階段中執行的應用程式。如需詳細資訊，請參閱 /ZW 不支援 CRT 函式。

char *_strdup(
   const char *strSource 
);
wchar_t *_wcsdup(
   const wchar_t *strSource 
);
unsigned char *_mbsdup(
   const unsigned char *strSource 
);

參數

strSource
以 Null 結束的來源字串。

傳回值

如果儲存體無法配置，這些函式都會傳回指標複製資料或 NULL 的儲存位置。

備註

_strdup 函式會呼叫來配置 strSource 複本的儲存空間的 malloc 然後複製 strSource 對這個配置的空間。

_wcsdup 和 _mbsdup 是 _strdup 的寬字元和多位元組字元版本。 _wcsdup 的引數和傳回值是寬字元字串，而 _mbsdup 的引數和傳回值則是多位元組字元字串。這三個函式其餘部分的運作相同。

一般文字常式對應

TCHAR.H 常式	_UNICODE & _MBCS 未定義	_MBCS 已定義	_UNICODE 已定義
_tcsdup	_strdup	_mbsdup	_wcsdup

因為 _strdup 會呼叫 malloc 來配置 strSource複本的儲存空間，是很好的作法可以呼叫在呼叫 _strdup時傳回的指標的可用常式永遠釋放此記憶體。

如果 _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 );
}