Usando wmain

Específico da Microsoft

No modelo de programação Unicode, você pode definir uma versão de caracteres largos da main função. Use wmain em vez de se você quiser escrever código portátil que adere ao modelo de main programação Unicode.

Como main, várias restrições se aplicam à wmain função que não se aplicam a nenhuma outra função C. A wmain função:

• Não pode ser declarado como inline.
• Não pode ser declarado como static.
• Não é possível ter seu endereço tomado.
• Não pode ser chamado a partir do seu programa.

A wmain assinatura da função

A wmain função não tem uma declaração, porque está incorporada na linguagem. Se isso acontecesse, a sintaxe da declaração para wmain ficaria assim:

int wmain( void );
int wmain( int argc, wchar_t *argv[ ] );
int wmain( int argc, wchar_t *argv[ ], wchar_t *envp[ ] );

A wmain função é declarada implicitamente usando uma dessas assinaturas. Você pode usar qualquer uma dessas assinaturas ao definir sua wmain função. Em seguida, você pode passar argumentos de caracteres largos e, opcionalmente, um ponteiro de ambiente de caracteres largos para o programa. O compilador da Microsoft também permite wmain ter um tipo de retorno de quando nenhum valor é retornado void . Os argv parâmetros e envp a wmain também podem ser definidos como tipo wchar_t**. Para obter mais informações sobre os argumentos, consulte Descrição do argumento.

O envp ambiente

Se o programa usa uma main função, o ambiente de caracteres multibyte é criado pela biblioteca de tempo de execução na inicialização do programa. Uma cópia de caracteres largos do ambiente é criada apenas quando necessário (por exemplo, por uma chamada às funções _wgetenv ou _wputenv). Na primeira chamada para _wputenv, ou na primeira chamada para _wgetenv se já existir um ambiente MBCS, um ambiente de cadeia de caracteres largos correspondente é criado e, em seguida, é apontado _wenviron pela variável global, que é uma versão de caracteres largos da _environ variável global. Neste ponto, duas cópias do ambiente (MBCS e Unicode) existem simultaneamente e são mantidas pelo sistema operacional durante toda a vida útil do programa.

Da mesma forma, se o programa usa uma wmain função, um ambiente de caracteres largos é criado na inicialização do programa e é apontado _wenviron pela variável global. Um ambiente MBCS (ASCII) é criado na primeira chamada para _putenv ou getenve é apontado _environ pela variável global.

Para obter mais informações sobre o ambiente MBCS, consulte Internacionalização.

END Específico da Microsoft

Ver também

main Execução de funções e programas