System, _wsystem
Führt einen Befehl aus.
.gif "Wichtiger Hinweis") Wichtig |
|---|
Diese API kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.Weitere Informationen finden Sie unter CRT-Funktionen unterstützt nicht mit /ZW. |
int system( const char *command ); int _wsystem( const wchar_t *command );
Parameter
- command
Der Befehl, der ausgeführt werden soll.
Rückgabewert
Wenn commandNULL ist und der Befehlsinterpreter gefunden wird, gibt einen Wert ungleich 0 (null) zurück.Wenn der Befehlsinterpreter nicht gefunden wird, gibt 0 zurück und legt errno zu ENOENT fest.Wenn command nicht NULL ist, gibt system den Wert zurück, der vom Befehlsinterpreter zurückgegeben wird.Sie gibt den Wert 0 zurück, wenn der Befehlsinterpreter den Wert 0 zurückgibt.Ein Rückgabewert von - 1 gibt einen Fehler an, und errno wird auf einen der folgenden Werte festgelegt:
E2BIG
Die Argumentliste (die anlagenspezifisch ist), ist zu groß.ENOENT
Der Befehlsinterpreter kann nicht gefunden werden.ENOEXEC
Die Befehlsinterpreterdatei kann nicht ausgeführt werden, da das Format ungültig ist.ENOMEM
Nicht genügend Arbeitsspeicher verfügbar ist, Befehl auszuführen; oder verfügbarer Speicher ist beschädigt; oder ein nicht-gültiger Block vorhanden ist, der angibt, dass der Prozess, der ausführt, der Aufruf nicht ordnungsgemäß zugeordnet wurde.
Siehe _doserrno, errno, _sys_errlist und _sys_nerr weitere Informationen zu diesen Rückgabecodes.
Hinweise
Die system-Funktion führt command den Befehlsinterpreter, der die Zeichenfolge als Betriebssystembefehl ausgeführt wird.system verwendet die COMSPEC und PATH Umgebungsvariablen, um die Befehlsinterpreterdatei CMD.exe zu suchen.Wenn commandNULL ist, überprüft die Funktion nur, ob der Befehlsinterpreter vorhanden ist.
Sie müssen explizit Leeren-durch die Anwendung von fflush oder von _flushall- oder jeden Stream zu schließen, bevor Sie system aufrufen.
_wsystem ist eine Breitzeichen-Version von system; command das Argument an _wsystem ist eine Zeichenfolge mit Breitzeichen.Diese Funktionen verhalten sich andernfalls identisch.
Zuordnung generische Textroutinen
TCHAR.H-Routine |
_UNICODE & _MBCS nicht definiert. |
_MBCS definiert |
_UNICODE definiert |
|---|---|---|---|
_tsystem |
system |
system |
_wsystem |
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
system |
<process.h> oder <stdlib.h> |
_wsystem |
<process.h> oder <stdlib.h> oder <wchar.h> |
So zusätzlicher Kompatibilitätsinformation finden Sie unter Kompatibilität.
Beispiel
In diesem Beispiel wird system, um eine Textdatei EINZUGEBEN.
// crt_system.c
#include <process.h>
int main( void )
{
system( "type crt_system.txt" );
}
Eingabe: crt_system.txt
Line one.
Line two.
.gif "277bwbdz.collapse_all(de-de,VS.110).gif")
Ausgabe
Line one.
Line two.