Partilhar via


sistema, _wsystem

executar um comando.

int system(
   const char *command 
);
int _wsystem(
   const wchar_t *command 
);

Parâmetros

  • command
    Comando a ser executado.

Valor de retorno

If command é NULL e o interpretador de comandos for encontrada, retorna um valor diferente de zero. Se o interpretador de comandos não for encontrado, retorna 0 e define errno para ENOENT. If command não é NULL, system Retorna o valor retornado pelo interpretador de comandos. Ele retorna o valor 0 somente se o interpretador de comando retorna o valor 0.Um valor retornado de – 1 indica um erro e errno é definido como um dos seguintes valores:

  • E2BIG
    Lista de argumentos (que é dependente do sistema) é muito grande.

  • ENOENT
    Não é possível encontrar o interpretador de comandos.

  • ENOEXEC
    Arquivo interpretador de comandos tem formato inválido e não é executável.

  • ENOMEM
    Está disponível para executar comando; não há memória suficiente ou corrompeu a memória disponível; ou bloco inválido existe, indicando que processo fazer telefonar não foi alocada corretamente.

See _doserrno, errno, _sys_errlist e _sys_nerr para obter mais informações sobre esses e outros códigos retorno.

Comentários

The system função passagens command ao interpretador de comandos, que executa a seqüência de caracteres sistema autônomo um comando de sistema operacional. system refere-se à COMSPEC e PATH variáveis de ambiente que localizar o interpretador de comandos de arquivo (o arquivo chamado cmd.exe no Windows 2000 e posterior). If command é nulo, a função simplesmente verifica se existe o interpretador de comandos.

Você deve liberar explicitamente (usando fflush ou _flushall) ou fechar qualquer fluxo antes de ligar system.

_wsystem é uma versão de caractere largo da system; o command argumento para _wsystem é uma seqüência de caracteres largos. Essas funções se comportam exatamente caso contrário.

Mapeamentos de rotina de texto genérica

Rotina TCHAR.H

_UNICODE & _MBCS não definido

_MBCS definido

_UNICODE definido

_tsystem

system

system

_wsystem

Requisitos

Rotina

Cabeçalho necessário

system

<processo.h> ou <stdlib.h>

_wsystem

<processo.h> ou <stdlib.h> ou <wchar.h>

Para obter informações adicionais compatibilidade, consulte Compatibilidade na introdução.

Exemplo

Esse programa usa system para um arquivo de texto de TYPE.

// crt_system.c

#include <process.h>

int main( void )
{
   system( "type crt_system.txt" );
}

Entrada: crt_system.txt

Line one.
Line two.

Saída

Line one.
Line two.

Equivalente do NET Framework

Consulte também

Referência

Processo e ambiente de controle

_exec, _wexec funções

sair, _exit

_flushall

_spawn, _wspawn funções