_strdup、 _wcsdup、 _mbsdup

文字列を複製します。

重要

_mbsdup は、Windows ランタイムで実行するアプリケーションでは使用できません。 詳細については、「ユニバーサル Windows プラットフォーム アプリでサポートされていない CRT 関数」を参照してください。

構文

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

パラメーター

strSource
NULL で終わる元の文字列。

戻り値

これらの各関数は、コピーされた文字列の格納場所へのポインターを返すか、ストレージを割り当てることができない場合は NULL します。

解説

_strdup関数はmallocを呼び出して、strSourceのコピー用の記憶域スペースを割り当て、割り当てられた領域にstrSourceをコピーします。

_wcsdup 関数と _mbsdup 関数は、_strdup 関数のワイド文字バージョンとマルチバイト文字バージョンです。 _wcsdupの引数と戻り値はワイド文字列です。 _mbsdupの引数と戻り値はマルチバイト文字列です。 それ以外では、これらの関数の動作は同じです。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

TCHAR.H ルーチン	_UNICODE と _MBCS が定義されていない	_MBCS が定義されている	_UNICODE が定義されている
_tcsdup	_strdup	_mbsdup	_wcsdup

_strdup呼び出しmallocstrSourceのコピー用に記憶域領域を割り当てることが適切であるため、常に、_strdupの呼び出しによって返されるポインターでfree ルーチンを呼び出して、このメモリを解放することをお勧めします。

_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>

互換性の詳細については、「 Compatibility」を参照してください。

例

// 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

関連項目

文字列操作
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