strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

Artigo
03/12/2013

Acrescentar caracteres de uma cadeia de caracteres.Versões mais seguros dessas funções estão disponíveis, consulte strncat_s, _strncat_s_l, wcsncat_s, _wcsncat_s_l, _mbsncat_s, _mbsncat_s_l .

Importante
_mbsncat e _mbsncat_l não podem ser usados em aplicativos executados em Tempo de Execução do Windows.Para obter mais informações, consulte Funções de CRT não suportadas com /ZW.

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

Parâmetros

strDest
Cadeia de caracteres NULL- finalizada de destino.
strSource
Cadeia de caracteres NULL- finalizada de origem.
count
Número de caracteres para acrescentar.
locale
A localidade usar.

Valor de retorno

Retorna um ponteiro para a cadeia de caracteres de destino.Nenhum valor de retorno é reservado para indicar um erro.

Comentários

A função de strncat acrescenta, no máximo, os primeiros caracteres de count de strSource a strDest.O caractere inicial de strSource substitui o caractere nulo de terminação de strDest.Se um caractere nulo aparece em strSource antes que os caracteres de count são acrescentados, strncat acrescenta todos os caracteres de strSource, até o caractere nulo.Se count é maior do que o comprimento de strSource, o comprimento de strSource é usado no lugar de count.Todos os casos, a cadeia de caracteres resultante terminam com um caractere nulo.Se copiar ocorre entre as cadeias de caracteres que sobrepostos, o comportamento é indefinido.

Observação de segurança
strncat não verifica se há espaço suficiente em strDest; como consequência é uma causa potencial de estouros de buffer.Tenha em mente que count limitar o número de caracteres; acrescentados não é um limite no tamanho de strDest.Consulte o exemplo abaixo.Para obter mais informações, consulte Evitando estouros de buffer.

wcsncat e _mbsncat são versões de largo- caractere e o caractere multibyte- de strncat.Argumentos de cadeia de caracteres e o valor de retorno de wcsncat são cadeias de caracteres de largo- caractere; essas de _mbsncat são cadeias de caracteres de multibyte- caractere.Essas três funções se comportam de forma idêntica.

O valor de saída é afetado pela configuração da categoria de LC_CTYPE de localidade; consulte setlocale para mais informações.As versões dessas funções sem o sufixo de _l usam a localidade atual para este comportamento de são dependentes; as versões com o sufixo de _l são idênticas exceto que usam o parâmetro de localidade passado em vez disso.Para obter mais informações, consulte Localidade.

Em C++, essas funções tem sobrecargas de modelo.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos da rotina de Genérico- texto

Rotina de TCHAR.H	_UNICODE & _MBCS não definidos	_MBCS definido	_UNICODE definido
_tcsncat	strncat	_mbsnbcat	wcsncat
_tcsncat_l	_strncat_l	_mbsnbcat_l	_wcsncat_l

Observação
_strncat_l e _wcsncat_l não dependerem de localidade e não são destinados ser chamados diretamente.São fornecidos para uso interno por _tcsncat_l.

Requisitos

Rotina	Cabeçalho necessário
strncat	<string.h>
wcsncat	<string.h> ou <wchar.h>
_mbsncat	<mbstring.h>
_mbsncat_l	<mbstring.h>

Para informações extras de compatibilidade Compatibilidade na introdução, consulte.

Exemplo

// 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) );
}

Saída

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)

Observe que BadAppend causou um estouro de buffer.