os/ossrv/genericopenlibs/cstdlib/LSTDIO/REWIND.C
author sl
Tue, 10 Jun 2014 14:32:02 +0200
changeset 1 260cb5ec6c19
permissions -rw-r--r--
Update contrib.
     1 /* REWIND.C
     2  * 
     3  * Portions Copyright (c) 1990-1999 Nokia Corporation and/or its subsidiary(-ies).
     4  * All rights reserved.
     5  */
     6 
     7 /*
     8  * Copyright (c) 1990 The Regents of the University of California.
     9  * All rights reserved.
    10  *
    11  * Redistribution and use in source and binary forms are permitted
    12  * provided that the above copyright notice and this paragraph are
    13  * duplicated in all such forms and that any documentation,
    14  * advertising materials, and other materials related to such
    15  * distribution and use acknowledge that the software was developed
    16  * by the University of California, Berkeley.  The name of the
    17  * University may not be used to endorse or promote products derived
    18  * from this software without specific prior written permission.
    19  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
    20  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
    21  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
    22  */
    23 
    24 /*
    25 FUNCTION
    26 <<rewind>>---reinitialize a file or stream
    27 
    28 INDEX
    29 	rewind
    30 
    31 ANSI_SYNOPSIS
    32 	#include <stdio.h>
    33 	void rewind(FILE *<[fp]>);
    34 
    35 TRAD_SYNOPSIS
    36 	#include <stdio.h>
    37 	void rewind(<[fp]>)
    38 	FILE *<[fp]>;
    39 
    40 DESCRIPTION
    41 <<rewind>> returns the file position indicator (if any) for the file
    42 or stream identified by <[fp]> to the beginning of the file.  It also
    43 clears any error indicator and flushes any pending output.
    44 
    45 RETURNS
    46 <<rewind>> does not return a result.
    47 
    48 PORTABILITY
    49 ANSI C requires <<rewind>>.
    50 
    51 No supporting OS subroutines are required.
    52 */
    53 
    54 #include <stdio.h>
    55 /**
    56 Repositions the file pointer to the beginning of a stream.
    57 Sets the file pointer associated with the stream 
    58 to the beginning of the file.
    59 @param Pointer to an open file.
    60 */
    61 EXPORT_C void
    62 rewind (FILE * fp)
    63 {
    64   (void) fflush (fp);
    65   clearerr (fp);
    66   if (fp->_seek == NULL)
    67     return;			/* ??? */
    68   fp->_r = 0;
    69   fp->_p = fp->_bf._base;
    70   (void) (*fp->_seek) (fp->_cookie, (fpos_t) 0, SEEK_SET);
    71 }