system, _wsystem

Menjalankan perintah.

Penting

API ini tidak dapat digunakan dalam aplikasi yang dijalankan di Windows Runtime. Untuk informasi selengkapnya, lihat Fungsi CRT yang tidak didukung di aplikasi Platform Windows Universal.

Sintaks

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

Parameter

command
Perintah yang akan dijalankan.

Nilai hasil

Jika command adalah NULL dan penerjemah perintah ditemukan, mengembalikan nilai bukan nol. Jika penerjemah perintah tidak ditemukan, mengembalikan 0 dan mengatur errno ke ENOENT. Jika command tidak NULL, system mengembalikan nilai yang dikembalikan oleh penerjemah perintah. Ini mengembalikan nilai 0 hanya jika penerjemah perintah mengembalikan nilai 0. Nilai pengembalian -1 menunjukkan kesalahan, dan errno diatur ke salah satu nilai berikut:

Nilai	Deskripsi
E2BIG	Daftar argumen (yang bergantung pada sistem) terlalu besar.
ENOENT	Penerjemah perintah tidak dapat ditemukan.
ENOEXEC	File command-interpreter tidak dapat dijalankan karena formatnya tidak valid.
ENOMEM	Memori tidak cukup tersedia untuk menjalankan perintah; atau memori yang tersedia telah rusak; atau ada blok yang tidak valid, yang menunjukkan bahwa proses panggilan telah dialokasikan dengan salah.

Untuk informasi selengkapnya tentang kode pengembalian, lihat errno, , _doserrno_sys_errlist, dan _sys_nerr.

Keterangan

Fungsi diteruskan system command ke penerjemah perintah, yang menjalankan string sebagai perintah sistem operasi. systemCOMSPEC menggunakan variabel lingkungan dan PATH untuk menemukan file command-interpreter CMD.exe. Jika command adalah NULL, fungsi hanya memeriksa apakah penerjemah perintah ada.

Anda harus secara eksplisit menghapus, dengan menggunakan fflush atau _flushall, atau menutup aliran apa pun sebelum Anda memanggil system.

_wsystem adalah versi karakter luas dari system; command argumen ke _wsystem adalah string karakter lebar. Fungsi-fungsi ini berulah secara identik jika tidak.

Secara default, status global fungsi ini dicakup ke aplikasi. Untuk mengubah perilaku ini, lihat Status global di CRT.

Pemetaan rutin teks generik

TCHAR.H Rutin	_UNICODE dan _MBCS tidak ditentukan	_MBCS Didefinisikan	_UNICODE Didefinisikan
_tsystem	system	system	_wsystem

Persyaratan

Rutin	Header yang diperlukan
system	<process.h> atau <stdlib.h>
_wsystem	<process.h> atau <stdlib.h> atau <wchar.h>

Untuk informasi kompatibilitas selengkapnya, lihat Kompatibilitas.

Contoh

Contoh ini digunakan system untuk MENGETIK file teks.

// crt_system.c

#include <process.h>

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

Input: crt_system.txt

Line one.
Line two.

Output

Line one.
Line two.

Lihat juga

Kontrol proses dan lingkungan
_exec, _wexec fungsi
exit, , _Exit_exit
_flushall
_spawn, _wspawn fungsi