_mbsnbcat, _mbsnbcat_l

Artigo
02/25/2013

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

Importante
Este API não pode ser usado 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.

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 NULL- finalizada de destino de multibyte- caractere.
src
Cadeia de caracteres NULL- finalizada fonte de multibyte- caractere.
count
Número de bytes de src para anexar a dest.
locale
A localidade usar.

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 de _mbsnbcat acrescenta, no máximo, os primeiros bytes de count de src a 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 um byte nulo aparece em src antes que os bytes de count são acrescentados, o _mbsnbcat acrescenta todos os bytes de src, até o caractere nulo.Se count é maior do que o comprimento de src, o comprimento de src é usado no lugar de count.A cadeia de caracteres resultante é finalizada com um caractere nulo.Se copiar ocorre entre as cadeias de caracteres que sobrepostos, o comportamento é indefinido.

O valor de saída é afetado pela configuração da categoria de LC_CTYPE de localidade; consulte setlocale para mais informações.A versão de _mbsnbcat da função usa a localidade atual para este comportamento de são dependentes; a versão de _mbsnbcat_l é idêntica exceto que usam o parâmetro de localidade passado em vez disso.Para obter mais informações, consulte Localidade.

Uso deSecurity Note uma cadeia de caracteres NULL- finalizada.A cadeia de caracteres NULL- finalizada não pode exceder o tamanho do buffer de destino.Para obter mais informações, consulte Evitando estouros de buffer.

Se dest ou src são NULL, a função irá gerar um erro válido de parâmetros, conforme descrito em Validação de parâmetro.Se o erro é tratado, a função retorna EINVAL e defina errno a EINVAL.

Em C++, essas funções têm as sobrecargas de modelo que chamam as novas contrapartes mais seguros, essas funções.Para obter mais informações, consulte Proteger Overloads de modelo.

Mapeamentos da rotina de Genérico- texto