NAME
    freopen - close (if necessary) and reopen a filestream

SYNOPSIS
    freopen(fs, mode [,filename])

TYPES
    fs		open or closed file stream
    mode	one of the strings "r", "w", "a", "r+", "w+, "a+"
    filename	string

    return	null or error value

DESCRIPTION
    With two arguments, this function closes the file stream fs and
    attempts to reopen it with the specified mode.  A non-null value
    is returned only if the attempt fails.

    With three arguments, fs, if open, is closed, and an attempt is made to
    open the file with the specified name and assign it to the stream
    fs.	 A non-null value is returned only if the attempt fails.

EXAMPLE

    ; f = fopen("/tmp/junk", "w")
    ; fputs(f, "Leonard Euler")
    ; freopen(f, "r")
    ; fgets(f)
	    "Leonard Euler"
    ; !chmod u-w /tmp/junk
    ; freopen(f, "w")
	    Error 10013

LIMITS
    none

LINK LIBRARY
    none

SEE ALSO
    errno, fclose, feof, ferror, fflush, fgetc, fgetline, fgets, files, fopen,
    fprintf, fputc, fputs, fseek, fsize, ftell, isfile, printf, prompt

## Copyright (C) 1999-2006  Landon Curt Noll
##
## Calc is open software; you can redistribute it and/or modify it under
## the terms of the version 2.1 of the GNU Lesser General Public License
## as published by the Free Software Foundation.
##
## Calc is distributed in the hope that it will be useful, but WITHOUT
## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
## or FITNESS FOR A PARTICULAR PURPOSE.	 See the GNU Lesser General
## Public License for more details.
##
## A copy of version 2.1 of the GNU Lesser General Public License is
## distributed with calc under the filename COPYING-LGPL.  You should have
## received a copy with calc; if not, write to Free Software Foundation, Inc.
## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
##
## @(#) $Revision: 30.1 $
## @(#) $Id: freopen,v 30.1 2007/03/16 11:10:42 chongo Exp $
## @(#) $Source: /usr/local/src/bin/calc/help/RCS/freopen,v $
##
## Under source code control:	1996/04/30 03:05:18
## File existed as early as:	1996
##
## chongo <was here> /\oo/\	http://www.isthe.com/chongo/
## Share and enjoy!  :-)	http://www.isthe.com/chongo/tech/comp/calc/
