Contents Index Topic Contents
	Previous Topic: StrCSpnI Next Topic: StrFormatByteSize

StrDup

LPTSTR StrDup( 
    LPCTSTR lpsz 
    );

Duplicates a string.

• Returns the address of the string that was copied, or NULL if the string cannot be copied.

lpsz

Address of a constant null-terminated character string.

StrDup will allocate storage the size of the original string. If storage allocation is successful, the original string is copied to the duplicate string.

Example:

#include <windows.h>
#include <string.h>
#include <stdio.h>

void 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 );
}

   OUTPUT:
   - - - - - - 
   Original: This is the buffer text
   Copy:     This is the buffer text

Note This function uses LocalAlloc to allocate storage space for the copy of the string. The calling application must free this memory by calling the LocalFree function on the pointer returned by the call to StrDup.

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.