system、_wsystem（C++）

ヘッダーファイル

stdlib.h

カテゴリ

プロセス制御ルーチン

プロトタイプ

int system(const char *command);

int _wsystem(const wchar_t *command);

説明

オペレーティングシステムコマンドを実行します。

システムは、オペレーティングシステムのコマンドプロセッサを呼び出して、実行中の C プログラム内からオペレーティングシステムコマンド、バッチファイル、文字列コマンドで指定されたその他のプログラムを実行します。

プログラムを見つけて実行するには、そのプログラムがカレントディレクトリ、または環境変数の PATH 文字列内に列挙されたディレクトリの 1 つに置かれていなければなりません。

COMSPEC 環境変数は、コマンドプロセッサプログラムを見つけるために使われます。したがって、コマンドプロセッサプログラムはカレントディレクトリに存在する必要はありません。

戻り値

コマンドが NULL ポインタの場合、コマンドプロセッサが利用可能であれば、システムは 0 以外を返します。

コマンドが NULL ポインタでない場合、コマンドプロセッサが正常に起動されていれば、システムは 0 を返します。

エラーが発生した場合は、-1 を返し、errno を次のいずれかの値に設定します。

例

#include <stdlib.h>
#include <stdio.h>
int main(void)
{
   printf("About to spawn a command-line program.\n");
   system("dir");
   return 0;
}

移植性

	POSIX	Win32	ANSI C	ANSI C++
system	+	+
_wsystem		NT のみ

案内メニュー