strcatのヘルプ・マニュアル
日本語 英語
strcat --help
man strcat
STRCAT(3) Linux Programmer’s Manual STRCAT(3)
名前
strcat, strncat - 二つの文字列を連結する
書式
#include
char *strcat(char *dest, const char *src);
char *strncat(char *dest, const char *src, size_t n);
説明
strcat() 関 数 は、dest 文字列の後に src 文字列を付け加える。その際に
、dest の最後にあるヌルバイト ('\0') は上書きされ、新たに生成された文字
列の末尾に終端のヌルバイトが付与される。二つの文字列 src と dest は重な
ってはならない。また、文字列 dest は、連結後の結果を格納するのに十分 な
大きさでなければならない。
strncat() も同様だが、以下の点が異なる。
* src のうち最大 n 文字が使用される。
* src が n 文字以上の場合、 src はヌル終端されている必要はない。
strcat() と同じく、dest に格納される結果の文字列は常にヌル終端される。
src が n 文字以上の場合、 strncat() は dest に n+1 文字を書き込む (src
からの n 文字と終端のヌルバイトである)。したがって、dest の大きさは最低
でも strlen(dest)+n+1 でなければならない。
strncat() の簡単な実装は以下のような感じであろう:
char*
strncat(char *dest, const char *src, size_t n)
{
size_t dest_len = strlen(dest);
size_t i;
for (i = 0 ; i < n && src[i] != '\0' ; i++)
dest[dest_len + i] = src[i];
dest[dest_len + i] = '\0';
return dest;
}
返り値
strcat() 関数と strncat() 関数は、結果としてできる文字列 dest へのポイ
ンタを返す。
準拠
SVr4, 4.3BSD, C89, C99.
関連項目
bcopy(3), memccpy(3), memcpy(3), strcpy(3), strncpy(3), wcscat(3),
wcsncat(3)
GNU 2008-06-13 STRCAT(3)
STRCAT(3) Linux Programmer’s Manual STRCAT(3)
NAME
strcat, strncat - concatenate two strings
SYNOPSIS
#include
char *strcat(char *dest, const char *src);
char *strncat(char *dest, const char *src, size_t n);
DESCRIPTION
The strcat() function appends the src string to the dest string, over-
writing the null byte ('\0') at the end of dest, and then adds a termi-
nating null byte. The strings may not overlap, and the dest string
must have enough space for the result.
The strncat() function is similar, except that
* it will use at most n characters from src; and
* src does not need to be null terminated if it contains n or more
characters.
As with strcat(), the resulting string in dest is always null termi-
nated.
If src contains n or more characters, strncat() writes n+1 characters
to dest (n from src plus the terminating null byte). Therefore, the
size of dest must be at least strlen(dest)+n+1.
A simple implementation of strncat() might be:
char*
strncat(char *dest, const char *src, size_t n)
{
size_t dest_len = strlen(dest);
size_t i;
for (i = 0 ; i < n && src[i] != '\0' ; i++)
dest[dest_len + i] = src[i];
dest[dest_len + i] = '\0';
return dest;
}
RETURN VALUE
The strcat() and strncat() functions return a pointer to the resulting
string dest.
CONFORMING TO
SVr4, 4.3BSD, C89, C99.
SEE ALSO
bcopy(3), memccpy(3), memcpy(3), strcpy(3), strncpy(3), wcscat(3),
wcsncat(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 2008-06-13 STRCAT(3)