_popen, _wpopen

파이프를 만들고 명령을 실행합니다.

Important

이 API는 Windows 런타임에서 실행되는 애플리케이션에서 사용할 수 없습니다. 자세한 내용은 유니버설 Windows 플랫폼 앱에서 지원되지 않는 CRT 함수를 참조하세요.

구문

FILE *_popen(
    const char *command,
    const char *mode
);
FILE *_wpopen(
    const wchar_t *command,
    const wchar_t *mode
);

매개 변수

command
실행할 명령입니다.

mode
반환된 스트림의 모드입니다.

반환 값

생성된 파이프의 한쪽 끝와 연결된 스트림을 반환합니다. 파이프의 반대쪽은 생성된 명령의 표준 입력 또는 표준 출력에 연결됩니다. 함수는 오류에 대해 반환 NULL 됩니다. 잘못된 매개 변수 errno 로 인해 오류가 발생하면 .로 설정 EINVAL됩니다. 올바른 모드는 설명 섹션을 참조하세요.

이러한 오류 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno, _sys_errlist_sys_nerr 를 참조하세요errno.

설명

함수는 _popen 파이프를 만듭니다. 그런 다음, 명령 프로세서의 생성된 복사본을 비동기적으로 실행하고 명령줄로 사용합니다 command . 문자열 mode 은 다음과 같이 요청된 액세스 유형을 지정합니다.

액세스 모드 설명
"r" 호출 프로세스가 반환된 스트림을 사용하여 생성된 명령의 표준 출력을 읽을 수 있습니다.
"w" 호출 프로세스가 반환된 스트림을 사용하여 생성된 명령의 표준 입력에 쓸 수 있습니다.
"b" 이진 모드에서 엽니다.
"t" 텍스트 모드에서 엽니다.

참고 항목

Windows 프로그램에서 사용하는 경우 _popen 함수는 프로그램이 무기한 응답을 중지하도록 하는 잘못된 파일 포인터를 반환합니다. 콘솔 애플리케이션에서는 _popen이 제대로 작동합니다. 입력 및 출력을 리디렉션하는 Windows 애플리케이션을 만들려면 Windows SDK에서 리디렉션된 입력 및 출력을 사용하여 자식 프로세스 만들기를 참조하세요.

_wpopen_popen의 와이드 문자 버전이며, path 에 대한 _wpopen 인수는 와이드 문자열입니다. 그렇지 않으면_wpopen_popen 이 동일하게 작동합니다.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

일반 텍스트 루틴 매핑

Tchar.h 루틴 _UNICODE 정의 _MBCS 되지 않음 _MBCS 정의 _UNICODE 정의
_tpopen _popen _popen _wpopen

요구 사항

루틴에서 반환된 값 필수 헤더
_popen <stdio.h>
_wpopen <stdio.h> 또는 <wchar.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

라이브러리

모든 버전의 C 런타임 라이브러리입니다.

예시

// popen.c
/* This program uses _popen and _pclose to receive a
* stream of text from a system process.
*/

#include <stdio.h>
#include <stdlib.h>

int main(void)
{
    char psBuffer[128];
    FILE* pPipe;

    /* Run DIR so that it writes its output to a pipe. Open this
     * pipe with read text attribute so that we can read it
     * like a text file.
     */

    if ((pPipe = _popen("dir *.c /on /p", "rt")) == NULL)
    {
        exit(1);
    }

    /* Read pipe until end of file, or an error occurs. */

    while (fgets(psBuffer, 128, pPipe))
    {
        puts(psBuffer);
    }

    int endOfFileVal = feof(pPipe);
    int closeReturnVal = _pclose(pPipe);

    if (endOfFileVal)
    {
        printf("\nProcess returned %d\n", closeReturnVal);
    }
    else
    {
        printf("Error: Failed to read the pipe to the end.\n");
    }
}

이 출력에서는 현재 디렉터리에 파일 이름 확장명을 가진 .c 파일이 하나만 있다고 가정합니다.

Volume in drive C is CDRIVE
Volume Serial Number is 0E17-1702

Directory of D:\proj\console\test1

07/17/98  07:26p                   780 popen.c
               1 File(s)            780 bytes
                             86,597,632 bytes free

Process returned 0

참고 항목

프로세스 및 환경 제어
_pclose
_pipe