Definition:

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



aLIBRETURN aFile_Write(

aIOLib ioRef, aFileRef fileRef, const char* pBuffer, const unsigned long nLength, unsigned long* pActuallyWritten, aErr* pErr);

Parameters:

ioRef	-	A pointer to the opaque library reference used when writing to the file.
fileRef	-	A aFileRef reference that represents the file to be written.
pBuffer	-	A pointer the the data that will be written.
nLength	-	The number of characters that should be written.
pActuallyWritten	-	If this pointer is not NULL the number of characters actually written will be stored in the unsigned long this pointer points to.
pErr	-	A pointer to an aErr variable that receives the error code on exit from this routine.

Return Value:

This library routine returns an aLIBRETURN type that is non-zero if there are errors, and zero if the routine completes with no errors.

Description:

This writes raw, unformatted characters to the aFileRef specified.  The routine will fail with a aErrMode error if the file permissions don't allow writing.  This routine tries to write the requested number of bytes and will return the actual number written if a pointer is provided.

Related:

aFile_Open, aFile_Close, aFile_Read, aFile_Seek, aFile_GetSize, aFile_Delete