_mbsnbcat, _mbsnbcat_l

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.

Observação importanteImportante

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

Rotina de Tchar.h

_UNICODE e não definidos _MBCS

_MBCS definido

_UNICODE definido

_tcsncat

strncat

_mbsnbcat

wcsncat

_tcsncat_l

_strncat_l

_mbsnbcat_l

_wcsncat_l

Requisitos

Rotina

Cabeçalho necessário

_mbsnbcat

<mbstring.h>

_mbsnbcat_l

<mbstring.h>

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

Equivalência do .NET Framework

Não aplicável. Para chamar a função padrão de C, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.

Consulte também

Referência

Manipulação de cadeia de caracteres (CRT)

_mbsnbcmp, _mbsnbcmp_l

_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l

_mbsnbcpy, _mbsnbcpy_l

_mbsnbicmp, _mbsnbicmp_l

_mbsnbset, _mbsnbset_l

strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l

_mbsnbcat_s, _mbsnbcat_s_l