/* PUTS.C

  * 

  * Portions Copyright (c) 1990-2006 Nokia Corporation and/or its subsidiary(-ies).

  * All rights reserved.

  */

 /*

  * Copyright (c) 1990 The Regents of the University of California.

  * All rights reserved.

  *

  * Redistribution and use in source and binary forms are permitted

  * provided that the above copyright notice and this paragraph are

  * duplicated in all such forms and that any documentation,

  * advertising materials, and other materials related to such

  * distribution and use acknowledge that the software was developed

  * by the University of California, Berkeley.  The name of the

  * University may not be used to endorse or promote products derived

  * from this software without specific prior written permission.

  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR

  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED

  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

  */

 /*

 FUNCTION

 <<puts>>---write a character string

 INDEX

 	puts

 INDEX

 	_puts_r

 ANSI_SYNOPSIS

 	#include <stdio.h>

 	int puts(const char *<[s]>);

 	int _puts_r(void *<[reent]>, const char *<[s]>);

 TRAD_SYNOPSIS

 	#include <stdio.h>

 	int puts(<[s]>)

 	char *<[s]>;

 	int _puts_r(<[reent]>, <[s]>)

 	char *<[reent]>;

 	char *<[s]>;

 DESCRIPTION

 <<puts>> writes the string at <[s]> (followed by a newline, instead of

 the trailing null) to the standard output stream.

 The alternate function <<_puts_r>> is a reentrant version.  The extra

 argument <[reent]> is a pointer to a reentrancy structure.

 RETURNS

 If successful, the result is a nonnegative integer; otherwise, the

 result is <<EOF>>.

 PORTABILITY

 ANSI C requires <<puts>>, but does not specify that the result on

 success must be <<0>>; any non-negative value is permitted.

 Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,

 <<lseek>>, <<read>>, <<sbrk>>, <<write>>.  */

 #include <stdio_r.h>

 #include <string.h>

 #include "FVWRITE.H"

 #include "LOCAL.H"

 /**

 Writes the given string to stdout, appending a newline.

 @return

 @param 

 */

 EXPORT_C int

 _puts_r (struct _reent *ptr, const char * s)

 {

   size_t c = strlen (s);

   struct __suio uio;

   struct __siov iov[2];

   iov[0].iov_base = s;

   iov[0].iov_len = c;

   iov[1].iov_base = "\n";

   iov[1].iov_len = 1;

   uio.uio_resid = c + 1;

   uio.uio_iov = &iov[0];

   uio.uio_iovcnt = 2;

   return (__sfvwrite (_stdout_r (ptr), &uio) ? EOF : '\n');

 }

 #ifndef _REENT_ONLY

 /**

 Outputs a string to stdout. Copies the string to standard output stream

 and appends a new line character (\n).

 @param Null-terminated string to be outputed.

 @return On Success, a non-negative value is returned.

 		On Failure, EOF value is returned and errno may be set.

 */

 EXPORT_C int

 puts (char const * s)

 {

   struct _reent *r = _REENT2;

   if (!r)

 	return EOF; // Memory for library globals is not allocated (errno not set).

   return _puts_r (r, s);

 }

 #endif