_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