Chapter Contents

Previous

Next
pclose

pclose



Close Pipe I/O To a Process

Portability: POSIX.1 conforming


SYNOPSIS
DESCRIPTION
RETURN VALUE
PORTABILITY
EXAMPLE
RELATED FUNCTIONS
SEE ALSO


SYNOPSIS

#include <stdio.h>

int pclose(FILE *pipe);


DESCRIPTION

pclose closes a pipe connected to a shell command that was opened by popen . The argument pipe is the FILE pointer returned by popen . The pclose function waits for the associated process to terminate.

An appropriate feature test macro ( _SASC_POSIX_SOURCE or _POSIX_C_SOURCE ) must be defined to make the declaration of pclose in <stdio.h> visible.


RETURN VALUE

pclose returns the exit status of the command. pclose returns -1 if the stream is not associated with a command called by popen , or if an error occurs closing the pipe.


PORTABILITY

pclose is defined in accordance with POSIX 1003.2.


EXAMPLE

See the example for popen .


RELATED FUNCTIONS

fclose , popen


SEE ALSO


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.