sistema, _wsystem
Executa um comando.
.gif "Observação importante") 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. |
int system( const char *command ); int _wsystem( const wchar_t *command );
Parâmetros
- command
O comando ser executado.
Valor de retorno
Se command é NULL e o interpretador de comandos é localizado, retorna um valor diferente de zero.Se o interpretador de comandos não for encontrado, retornará 0 e defina errno a ENOENT.Se command não é NULL, system retorna o valor retornado por interpretador de comandos.Retorna o valor 0 somente se o interpretador de comandos retorna o valor 0.Um valor de retorno de – 1 indica um erro, e errno é definida como um dos seguintes valores:
E2BIG
A lista de argumentos (que é dependente do sistema) é muito grande.ENOENT
O interpretador de comandos não pode ser encontrado.ENOEXEC
O arquivo de interpretador de comandos não pode ser executado como o formato é inválido.ENOMEM
Não está disponível memória suficiente para executar o comando; ou a memória disponível foi danificada; um bloco válido ou não existe, que indica que o processo que está fazendo a chamada não esteve atribuído corretamente.
Consulte _doserrno, errno, _sys_errlist, e _sys_nerr para obter mais informações sobre esses códigos de retorno.
Comentários
A função de system passa command ao interpretador de comandos, que executa a cadeia de caracteres como um comando do sistema operacional.system usa variáveis de ambiente de COMSPEC e de PATH para localizar o arquivo CMD.exe de interpretador de comandos.Se command é NULL, a função verifica apenas se o interpretador de comandos existe.
Você deve explicitamente resplendor- por usar fflush ou _flushall— ou para fechar qualquer fluxo antes de chamar system.
_wsystem é uma versão de largo- caractere de system; o argumento de command a _wsystem é uma cadeia de caracteres de largo- caractere.Essas funções se comportam de forma idêntica.
Mapeamentos da rotina de Genérico- texto
Rotina de TCHAR.H |
_UNICODE & _MBCS não definidos |
_MBCS definido |
_UNICODE definido |
|---|---|---|---|
_tsystem |
system |
system |
_wsystem |
Requisitos
Rotina |
Cabeçalho necessário |
|---|---|
system |
<process.h> ou <stdlib.h> |
_wsystem |
<process.h> ou <stdlib.h> ou <wchar.h> |
Para informações extras de compatibilidade, consulte Compatibilidade.
Exemplo
Este exemplo usa system PARA DIGITAR um arquivo de texto.
// crt_system.c
#include <process.h>
int main( void )
{
system( "type crt_system.txt" );
}
Entrada: crt_system.txt
Line one.
Line two.
.gif "277bwbdz.collapse_all(pt-br,VS.110).gif")
Saída
Line one.
Line two.