_strdup、_wcsdup、_mbsdup

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

文字列を複製します。

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 関数の引数と戻り値はマルチバイト文字列です。それ以外では、これらの関数の動作は同じです。

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

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

_strdup 関数は malloc 関数を呼び出して strSource のコピー用に記憶領域を割り当てるので、_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>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

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