From 477946a63dee474c725243ae0d998f4cba1bfc0a Mon Sep 17 00:00:00 2001 From: Mark Wielaard Date: Mon, 1 Oct 2001 18:24:54 +0000 Subject: FileWriter.java: Merge with Classpath. * java/io/FileWriter.java: Merge with Classpath. * java/io/FilterInputStream.java: Ditto. (mark): no longer synchronized (reset): Likewise * java/io/FilterOutputStream.java: Merge with Classpath. * java/io/FilterReader.java: Ditto. (mark): no longer synchronized (reset): Likewise * java/io/FilterWriter.java: Merge with Classpath. * java/io/Writer.java: Ditto. * java/lang/Compiler.java: Ditto. * java/lang/Process.java: Ditto. * java/lang/Void.java: Ditto. * java/net/ContentHandler.java: Ditto. * java/net/DatagramPacket.java: Ditto. * java/net/MulticastSocket.java: Merge comments with Classpath. From-SVN: r45930 --- libjava/java/io/FileWriter.java | 142 +++++++++++++++++++++++++++++++--------- 1 file changed, 112 insertions(+), 30 deletions(-) (limited to 'libjava/java/io/FileWriter.java') diff --git a/libjava/java/io/FileWriter.java b/libjava/java/io/FileWriter.java index 5c49e5f853d..53e36589f69 100644 --- a/libjava/java/io/FileWriter.java +++ b/libjava/java/io/FileWriter.java @@ -1,44 +1,126 @@ -// FileWriter.java - Character output to a file. +/* FileWriter.java -- Convenience class for writing to files. + Copyright (C) 1998, 1999, 2001 Free Software Foundation, Inc. -/* Copyright (C) 1998, 1999 Free Software Foundation +This file is part of GNU Classpath. - This file is part of libgcj. +GNU Classpath is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2, or (at your option) +any later version. + +GNU Classpath 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 +General Public License for more details. -This software is copyrighted work licensed under the terms of the -Libgcj License. Please consult the file "LIBGCJ_LICENSE" for -details. */ +You should have received a copy of the GNU General Public License +along with GNU Classpath; see the file COPYING. If not, write to the +Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA +02111-1307 USA. -package java.io; +As a special exception, if you link this library with other files to +produce an executable, this library does not by itself cause the +resulting executable to be covered by the GNU General Public License. +This exception does not however invalidate any other reasons why the +executable file might be covered by the GNU General Public License. */ -/** - * @author Tom Tromey - * @date September 25, 1998 - */ + +package java.io; /* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3 * "The Java Language Specification", ISBN 0-201-63451-1 * Status: Complete to version 1.1. */ +/** + * This is a convenience class for writing to files. It creates an + * FileOutputStream and initializes an + * OutputStreamWriter to write to it. + * + * @author Aaron M. Renn (arenn@urbanophile.com) + * @author Tom Tromey + */ public class FileWriter extends OutputStreamWriter { - public FileWriter (String fileName) throws IOException - { - super (new FileOutputStream (fileName)); - } - - public FileWriter (String fileName, boolean append) throws IOException - { - super (new FileOutputStream (fileName, append)); - } - - public FileWriter (File file) throws IOException - { - super (new FileOutputStream (file)); - } - - public FileWriter (FileDescriptor fd) - { - super (new FileOutputStream (fd)); - } + +/*************************************************************************/ + +/* + * Constructors + */ + +/** + * This method initializes a new FileWriter object to write + * to the specified File object. + * + * @param file The File object to write to. + * + * @param SecurityException If writing to this file is forbidden by the + * SecurityManager. + * @param IOException If any other error occurs + */ +public +FileWriter(File file) throws SecurityException, IOException +{ + super(new FileOutputStream(file)); +} + +/*************************************************************************/ + +/** + * This method initializes a new FileWriter object to write + * to the specified FileDescriptor object. + * + * @param fd The FileDescriptor object to write to + * + * @param SecurityException If writing to this file is forbidden by the + * SecurityManager. + */ +public +FileWriter(FileDescriptor fd) throws SecurityException +{ + super(new FileOutputStream(fd)); +} + +/*************************************************************************/ + +/** + * This method intializes a new FileWriter object to write to the + * specified named file. + * + * @param name The name of the file to write to + * + * @param SecurityException If writing to this file is forbidden by the + * SecurityManager. + * @param IOException If any other error occurs + */ +public +FileWriter(String name) throws IOException +{ + super(new FileOutputStream(name)); } + +/*************************************************************************/ + +/** + * This method intializes a new FileWriter object to write to the + * specified named file. This form of the constructor allows the caller + * to determin whether data should be written starting at the beginning or + * the end of the file. + * + * @param name The name of the file to write to + * @param append true to start adding data at the end of the + * file, false otherwise. + * + * @param SecurityException If writing to this file is forbidden by the + * SecurityManager. + * @param IOException If any other error occurs + */ +public +FileWriter(String name, boolean append) throws IOException +{ + super(new FileOutputStream(name, append)); +} + +} // class FileWriter + -- cgit v1.2.3