system, _wsystem

Поиск.

Важное примечаниеВажно

Этот API нельзя использовать в приложениях, выполняемых в Среда выполнения Windows.Дополнительные сведения см. в разделе Функции CRT не поддерживаются при /ZW.

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

Параметры

  • command
    Команда для выполнения.

Возвращаемое значение

Если command имеет значение NULL и интерпретатор команды найден, возвращает ненулевое значение.Если интерпретатор команды не найден, возвращается 0 и задает для errno значение ENOENT.Если параметр command не является NULL, то system возвращает значение, которое возвращается переводчиком команды.Она возвращает значение 0, только если интерпретатор команды возвращает значение 0.Возвращаемое значение – 1 указывает на ошибку, а errno - одно из следующих значений:

  • E2BIG
    Список аргументов, системой (зависимого) слишком велико.

  • ENOENT
    Интерпретатор команды не найден.

  • ENOEXEC
    Файл команда- переводчика не может быть выполнена, так как формат недопустим.

  • ENOMEM
    Недостаточно памяти доступен выполнение команды; была повреждена или доступной памяти; допустимый блок или не существует, который указывает, что процесс, который выполняет вызов не был установлен правильно.

Дополнительные сведения см. в разделе _doserrno, errno, _sys_errlist и _sys_nerr об этих кодах возврата.

Заметки

Функция system передает command в переводчику команды, выполняющий строку как команда операционной системы.system использует переменные среды COMSPEC и PATH, чтобы найти файл CMD.exe команда- переводчика.Если command имеет значение NULL, то функция только проверяет существование интерпретатор команды.

Явно приток- вызов fflush или _flushall— или закрыть любой поток до вызова функции system.

_wsystem двухбайтовая версия system; аргумент command для _wsystem - строка двухбайтовых знаков.В остальном эти функции ведут себя идентично.

Универсальное текстовое сопоставление функций

Функция TCHAR.H

неопределенные _UNICODE & _MBCS

определенные _MBCS

Определение _UNICODE

_tsystem

system

system

_wsystem

Требования

Функция

Требуемый заголовок

system

<process.h> или <stdlib.h>

_wsystem

<process.h> или <stdlib.h> или <wchar.h>

Для дополнительных данных о совместимости см. в разделе Совместимость.

Пример

В этом примере используется system, чтобы ПЕЧАТАТЬ текстовый файл.

// crt_system.c

#include <process.h>

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

Входные данные: crt_system.txt

Line one.
Line two.

277bwbdz.collapse_all(ru-ru,VS.110).gifOutput

Line one.
Line two.

Эквивалент в .NET Framework

См. также

Ссылки

Процесс и управление среды

_exec, функции _wexec

exit, _exit

_flushall

_spawn, функции _wspawn