次の方法で共有


strncat、_strncat_l、wcsncat、wcsncat_l、_mbsncat、_mbsncat_l

文字列の文字を追加します。これらの関数のセキュリティを強化したバージョンについては、" "を参照 strncat_s、_strncat_s_l、wcsncat_s、_wcsncat_s_l、_mbsncat_s、_mbsncat_s_l をです。

重要 : 重要

_mbsncat と _mbsncat_l は、Windows のランタイムで実行するアプリケーションで使用することはできません。詳細については、でサポート /ZW CRT 関数" "を参照してください。

char *strncat(
   char *strDest,
   const char *strSource,
   size_t count 
);
wchar_t *wcsncat(
   wchar_t *strDest,
   const wchar_t *strSource,
   size_t count 
);
unsigned char *_mbsncat(
   unsigned char *strDest,
   const unsigned char *strSource,
   size_t count
);
unsigned char *_mbsncat_l(
   unsigned char *strDest,
   const unsigned char *strSource,
   size_t count,
   _locale_t locale
);
template <size_t size>
char *strncat(
   char (&strDest)[size],
   const char *strSource,
   size_t count 
); // C++ only
template <size_t size>
wchar_t *wcsncat(
   wchar_t (&strDest)[size],
   const wchar_t *strSource,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsncat(
   unsigned char (&strDest)[size],
   const unsigned char *strSource,
   size_t count
); // C++ only
template <size_t size>
unsigned char *_mbsncat_l(
   unsigned char (&strDest)[size],
   const unsigned char *strSource,
   size_t count,
   _locale_t locale
); // C++ only

パラメーター

  • strDest
    NULL で終わる追加先の文字列。

  • strSource
    NULL で終わる元の文字列。

  • count
    追加する文字数。

  • locale
    使用するロケール。

戻り値

コピー先文字列へのポインターを返します。エラーを示す戻り値は予約されていません。

解説

strncat 関数は strDestに、最大で、strSource の count の最初の文字を追加します。strSource の先頭の文字は、strDest の終端の null 文字を上書きします。count の文字が追加される前に null 文字が strSource に表示された場合は、strncat は null 文字まで strSourceからのすべての文字を追加します。count が strSourceの長さを超える場合、strSource の長さは countの代わりに使用されます。すべてのケースは null 文字が、結果の文字列終了します。重なり合う文字列間でコピーした場合の動作は未定義です。

セキュリティに関するメモセキュリティに関するメモ

strncat は strDestの十分な容量を確認していません; したがって、バッファー オーバーランの考えられる原因です。count を追加する文字数を制限することに注意してください; これは strDestのサイズ制限ではありません。次の例を参照してください。詳細については、「Avoiding Buffer Overruns」を参照してください。

wcsncat 関数と _mbsncat 関数は、strncat 関数のワイド文字バージョンとマルチバイト文字バージョンです。wcsncat 関数の文字列引数と戻り値はワイド文字列で、_mbsncat 関数の文字列引数と戻り値はマルチバイト文字列です。それ以外では、これらの関数の動作は同じです。

出力値は、ロケールの LC_CTYPE カテゴリの設定で決まります。詳細については、「setlocale」を参照してください。_l サフィックスが付いていないこの関数のバージョンでは、このロケールに依存する動作に現在のロケールを使用します。_l サフィックスが付いているバージョンは、渡されたロケール パラメーターを代わりに使用する点を除いて同じです。詳細については、「ロケール」を参照してください。

C++ では、これらの関数にテンプレート オーバーロードがあります。詳細については、「セキュリティ保護されたテンプレート オーバーロード」を参照してください。

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

TCHAR.H のルーチン

_UNICODE および _MBCS が未定義の場合

_MBCS が定義されている場合

_UNICODE が定義されている場合

_tcsncat

strncat

_mbsnbcat

wcsncat

_tcsncat_l

_strncat_l

_mbsnbcat_l

_wcsncat_l

[!メモ]

_strncat_l と _wcsncat_l にロケールの依存関係がなく、直接呼び出すためのものではありません。これらは _tcsncat_lによって内部使用して提供されます。

必要条件

ルーチン

必須ヘッダー

strncat

<string.h>

wcsncat

<string.h> または <wchar.h>

_mbsncat

<mbstring.h>

_mbsncat_l

<mbstring.h>

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

使用例

// crt_strncat.c
// Use strcat and strncat to append to a string.
#include <stdlib.h>

#define MAXSTRINGLEN 39

char string[MAXSTRINGLEN+1];
// or char *string = malloc(MAXSTRINGLEN+1);

void BadAppend( char suffix[], int n )
{
   strncat( string, suffix, n );
}

void GoodAppend( char suffix[], size_t n )
{
   strncat( string, suffix, __min( n, MAXSTRINGLEN-strlen(string)) );
}

int main( void )
{
   string[0] = '\0';
   printf( "string can hold up to %d characters\n", MAXSTRINGLEN );

   strcpy( string, "This is the initial string!" );
   // concatenate up to 20 characters...
   BadAppend( "Extra text to add to the string...", 20 );
   printf( "After BadAppend :  %s (%d chars)\n", string, strlen(string) );

   strcpy( string, "This is the initial string!" );
   // concatenate up to 20 characters...
   GoodAppend( "Extra text to add to the string...", 20 );
   printf( "After GoodAppend:  %s (%d chars)\n", string, strlen(string) );
}

出力

string can hold up to 39 characters
After BadAppend :  This is the initial string!Extra text to add to (47 chars)
After GoodAppend:  This is the initial string!Extra text t (39 chars)

BadAppend により、バッファー オーバーランが発生したことに注意してください。

同等の .NET Framework 関数

System::String::Concat

参照

関連項目

文字列操作 (CRT)

_mbsnbcat、_mbsnbcat_l

strcat、wcscat、_mbscat

strcmp、wcscmp、_mbscmp

strcpy、wcscpy、_mbscpy

strncmp、wcsncmp、_mbsncmp、_mbsncmp_l

strncpy、_strncpy_l、wcsncpy、_wcsncpy_l、_mbsncpy、_mbsncpy_l

_strnicmp、_wcsnicmp、_mbsnicmp、_strnicmp_l、_wcsnicmp_l、_mbsnicmp_l

strrchr、wcsrchr、_mbsrchr、_mbsrchr_l

_strset、_strset_l、_wcsset、_wcsset_l、_mbsset、_mbsset_l

strspn、wcsspn、_mbsspn、_mbsspn_l

ロケール

マルチバイト文字のシーケンスの解釈