2 out of 2 rated this helpful - Rate this topic

_strdup_dbg, _wcsdup_dbg

Visual Studio 2005

Versions of _strdup and _wcsdup that use the debug version of malloc.


char *_strdup_dbg(
   const char *strSource,
   int blockType,
   const char *filename,
   int linenumber 
);
wchar_t *_wcsdup_dbg(
   const wchar_t *strSource,
   int blockType,
   const char *filename,
   int linenumber 
);

Parameters

strSource: Null-terminated source string.

blockType: Requested type of memory block: _CLIENT_BLOCK or _NORMAL_BLOCK.

filename: Pointer to name of source file that requested allocation operation or NULL.

linenumber: Line number in source file where allocation operation was requested or NULL.

Return Value

Each of these functions returns a pointer to the storage location for the copied string or NULL if storage cannot be allocated.

Remarks

The _strdup_dbg and _wcsdup_dbg functions are identical to _strdup and _wcsdup except that, when _DEBUG is defined, these functions use the debug version of malloc, _malloc_dbg, to allocate memory for the duplicated string. For information on the debugging features of _malloc_dbg, see _malloc_dbg.

You do not need to call these functions explicitly in most cases. Instead, you can define the flag _CRTDBG_MAP_ALLOC. When _CRTDBG_MAP_ALLOC is defined, calls to _strdup and _wcsdup are remapped to _strdup_dbg and _wcsdup_dbg, respectively, with the blockType set to _NORMAL_BLOCK. Thus, you do not need to call these functions explicitly unless you want to mark the heap blocks as _CLIENT_BLOCK. For more information on block types, see Types of Blocks on the Debug Heap.

Generic-Text Routine Mappings

TCHAR.H routine	_UNICODE & _MBCS not defined	_MBCS defined	_UNICODE defined
_tcsdup_dbg	_strdup_dbg	_mbsdup	_wcsdup_dbg

Requirements

Routine	Required header	Compatibility
_strdup_dbg, _wcsdup_dbg	<crtdbg.h>	Windows 95, Windows 98, Windows 98 Second Edition, Windows Millennium Edition, Windows NT 4.0, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003

For additional compatibility information, see Compatibility in the Introduction.

Libraries

All debug versions of the C run-time libraries.

.NET Framework Equivalent

System::String::Clone

Reference

String Manipulation (CRT)
_strdup, _wcsdup, _mbsdup

Concepts

Debug Versions of Heap Allocation Functions

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD