_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.
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
Rotina de Tchar.h |
_UNICODE e não definidos _MBCS |
_MBCS definido |
_UNICODE definido |
---|---|---|---|
_tcsncat |
_mbsnbcat |
||
_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)
_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l
strncat, _strncat_l, wcsncat, wcsncat_l, _mbsncat _mbsncat_l