-// ----------------------------------------------------------------------------
-// $Id$
-// ----------------------------------------------------------------------------
-// Public Domain C Library - http://pdclib.sourceforge.net
-// This code is Public Domain. Use, modify, and redistribute at will.
-// ----------------------------------------------------------------------------
-
-int fputs( const char * restrict s, FILE * restrict stream ) { /* TODO */ };
+/* $Id$ */
+
+/* fputs( const char *, FILE * )
+
+ This file is part of the Public Domain C Library (PDCLib).
+ Permission is granted to use, modify, and / or redistribute at will.
+*/
+
+#include <stdio.h>
+
+#ifndef REGTEST
+#include <_PDCLIB_glue.h>
+
+int fputs( const char * _PDCLIB_restrict s, struct _PDCLIB_file_t * _PDCLIB_restrict stream )
+{
+ if ( _PDCLIB_prepwrite( stream ) == EOF )
+ {
+ return EOF;
+ }
+ while ( *s != '\0' )
+ {
+ /* Unbuffered and line buffered streams get flushed when fputs() does
+ write the terminating end-of-line. All streams get flushed if the
+ buffer runs full.
+ */
+ stream->buffer[ stream->bufidx++ ] = *s;
+ /* TODO: Should IOLBF flush on \n, or the correct EOL sequence of the system? */
+ if ( ( stream->bufidx == stream->bufsize )
+ || ( ( stream->status & _IOLBF ) && *s == '\n' ) )
+ {
+ if ( _PDCLIB_flushbuffer( stream ) == EOF )
+ {
+ return EOF;
+ }
+ }
+ ++s;
+ }
+ if ( stream->status & _IONBF )
+ {
+ if ( _PDCLIB_flushbuffer( stream ) == EOF )
+ {
+ return EOF;
+ }
+ }
+ return 0;
+}
+
+#endif
+#ifdef TEST
+#include <_PDCLIB_test.h>
+
+int main( void )
+{
+ char const * const testfile = "testfile";
+ char const * const message = "SUCCESS testing fputs()";
+ FILE * fh;
+ remove( testfile );
+ TESTCASE( ( fh = fopen( testfile, "w+" ) ) != NULL );
+ TESTCASE( fputs( message, fh ) >= 0 );
+ rewind( fh );
+ for ( size_t i = 0; i < 23; ++i )
+ {
+ TESTCASE( fgetc( fh ) == message[i] );
+ }
+ TESTCASE( fclose( fh ) == 0 );
+ TESTCASE( remove( testfile ) == 0 );
+ return TEST_RESULTS;
+}
+
+#endif
+