_mbsnbcat, _mbsnbcat_l

Artigo
06/09/2015

Acrescenta, no máximo, os primeiros bytes de n de uma cadeia de caracteres multibyte para outra. Versões mais seguras dessas funções estão disponíveis; consulte _mbsnbcat_s, _mbsnbcat_s_l.

Importante

Esta API não pode ser usada em aplicativos que executam no Tempo de Execução do Windows.Para obter mais informações, consulte Funções CRT sem suporte pelo /ZW.

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
Cadeia de caracteres de destino com caractere multibyte terminado com Null.
src
Cadeia de caracteres de origem com caractere multibyte terminado com Null.
count
Número de bytes de src a serem acrescentados a dest.
locale
Localidade a ser usada.

Valor de retorno

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

Comentários

A função _mbsnbcat acrescenta, no máximo, os primeiros count bytes de src a dest. Se o byte que precede o caractere nulo em dest é um byte inicial, o byte inicial de src substitui esse byte inicial. Caso contrário, o byte inicial de src substituirá o caractere nulo de terminação de dest. Se um byte nulo aparecer em src antes que os bytes de count sejam acrescentados, o _mbsnbcat acrescenta todos os bytes de src, até o caractere nulo. Se count for maior que o tamanho de src, o tamanho de src será usado no lugar de count. A cadeia de caracteres resultante é finalizada com um caractere nulo. Se a cópia for feita entre cadeias de caracteres que se sobrepõem, o comportamento será indefinido.

O valor de saída é afetado pela configuração da categoria LC_CTYPE de localidade. Para obter mais informações, consulte setlocale. A versão _mbsnbcat da função usa o local atual para esse comportamento dependente de local; a versão _mbsnbcat_l é idêntica, exceto pelo fato de que ela usa o parâmetro de local transmitido. Para obter mais informações, consulte Localidade.

Observação de segurança Use uma cadeia de caracteres terminada em nulo. A cadeia de caracteres terminadas em nulo não devem exceder o tamanho do buffer de destino. Para obter mais informações, consulte Evitando saturações de buffer.

Se dest ou src for NULL, a função gerará um erro de parâmetro inválido, conforme descrito em Validação do parâmetro. Se o erro for tratado, a função retornará EINVAL e definirá errno como EINVAL.

No C++, essas funções têm as sobrecargas de modelo que invocam as correspondentes seguras mais recentes dessas funções. Para obter mais informações, consulte Sobrecargas de modelo seguras.

Mapeamentos da rotina de texto genérico