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. <<feof>>, <<feof_unlocked>>---test for end of file
  21.  
  22. INDEX
  23.         feof
  24. INDEX
  25.         feof_unlocked
  26.  
  27. ANSI_SYNOPSIS
  28.         #include <stdio.h>
  29.         int feof(FILE *<[fp]>);
  30.  
  31.         #define _BSD_SOURCE
  32.         #include <stdio.h>
  33.         int feof_unlocked(FILE *<[fp]>);
  34.  
  35. TRAD_SYNOPSIS
  36.         #include <stdio.h>
  37.         int feof(<[fp]>)
  38.         FILE *<[fp]>;
  39.  
  40.         #define _BSD_SOURCE
  41.         #include <stdio.h>
  42.         int feof_unlocked(<[fp]>)
  43.         FILE *<[fp]>;
  44.  
  45. DESCRIPTION
  46. <<feof>> tests whether or not the end of the file identified by <[fp]>
  47. has been reached.
  48.  
  49. <<feof_unlocked>> is a non-thread-safe version of <<feof>>.
  50. <<feof_unlocked>> may only safely be used within a scope
  51. protected by flockfile() (or ftrylockfile()) and funlockfile().  This
  52. function may safely be used in a multi-threaded program if and only
  53. if they are called while the invoking thread owns the (FILE *)
  54. object, as is the case after a successful call to the flockfile() or
  55. ftrylockfile() functions.  If threads are disabled, then
  56. <<feof_unlocked>> is equivalent to <<feof>>.
  57.  
  58. RETURNS
  59. <<feof>> returns <<0>> if the end of file has not yet been reached; if
  60. at end of file, the result is nonzero.
  61.  
  62. PORTABILITY
  63. <<feof>> is required by ANSI C.
  64.  
  65. <<feof_unlocked>> is a BSD extension also provided by GNU libc.
  66.  
  67. No supporting OS subroutines are required.
  68. */
  69.  
  70. #include <stdio.h>
  71. #include "local.h"
  72.  
  73. /* A subroutine version of the macro feof.  */
  74.  
  75. #undef feof
  76.  
  77. int
  78. _DEFUN(feof, (fp),
  79.        FILE * fp)
  80. {
  81.   int result;
  82.   CHECK_INIT(_REENT, fp);
  83.   _newlib_flockfile_start (fp);
  84.   result = __sfeof (fp);
  85.   _newlib_flockfile_end (fp);
  86.   return result;
  87. }
  88.