_strdup、_wcsdup、_mbsdup

重複する文字列。

重要
_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 の格納場所にストレージの割り当てができない場合、ポインターを返します。

解説

strSource のコピーのストレージ領域を割り当てる _strdup の関数呼び出し malloc は、割り当てられた領域に、strSource をコピーします。

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

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

TCHAR.H のルーチン	_UNICODE および _MBCS が未定義の場合	_MBCS が定義されている場合	_UNICODE が定義されている場合
_tcsdup	_strdup	_mbsdup	_wcsdup

strSourceのコピーのストレージ領域を割り当てるに _strdup が malloc を呼び出すので、_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 );
}

同等の .NET Framework 関数

System::String::Clone

参照

関連項目

文字列操作 (CRT)

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