Definition:

#include <aIO.h>
object code: aIO shared library



aLIBRETURN aStream_CreateFileOutput(

aIOLib ioRef, const char* pFilename, aStreamRef* pStreamRef, aErr* pErr);

Parameters:

ioRef	-	A reference to the aIO library used to create the stream.
pFilename	-	The null-terminated C-style string that designates the file name.  This filename is limited to aFILE_NAMEMAXCHARS characters.
pStreamRef	-	A pointer to a stream reference that is set to the newly created file output stream.
pErr	-	A pointer to an aErr variable that receives the error code on exit from this routine.

Return Value:

This library routine returns zero for no errors, and non-zero for errors.

Description:

This routine builds a aStreamRef stream reference object for a specified file.  If the file does not exist, it is created.  If it does exist, it is overwritten.

Related:

aStream_Create, aStream_CreateFileOutput, aStream_CreateSerial, aStream_CreateSocket, aStream_Destroy, aStem_SetStream