_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 的副本分配存储空间，然后将副本 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 );
}