_strdup，_wcsdup _mbsdup

發行項
03/26/2013

重複字串。

重要

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

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

參數

strSource
innull 結尾的來源字串。

傳回值

如果儲存體無法配置，這些函式都會傳回指標複製資料或 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 );
}