Definition:

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



aLIBRETURN aStream_WriteLine(

aIOLib ioRef, aStreamRef streamRef, const char* pBuffer, aErr* pErr);

Parameters:

ioRef	-	A reference to the aIO library used to write to the stream.
streamRef	-	The stream reference that is used for writing.  This must be a writeable stream.
pBuffer	-	A pointer to a null-terminated, C-style string to be written.
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 writes a line of text to the stream and adds the end-of-line character appropriate for the platform being used at the end of the line.  Using this routine as well as the aStream_ReadLine routine ensures cross-platform handling of text files on a line-by-line basis.  If the stream is not writeable, an aErrMode error occurs.

Related:

aStream_Create, aStream_CreateFileOutput, aStream_CreateSerial, aStream_Write, aStream_ReadLine