strdup

 

C

コンパイラサポート

言語

ヘッダー

型サポート

プログラムユーティリティ

可変長引数関数のサポート

エラーハンドリング

動的メモリ管理

文字列ライブラリ

アルゴリズム

数値

日付と時刻のユーティリティ

入出力サポート

ローカライゼーションサポート

並行処理サポート (C11)

技術仕様

シンボルインデックス

 

技術仕様

組込みプロセッサ向けの拡張

動的メモリ拡張

浮動小数点拡張 パート1: 2進浮動小数点

浮動小数点拡張 パート4: 補足関数

 

動的メモリ拡張

fmemopen

open_memstreamopen_wmemstream

asprintfaswprintfvasprintfvaswprintf

getlinegetwlinegetdelimgetwdelim

strdup

strndup

 

ヘッダー <string.h> で定義
char * strdup( const char *str1 );		(動的メモリーTR)

str1 が指す文字列のコピーである、ヌル終端されたバイト文字列へのポインタを返します。返されたポインタは、メモリリークを避けるために free に渡す必要があります。

エラーが発生した場合、ヌルポインタが返され、errno が設定されることがあります。

Dynamic Memory TR のすべての関数と同様に、strdup が利用可能であることは、実装によって __STDC_ALLOC_LIB__ が定義され、ユーザーが __STDC_WANT_LIB_EXT2__ を整数定数 1 として定義し、string.h をインクルードする前に、保証されます。

Parameters

str1

-

複製するヌル終端バイト文字列へのポインタ

Return value

新しく割り当てられた文字列へのポインタ、またはエラーが発生した場合はヌルポインタ。

Notes

この関数は POSIX strdup と同一です。

Example

このコードを実行

#ifdef __STDC_ALLOC_LIB__
#define __STDC_WANT_LIB_EXT2__ 1
#else
#define _POSIX_C_SOURCE 200809L
#endif
 
#include <string.h>
#include <assert.h>
#include <stdlib.h>
 
int main(void)
{
    const char *s1 = "String";
    char *s2 = strdup(s1);
    assert(strcmp(s1, s2) == 0);
    free(s2);
}

See also

strndup (動的メモリーTR)	指定されたサイズまでの文字列のコピーを確保する (関数)
strcpystrcpy_s (C11)	ある文字列を別の文字列にコピーする (関数)
malloc	メモリを割り当てる (関数)