File stream functions.

File stream functions are used for stream operations with files. More...

Functions
EXTERNRT int	rtxStreamFileAttach (OSCTXT *pctxt, FILE *pFile, OSUINT16 flags)
	Attaches the existing file structure pointer to the stream.
EXTERNRT int	rtxStreamFileOpen (OSCTXT *pctxt, const char *pFilename, OSUINT16 flags)
	Opens a file stream.
EXTERNRT int	rtxStreamFileCreateReader (OSCTXT *pctxt, const char *pFilename)
	This function creates an input file stream using the specified file name.
EXTERNRT int	rtxStreamFileCreateWriter (OSCTXT *pctxt, const char *pFilename)
	This function creates an output file stream using the file name.

---

Detailed Description

File stream functions are used for stream operations with files.

---

Function Documentation

EXTERNRT int rtxStreamFileAttach	(	OSCTXT *	pctxt,
		FILE *	pFile,
		OSUINT16	flags
	)

Attaches the existing file structure pointer to the stream.

The file should be already opened either for the reading or writing. The 'flags' parameter specifies the access mode for the stream - input or output.

Parameters:

	pctxt	Pointer to a context structure variable that has been initialized for stream operations.
	pFile	Pointer to FILE structure. File should be already opened either for the writing or reading.
	flags	Specifies the access mode for the stream: OSRTSTRMF_INPUT = input (reading) stream; OSRTSTRMF_OUTPUT = output (writing) stream.

Returns:

Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamFileCreateReader	(	OSCTXT *	pctxt,
		const char *	pFilename
	)

This function creates an input file stream using the specified file name.

Parameters:

	pctxt	Pointer to a context structure variable that has been initialized for stream operations.
	pFilename	Pointer to null-terminated string that contains the name of file.

Returns:

Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamFileCreateWriter	(	OSCTXT *	pctxt,
		const char *	pFilename
	)

This function creates an output file stream using the file name.

Parameters:

	pctxt	Pointer to a context structure variable that has been initialized for stream operations.
	pFilename	Pointer to null-terminated string that contains the name of file.

Returns:

Completion status of operation: 0 = success, negative return value is error.

EXTERNRT int rtxStreamFileOpen	(	OSCTXT *	pctxt,
		const char *	pFilename,
		OSUINT16	flags
	)

Opens a file stream.

The 'flags' parameter specifies the access mode for the stream - input or output.

Parameters:

	pctxt	Pointer to a context structure variable that has been initialized for stream operations.
	pFilename	Pointer to null-terminated string that contains the name of file.
	flags	Specifies the access mode for the stream: OSRTSTRMF_INPUT = input (reading) stream; OSRTSTRMF_OUTPUT = output (writing) stream.

Returns:

Completion status of operation: 0 = success, negative return value is error.