Gets the file descriptor that represents the standard input, output, or error stream.
Syntax
#include <prio.h> PRFileDesc* PR_GetSpecialFD(PRSpecialFD id);
Parameter
The function has the following parameter:
id
- A pointer to an enumerator of type
PRSpecialFD
, indicating the type of I/O stream desired:PR_StandardInput
,PR_StandardOutput
, orPR_StandardError
.
Returns
If the id
parameter is valid, PR_GetSpecialFD
returns a file descriptor that represents the corresponding standard I/O stream. Otherwise, PR_GetSpecialFD
returns NULL
and sets the error to PR_INVALID_ARGUMENT_ERROR
.
Description
Type PRSpecialFD
is defined as follows:
typedef enum PRSpecialFD{ PR_StandardInput, PR_StandardOutput, PR_StandardError } PRSpecialFD;
#define PR_STDIN PR_GetSpecialFD(PR_StandardInput)
#define PR_STDOUT PR_GetSpecialFD(PR_StandardOutput)
#define PR_STDERR PR_GetSpecialFD(PR_StandardError)
File descriptors returned by PR_GetSpecialFD
are owned by the runtime and should not be closed by the caller.