close
名前空間
変種

    strcat, strcat_s

    提供: cppreference.com
    < c | string | byte
     
    C
     
    文字列ライブラリ
     
    ヌル終端バイト文字列
     
    <tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>
    ヘッダ <string.h> で定義
    (1)
    char *strcat( char *dest, const char *src );
    		 (C99未満)
    char *strcat( char *restrict dest, const char *restrict src );
    		 (C99以上)
    errno_t strcat_s(char *restrict dest, rsize_t destsz, const char *restrict src);
    		 (2) (C11以上)
    1) src の指すヌル終端バイト文字列のコピーを dest の指すヌル終端バイト文字列の末尾に追加します。 文字 src[0] が dest の末尾のヌル終端を置き換えます。 結果のバイト文字列はヌル終端されます。
    コピー先の配列が src と dest と終端のヌル文字を合わせた内容に対して十分大きくない場合、動作は未定義です。 文字列がオーバーラップする場合、動作は未定義です。 dest または src がヌル終端バイト文字列を指すポインタでない場合、動作は未定義です。
    2) (1) と同じですが、コピー先配列の残り (最後に書き込まれた文字から destsz まで) を未規定の値で上書きするかもしれず、以下のエラーが実行時に検出され、現在設定されている制約ハンドラ関数を呼びます。
    • src または dest がヌルポインタ。
    • destsz がゼロまたは RSIZE_MAX より大きい。
    • dest の先頭 destsz バイトにヌル終端が存在しない。
    • 切り捨てが発生する (dest の末尾の利用可能な空間が src のすべての文字およびヌル終端を収められない)。
    • コピー元とコピー先の文字列間でオーバーラップが発生する。
    dest の指す文字配列のサイズ < strlen(dest)+strlen(src)+1 <= destsz の場合、動作は未定義です。 別の言い方をすると、誤った destsz の値は切迫したバッファオーバーフローを露呈しません。
    すべての境界チェック付き関数と同様に、 strcat_s は __STDC_LIB_EXT1__ が処理系によって定義されていて、 <string.h> をインクルードする前にユーザが __STDC_WANT_LIB_EXT1__ を整数定数 1 に定義した場合にのみ、利用可能であることが保証されます。

    引数

    dest - 追加先のヌル終端バイト文字列を指すポインタ
    src - コピー元のヌル終端バイト文字列を指すポインタ
    destsz - 書き込む最大文字数、一般的にはコピー先バッファのサイズ

    戻り値

    1) dest のコピーを返します。
    2) 成功した場合はゼロを返します。 エラーが発生した場合は非ゼロを返します。 また、エラー場合は dest[0] にゼロを書き込みます (dest がヌルポインタでなく、 destsz がゼロでなく RSIZE_MAX より大きくなければ)。

    ノート

    strcat_s は効率向上のためにコピー先配列の書き込まれた最後の文字から destsz までを上書きすることが許されています。 複数バイトのブロックをコピーしてからヌルのバイトをチェックするかもしれません。

    関数 strcat_s は BSD の関数 strlcat と似ていますが、以下の点が異なります。

    • strlcat はコピー先に収まるようにコピー元文字列を切り捨てます。
    • strlcat は strcat_s が行うすべての実行時チェックを行いません。
    • strlcat は失敗時にコピー先にヌル文字列を設定したりハンドラを呼ぶことで失敗を明らかにしません。

    strcat_s は潜在的なセキュリティリスクのために切り捨てを禁止していますが、代わりに境界チェック付きの strncat を使用して文字列を切り捨てることができます。

    例

    Run this code
    #define __STDC_WANT_LIB_EXT1__ 1
#include <string.h> 
#include <stdio.h>
#include <stdlib.h>

int main(void) 
{
    char str[50] = "Hello ";
    char str2[50] = "World!";
    strcat(str, str2);
    strcat(str, " ...");
    strcat(str, " Goodbye World!");
    puts(str);

#ifdef __STDC_LIB_EXT1__
    set_constraint_handler_s(ignore_handler_s);
    int r = strcat_s(str, sizeof str, " ... ");
    printf("str = \"%s\", r = %d\n", str, r);
    r = strcat_s(str, sizeof str, " and this is too much");
    printf("str = \"%s\", r = %d\n", str, r);
#endif
}

    出力例: 

    Hello World! ... Goodbye World!
str = "Hello World! ... Goodbye World! ... ", r = 0
str = "", r = 22

    参考文献

    • C11 standard (ISO/IEC 9899:2011):
    • 7.24.3.1 The strcat function (p: 364)
    • K.3.7.2.1 The strcat_s function (p: 617-618)
    • C99 standard (ISO/IEC 9899:1999):
    • 7.21.3.1 The strcat function (p: 327)
    • C89/C90 standard (ISO/IEC 9899:1990):
    • 4.11.3.1 The strcat function

    関連項目

    (C11)
    		 2つの文字列の文字を一定量連結します
    (関数) [edit]
    (C11)
    		 文字列を別の文字列へコピーします
    (関数) [edit]
    strcat の C++リファレンス