Subversion Repositories Kolibri OS

Rev

Rev 4921 | Blame | Compare with Previous | Last modification | View Log | RSS feed

  1. /*
  2.  * Copyright (c) 1990 The Regents of the University of California.
  3.  * All rights reserved.
  4.  *
  5.  * Redistribution and use in source and binary forms are permitted
  6.  * provided that the above copyright notice and this paragraph are
  7.  * duplicated in all such forms and that any documentation,
  8.  * advertising materials, and other materials related to such
  9.  * distribution and use acknowledge that the software was developed
  10.  * by the University of California, Berkeley.  The name of the
  11.  * University may not be used to endorse or promote products derived
  12.  * from this software without specific prior written permission.
  13.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  14.  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  15.  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  16.  */
  17.  
  18. /*
  19. FUNCTION
  20. <<fputs>>, <<fputs_unlocked>>---write a character string in a file or stream
  21.  
  22. INDEX
  23.         fputs
  24. INDEX
  25.         fputs_unlocked
  26. INDEX
  27.         _fputs_r
  28. INDEX
  29.         _fputs_unlocked_r
  30.  
  31. ANSI_SYNOPSIS
  32.         #include <stdio.h>
  33.         int fputs(const char *restrict <[s]>, FILE *restrict <[fp]>);
  34.  
  35.         #define _GNU_SOURCE
  36.         #include <stdio.h>
  37.         int fputs_unlocked(const char *restrict <[s]>, FILE *restrict <[fp]>);
  38.  
  39.         #include <stdio.h>
  40.         int _fputs_r(struct _reent *<[ptr]>, const char *restrict <[s]>, FILE *restrict <[fp]>);
  41.  
  42.         #include <stdio.h>
  43.         int _fputs_unlocked_r(struct _reent *<[ptr]>, const char *restrict <[s]>, FILE *restrict <[fp]>);
  44.  
  45. TRAD_SYNOPSIS
  46.         #include <stdio.h>
  47.         int fputs(<[s]>, <[fp]>)
  48.         char *<[s]>;
  49.         FILE *<[fp]>;
  50.  
  51.         #define _GNU_SOURCE
  52.         #include <stdio.h>
  53.         int fputs_unlocked(<[s]>, <[fp]>)
  54.         char *<[s]>;
  55.         FILE *<[fp]>;
  56.  
  57.         #include <stdio.h>
  58.         int _fputs_r(<[ptr]>, <[s]>, <[fp]>)
  59.         struct _reent *<[ptr]>;
  60.         char *<[s]>;
  61.         FILE *<[fp]>;
  62.  
  63.         #include <stdio.h>
  64.         int _fputs_unlocked_r(<[ptr]>, <[s]>, <[fp]>)
  65.         struct _reent *<[ptr]>;
  66.         char *<[s]>;
  67.         FILE *<[fp]>;
  68.  
  69. DESCRIPTION
  70. <<fputs>> writes the string at <[s]> (but without the trailing null)
  71. to the file or stream identified by <[fp]>.
  72.  
  73. <<fputs_unlocked>> is a non-thread-safe version of <<fputs>>.
  74. <<fputs_unlocked>> may only safely be used within a scope
  75. protected by flockfile() (or ftrylockfile()) and funlockfile().  This
  76. function may safely be used in a multi-threaded program if and only
  77. if they are called while the invoking thread owns the (FILE *)
  78. object, as is the case after a successful call to the flockfile() or
  79. ftrylockfile() functions.  If threads are disabled, then
  80. <<fputs_unlocked>> is equivalent to <<fputs>>.
  81.  
  82. <<_fputs_r>> and <<_fputs_unlocked_r>> are simply reentrant versions of the
  83. above that take an additional reentrant struct pointer argument: <[ptr]>.
  84.  
  85. RETURNS
  86. If successful, the result is <<0>>; otherwise, the result is <<EOF>>.
  87.  
  88. PORTABILITY
  89. ANSI C requires <<fputs>>, but does not specify that the result on
  90. success must be <<0>>; any non-negative value is permitted.
  91.  
  92. <<fputs_unlocked>> is a GNU extension.
  93.  
  94. Supporting OS subroutines required: <<close>>, <<fstat>>, <<isatty>>,
  95. <<lseek>>, <<read>>, <<sbrk>>, <<write>>.
  96. */
  97.  
  98. #include <_ansi.h>
  99. #include <stdio.h>
  100. #include <string.h>
  101. #include "fvwrite.h"
  102. #include "local.h"
  103.  
  104. #ifdef __IMPL_UNLOCKED__
  105. #define _fputs_r _fputs_unlocked_r
  106. #define fputs fputs_unlocked
  107. #endif
  108.  
  109. /*
  110.  * Write the given string to the given file.
  111.  */
  112. int
  113. _DEFUN(_fputs_r, (ptr, s, fp),
  114.        struct _reent * ptr _AND
  115.        char _CONST *__restrict s _AND
  116.        FILE *__restrict fp)
  117. {
  118. #ifdef _FVWRITE_IN_STREAMIO
  119.   int result;
  120.   struct __suio uio;
  121.   struct __siov iov;
  122.  
  123.   iov.iov_base = s;
  124.   iov.iov_len = uio.uio_resid = strlen (s);
  125.   uio.uio_iov = &iov;
  126.   uio.uio_iovcnt = 1;
  127.  
  128.   CHECK_INIT(ptr, fp);
  129.  
  130.   _newlib_flockfile_start (fp);
  131.   ORIENT (fp, -1);
  132.   result = __sfvwrite_r (ptr, fp, &uio);
  133.   _newlib_flockfile_end (fp);
  134.   return result;
  135. #else
  136.   _CONST char *p = s;
  137.  
  138.   CHECK_INIT(ptr, fp);
  139.  
  140.   _newlib_flockfile_start (fp);
  141.   ORIENT (fp, -1);
  142.   /* Make sure we can write.  */
  143.   if (cantwrite (ptr, fp))
  144.     goto error;
  145.  
  146.   while (*p)
  147.     {
  148.       if (__sputc_r (ptr, *p++, fp) == EOF)
  149.         goto error;
  150.     }
  151.   _newlib_flockfile_exit (fp);
  152.   return 0;
  153.  
  154. error:
  155.   _newlib_flockfile_end (fp);
  156.   return EOF;
  157. #endif
  158. }
  159.  
  160. #ifndef _REENT_ONLY
  161. int
  162. _DEFUN(fputs, (s, fp),
  163.        char _CONST *__restrict s _AND
  164.        FILE *__restrict fp)
  165. {
  166.   return _fputs_r (_REENT, s, fp);
  167. }
  168. #endif /* !_REENT_ONLY */
  169.