system, _wsystem

コマンドを実行します。

構文

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

パラメーター

command
実行するコマンド。

戻り値

command が NULL の場合に、コマンド インタープリターが見つかると、0 以外の値を返します。 コマンド インタープリターが見つからない場合は、0 を返し、 errno を ENOENT に設定します。 commandがNULLされていない場合、systemはコマンド インタープリターによって返される値を返します。 コマンド インタープリターから値 0 が返された場合にのみ、値 0 を返します。 戻り値 -1 はエラーを示します。その場合、errno は次のいずれかの値に設定されます。

リターン コードの詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

解説

system 関数は command をコマンド インタープリターに渡し、その文字列がオペレーティング システム コマンドとして実行されます。 system は、COMSPEC および PATH の各環境変数を使用して、コマンド インタープリター ファイル CMD.exe を見つけます。 command が NULL の場合、この関数はコマンド インタープリターの存在を確認するだけです。

system を呼び出す前に、fflush または _flushall を使用してストリームを明示的にフラッシュするか、ストリームを閉じる必要があります。

_wsystem 関数は、 system関数のワイド文字バージョンです。 command 関数の引数 _wsystem は、ワイド文字列です。 それ以外では、これらの関数の動作は同じです。

既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。

汎用テキスト ルーチンのマップ

要件

互換性の詳細については、「 Compatibility」を参照してください。

例

この例では、system を使用してテキスト ファイルをタイプします。

// crt_system.c

#include <process.h>

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

入力: crt_system.txt

Line one.
Line two.

出力

Line one.
Line two.

関連項目

プロセスと環境の制御
_exec、_wexec 関数
exit、 _Exit、 _exit
_flushall
_spawn、_wspawn 関数