fputs man page on DigitalUNIX

Man page or keyword search:  
man Server   12896 pages
apropos Keyword Search (all sections)
Output format
DigitalUNIX logo
[printable version]

puts(3)								       puts(3)

NAME
       puts, fputs - Writes a string to a stream

SYNOPSIS
       #include <stdio.h>

       int puts(
	       const char *string ); int fputs(
	       const char *string,
	       FILE *stream );

LIBRARY
       Standard C Library (libc)

PARAMETERS
       Points  to a string to be written to output.  Points to the FILE struc‐
       ture of an open file.

DESCRIPTION
       The puts() function writes the null-terminated string pointed to by the
       string parameter, followed by a newline character, to the standard out‐
       put stream, stdout.

       The fputs() function writes the null-terminated string  pointed	to  by
       the  string  parameter  to  the	output	stream specified by the stream
       parameter. The fputs() function does not append a newline character.

       Neither function writes the terminating null byte.

       The st_ctime and st_mtime fields of the	file  are  marked  for	update
       between	the successful execution of the puts() or fputs() function and
       the next successful completion of a call to one of  the	following:  An
       fflush()	 or fclose() function on the same stream The exit() or abort()
       function

NOTES
       Full use.

RETURN VALUES
       Upon successful completion, the puts() and fputs() functions return the
       number of characters written. Both subroutines return EOF on an error.

ERRORS
       The  puts()  and	 fputs()  functions fail under either of the following
       conditions: The stream is unbuffered.  The stream's buffer needed to be
       flushed,	 the  function call caused an underlying write() or lseek() to
       be invoked, and this underlying operation fails with incomplete output.

       In addition, if any of the following conditions occur,  the  puts()  or
       fputs() function sets errno to the corresponding value.	The O_NONBLOCK
       option is set for the file descriptor underlying stream and the process
       would  be delayed in the write operation.  The file descriptor underly‐
       ing stream is not a valid file descriptor open for writing.  An attempt
       was  made to write to a file that exceeds the process's file size limit
       or the maximum file size.  The read operation was interrupted by a sig‐
       nal  that  was caught, and no data was transferred.  The implementation
       supports job control; the process is a member of a  background  process
       group  attempting  to write to its controlling terminal; TOSTOP is set;
       the process is neither ignoring nor blocking SIGTTOU, and  the  process
       group of the process is orphaned. This error may also be returned under
       implementation-defined conditions.  There was no free  space  remaining
       on  the	device containing the file.  An attempt was made to write to a
       pipe or FIFO that is not open for reading by  any  process.  A  SIGPIPE
       signal will also be sent to the process.

SEE ALSO
       Functions: fgetws(3), fputws(3), gets(3), printf(3), putc(3), putwc(3).

								       puts(3)
[top]

List of man pages available for DigitalUNIX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net