_mbsnbcat_s, _mbsnbcat_s_l

Artigo
02/25/2013

Acrescenta a uma cadeia de caracteres de multibyte, no máximo, os primeiros bytes de n de outra cadeia de caracteres de multibyte- caractere.Essas são as versões de _mbsnbcat, _mbsnbcat_l que têm aprimoramentos de segurança, como descrito em Recursos de segurança no CRT.

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.

errno_t _mbsnbcat_s( unsigned char *dest, size_t sizeInBytes, const unsigned char *src, size_t count ); errno_t _mbsnbcat_s_l( unsigned char *dest, size_t sizeInBytes, const unsigned char *src, size_t count, _locale_t locale ); template <size_t size> errno_t _mbsnbcat_s( unsigned char (&dest)[size], const unsigned char *src, size_t count ); // C++ only template <size_t size> errno_t _mbsnbcat_s_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.
sizeInBytes
Tamanho do buffer dest em bytes.
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

Zero se com êxito; caso contrário, um código de erro.

Condições de erro

Dest	sizeInBytes	src	Valor de Retorno
NULL	alguns	alguns	EINVAL
Alguns	<= 0	alguns	EINVAL
Alguns	alguns	NULL	EINVAL

Se qualquer uma das condições de erro ocorre, a função gera um erro de parâmetro inválido, como descrito em Validação de parâmetro.Se o erro é tratado, a função retorna EINVAL e defina errno a EINVAL.

Comentários

A função de _mbsnbcat_s acrescenta a dest, no máximo, os primeiros bytes de count de src.Se o byte que precede imediatamente o caractere nulo em dest é um byte inicial, é substituído pelo byte inicial de src.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, _mbsnbcat_s 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 por 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, wsetlocale para mais informações.As versões dessas funções são idênticas, exceto as que não têm o uso do sufixo de _l a localidade atual e as seguintes que têm o sufixo de _l usar o parâmetro de localidade que é passado.Para obter mais informações, consulte Localidade.

Em C++, o uso dessas funções é simplificado por sobrecargas de modelo; as sobrecargas podem interpretar o tamanho do buffer automaticamente e assim eliminar a necessidade de especificar um argumento de tamanho, e podem automaticamente usar seu mais recentes mais seguros, funções para substituir mais antigos, funções de menos segura.Para obter mais informações, consulte Proteger Overloads de modelo.

As versões de depuração dessas funções preenchem primeiro o buffer com 0xFD.Para desativar esse comportamento, use _CrtSetDebugFillThreshold.

Mapeamentos da rotina de Genérico- texto