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