wctomb_s, _wctomb_s_l
Converte um caractere largo os caracteres multibyte correspondente.Uma versão do wctomb, _wctomb_l com aprimoramentos de segurança, conforme descrito em Recursos de segurança no CRT.
errno_t wctomb_s(
int *pRetValue,
char *mbchar,
size_t sizeInBytes,
wchar_t wchar
);
errno_t _wctomb_s_l(
int *pRetValue,
char *mbchar,
size_t sizeInBytes,
wchar_t wchar,
_locale_t locale
);
Parâmetros
[out]pRetValue
O número de bytes, ou um código que indica o resultado.[out]mbchar
O endereço de um caracteres multibyte.[in]sizeInBytes
Tamanho do buffer mbchar.[in]wchar
Um caractere largo.[in]locale
A localidade para usar.
Valor de retorno
Zero se for bem-sucedido, um código de erro em caso de falha.
Condições de erro
mbchar |
sizeInBytes |
Valor de Retorno |
pRetValue |
---|---|---|---|
NULL |
> 0 |
EINVAL |
não modificado |
any |
>INT_MAX |
EINVAL |
não modificado |
any |
muito pequeno |
EINVAL |
não modificado |
Se ocorrer qualquer uma das condições de erro acima, o manipulador de parâmetro inválido é invocado, conforme descrito em Validação de parâmetro.Se a execução terá permissão para continuar, wctomb retorna EINVAL e define errno para EINVAL.
Comentários
O wctomb_s função converte seu wchar argumento para os caracteres multibyte correspondente e armazena o resultado no mbchar.Você pode chamar a função a partir de qualquer ponto em qualquer programa.
Se wctomb_s converte o caractere largo para um caractere de vários bytes, ele coloca o número de bytes (que nunca é maior que MB_CUR_MAX) no caractere grande para o inteiro apontado por pRetValue.Se wchar é o caractere nulo de caractere largo (L '\0'), wctomb_s preenche pRetValue com 1.Se o ponteiro de destino mbchar for NULL, wctomb_s coloca 0 em pRetValue.Se a conversão não é possível na localidade atual, wctomb_s coloca – 1 em pRetValue.
wctomb_susa a localidade atual para informações depende da localidade; _wctomb_s_lé idêntica, exceto que ele usa a localidade passada em vez disso.Para obter mais informações, consulte Localidade.
Requisitos
Rotina |
Cabeçalho necessário |
---|---|
wctomb_s |
<stdlib.h> |
_wctomb_s_l |
<stdlib.h> |
Para obter informações adicionais de compatibilidade, consulte compatibilidade na introdução.
Exemplo
Este programa ilustra o comportamento da wctomb função.
// crt_wctomb_s.cpp
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int i;
wchar_t wc = L'a';
char *pmb = (char *)malloc( MB_CUR_MAX );
printf_s( "Convert a wide character:\n" );
wctomb_s( &i, pmb, MB_CUR_MAX, wc );
printf_s( " Characters converted: %u\n", i );
printf_s( " Multibyte character: %.1s\n\n", pmb );
}
Equivalência do .NET Framework
Não aplicável. Para chamar a função c padrão, use PInvoke. Para obter mais informações, consulte Exemplos de invocação de plataforma.