system, _wsystem

Spustí příkaz.

Důležité

Toto rozhraní API nelze použít v aplikacích, které se spouští v prostředí Windows Runtime. Další informace najdete v tématu Funkce CRT, které nejsou v aplikacích Univerzální platforma Windows podporované.

Syntaxe

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

Parametry

command
Příkaz, který se má spustit.

Vrácená hodnota

Pokud command je NULL a je nalezen interpret příkazu, vrátí nenulovou hodnotu. Pokud se interpret příkazu nenajde, vrátí hodnotu 0 a nastaví errno hodnotu ENOENT. Pokud command není NULL, system vrátí hodnotu vrácenou interpretem příkazu. Vrátí hodnotu 0 pouze v případě, že interpret příkazu vrátí hodnotu 0. Návratová hodnota -1 označuje chybu a errno je nastavená na jednu z následujících hodnot:

Hodnota	Popis
E2BIG	Seznam argumentů (který je závislý na systému) je příliš velký.
ENOENT	Interpret příkazu nebyl nalezen.
ENOEXEC	Soubor interpretu příkazů nelze spustit, protože formát není platný.
ENOMEM	Není k dispozici dostatek paměti ke spuštění příkazu; nebo je poškozena dostupná paměť; nebo existuje neplatný blok, který indikuje, že volající proces byl přidělen nesprávně.

Další informace o návratových kódech naleznete v tématu errno, _doserrno, _sys_errlista _sys_nerr.

Poznámky

system Funkce předá command interpretu příkazu, který řetězec spustí jako příkaz operačního systému. systemCOMSPEC PATH používá proměnné prostředí k vyhledání souboru interpretu příkazů CMD.exe. Pokud command ano NULL, funkce pouze zkontroluje, jestli interpret příkazu existuje.

Před voláním systemmusíte explicitně vyprázdnět fflush _flushallnebo zavřít jakýkoli datový proud .

_wsystemje verze širokého znaku systemcommand ; argument je _wsystem řetězec širokého znaku. Tyto funkce se chovají stejně jinak.

Ve výchozím nastavení je globální stav této funkce vymezen na aplikaci. Chcete-li toto chování změnit, přečtěte si téma Globální stav v CRT.

Mapování rutin obecného textu

TCHAR.H rutina	_UNICODE a _MBCS není definován	_MBCS definovaný	_UNICODE definovaný
_tsystem	system	system	_wsystem

Požadavky

Rutina	Požadovaný hlavičkový soubor
system	<process.h> nebo <stdlib.h>
_wsystem	<process.h>nebo <stdlib.h><wchar.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Příklad

Tento příklad používá system k zadání textového souboru.

// crt_system.c

#include <process.h>

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

Vstup: crt_system.txt

Line one.
Line two.

Výstup

Line one.
Line two.

Viz také

Řízení procesů a prostředí
_exec, _wexec funkce
exit, , _Exit_exit
_flushall
_spawn, _wspawn funkce