strdupのヘルプ・マニュアル
日本語 英語
strdup --help
man strdup
STRDUP(3) Linux Programmer’s Manual STRDUP(3)
名前
strdup, strndup, strdupa, strndupa - 文字列を複製する
書式
#include
char *strdup(const char *s);
char *strndup(const char *s, size_t n);
char *strdupa(const char *s);
char *strndupa(const char *s, size_t n);
glibc 向けの機能検査マクロの要件 (feature_test_macros(7) 参照):
strdup(): _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500
strndup(), strdupa(), strndupa(): _GNU_SOURCE
説明
strdup() 関数は、文字列 sの複製である新しい文字列へのポインタを返す。新
しい文字列のためのメモリは malloc(3) で得ている。そして、 free(3) で 解
放することができる。
strndup() 関数は同様であるが、最大で n 文字だけを複製する。 s が n より
も長い場合、n 文字だけが複製され、終端の NULL バイト ('\0')) が追加され
る。
strdupa() と strndupa() 関数は同様であるが、バッファを割り当てるのに
alloca(3) を用いる。これらの関数は GNU GCC を用いた場合にのみ有効 で 、
alloca(3) で記述されているのと同様の制限を受ける。
返り値
strdup() 関数は複製された文字列へのポインタ、または十分なメモリが確保で
きなかった場合にはNULLを返す。
エラー
ENOMEM 複製された文字列を割り当てる十分なメモリが確保できなかった。
準拠
strdup() は SVr4, 4.3BSD, POSIX.1-2001 準 拠 で あ る 。 strndup(),
strdupa(), strndupa() は GNU 拡張である。
関連項目
alloca(3), calloc(3), free(3), malloc(3), realloc(3), wcsdup(3)
GNU 2007-07-26 STRDUP(3)
STRDUP(3) Linux Programmer’s Manual STRDUP(3)
NAME
strdup, strndup, strdupa, strndupa - duplicate a string
SYNOPSIS
#include
char *strdup(const char *s);
char *strndup(const char *s, size_t n);
char *strdupa(const char *s);
char *strndupa(const char *s, size_t n);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
strdup(): _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500
strndup(), strdupa(), strndupa(): _GNU_SOURCE
DESCRIPTION
The strdup() function returns a pointer to a new string which is a
duplicate of the string s. Memory for the new string is obtained with
malloc(3), and can be freed with free(3).
The strndup() function is similar, but only copies at most n charac-
ters. If s is longer than n, only n characters are copied, and a ter-
minating null byte ('\0') is added.
strdupa() and strndupa() are similar, but use alloca(3) to allocate the
buffer. They are only available when using the GNU GCC suite, and suf-
fer from the same limitations described in alloca(3).
RETURN VALUE
The strdup() function returns a pointer to the duplicated string, or
NULL if insufficient memory was available.
ERRORS
ENOMEM Insufficient memory available to allocate duplicate string.
CONFORMING TO
strdup() conforms to SVr4, 4.3BSD, POSIX.1-2001. strndup(), strdupa(),
and strndupa() are GNU extensions.
SEE ALSO
alloca(3), calloc(3), free(3), malloc(3), realloc(3), wcsdup(3)
COLOPHON
This page is part of release 3.22 of the Linux man-pages project. A
description of the project, and information about reporting bugs, can
be found at http://www.kernel.org/doc/man-pages/.
GNU 2007-07-26 STRDUP(3)