_strdup, _wcsdup, _mbsdup

Duplikuje ciągi.

Ważne

_mbsdupnie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows. Aby uzyskać więcej informacji, zobacz Funkcje CRT nieobsługiwane w aplikacjach platforma uniwersalna systemu Windows.

Składnia

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

Parametry

strSource
Ciąg źródłowy zakończony wartością null.

Wartość zwracana

Każda z tych funkcji zwraca wskaźnik do lokalizacji przechowywania skopiowanego ciągu lub NULL jeśli nie można przydzielić magazynu.

Uwagi

Funkcja _strdup wywołuje malloc funkcję w celu przydzielenia miejsca do magazynowania kopii strSource , a następnie kopiuje strSource do przydzielonego miejsca.

_wcsdupi _mbsdup są wersjami znaków wielobajtowych i wielobajtowych ._strdup Argumenty i wartość zwracana _wcsdup wartości to ciągi wieloznakowe. Argumenty i wartość zwracana wartości to ciągi wielobajtowe _mbsdup znaków. Te trzy funkcje zachowują się identycznie inaczej.

Domyślnie stan globalny tej funkcji jest zakresem aplikacji. Aby zmienić to zachowanie, zobacz Stan globalny w CRT.

Mapowania procedur tekstu ogólnego

TCHAR.H Rutynowych	_UNICODE i _MBCS niezdefiniowane	_MBCS Zdefiniowane	_UNICODE Zdefiniowane
_tcsdup	_strdup	_mbsdup	_wcsdup

Ponieważ _strdup wywołania malloc przydzielenia miejsca do magazynowania kopii strSourceelementu , dobrym rozwiązaniem jest zawsze zwolnienie tej pamięci przez wywołanie free procedury w wskaźniku zwróconym przez wywołanie metody _strdup.

Jeśli _DEBUG i _CRTDBG_MAP_ALLOC są zdefiniowane, _strdup i _wcsdup są zastępowane przez wywołania do _strdup_dbg i _wcsdup_dbg, aby umożliwić debugowanie alokacji pamięci. Aby uzyskać więcej informacji, zobacz _strdup_dbg, _wcsdup_dbg.

Wymagania

Procedura	Wymagany nagłówek
_strdup	<string.h>
_wcsdup	<string.h> lub <wchar.h>
_mbsdup	<mbstring.h>

Aby uzyskać więcej informacji o zgodności, zobacz Zgodność.

Przykład

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

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

Zobacz też

Manipulowanie ciągami
memset, wmemset
strcat, wcscat, _mbscat
strcmp, wcscmp, _mbscmp
strncat, _strncat_l, wcsncat, _wcsncat_l, _mbsncat, _mbsncat_l
strncmp, wcsncmp, _mbsncmp, _mbsncmp_l
strncpy, _strncpy_l, wcsncpy, _wcsncpy_l, _mbsncpy, _mbsncpy_l
_strnicmp, _wcsnicmp, _mbsnicmp, _strnicmp_l, _wcsnicmp_l, _mbsnicmp_l
strrchr, wcsrchr, _mbsrchr, _mbsrchr_l
strspn, wcsspn, _mbsspn, _mbsspn_l