_mbsnbcat, _mbsnbcat_l

Artigo
08/25/2010

Acrescentar, no máximo, a primeira n bytes de uma seqüência de caractere de multibyte para outro. Versões mais seguras dessas funções estão disponível; consulte _mbsnbcat_s, _mbsnbcat_s_l.

unsigned char *_mbsnbcat(
   unsigned char *dest,
   const unsigned char *src,
   size_t count 
);
unsigned char *_mbsnbcat_l(
   unsigned char *dest,
   const unsigned char *src,
   size_t count,
   _locale_t locale
);
template <size_t size>
unsigned char *_mbsnbcat(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count 
); // C++ only
template <size_t size>
unsigned char *_mbsnbcat_l(
   unsigned char (&dest)[size],
   const unsigned char *src,
   size_t count,
   _locale_t locale
); // C++ only

Parâmetros

dest
Seqüência de caracteres terminada com caractere nulo destino caracteres multibyte.
src
Seqüência de caracteres terminada com caractere nulo de fonte de caracteres multibyte.
count
Número de bytes de src Para acrescentar a dest.
locale
Localidade usar.

Valor de retorno

_mbsnbcat Retorna um ponteiro para a seqüência de caracteres de destino. Nenhum valor retornado é reservado para indicar um erro.

Comentários

The _mbsnbcat função anexa, no máximo, o primeiro count bytes de src para dest. Se o byte imediatamente antes do caractere nulo em dest é um byte inicial, o byte inicial de src substitui esse byte inicial. Caso contrário, o byte inicial de src substitui o caractere nulo de terminação de dest. Se aparecer um byte nulo em src antes de count bytes são acrescentados, _mbsnbcat acrescenta todos os bytes de src, até o caractere nulo. If count é maior do que o comprimento de src, o tamanho de src usado no lugar de count. A seqüência de caracteres resultante é finalizada com um caractere nulo.Se copiar ocorre entre cadeias de caracteres que se sobrepõem, o comportamento é indefinido.

O valor de saída é afetado pela configuração do LC_CTYPE categoria de configuração da localidade; consulte setlocale para obter mais informações.The _mbsnbcat versão da função usa a localidade corrente para esse comportamento dependente de localidade; o _mbsnbcat_l versão é idêntica, exceto pelo fato de que usarem o parâmetro de localidade passado em vez disso. For more information, see Localidade.

Observação de segurança Use uma seqüência de caracteres terminada com caractere nulo.A seqüência de caracteres terminada com caractere nulo não deve exceder o dimensionar do buffer de destino.Para obter mais informações, consulte Evitar saturações de buffer.

If dest ou src é NULL, a função gerará um erro de parâmetro inválido, conforme descrito em Validação de parâmetro. Se o erro é manipulado, a função retornará EINVAL e conjuntos errno para EINVAL.

No C++, essas funções têm sobrecargas de modelo que invocam as suas similares do mais recentes, seguras dessas funções.For more information, see Proteger overloads de modelo.

Mapeamentos de rotina de texto genérica