FileOutputStream (Java Platform SE 8)

java.lang.Object
- java.io.OutputStream
- - java.io.FileOutputStream

すべての実装されたインタフェース:

Closeable、Flushable、AutoCloseable
```
public class FileOutputStream
extends OutputStream
```
ファイル出力ストリームは、FileまたはFileDescriptorにデータを書き込むための出力ストリームです。ファイルが使用可能であるかどうか、またはファイルを作成できるかどうかは、ベースとなるプラットフォームによって決まります。特に、一部のプラットフォームでは、1つのファイルは同時に1つのFileOutputStream (またはその他のファイル書込みオブジェクト)だけによって書込みのために開くことができます。このような場合、該当のファイルがすでに開かれていると、このクラスのコンストラクタは失敗します。
FileOutputStreamは、イメージ・データなどのrawバイトのストリームを書き込むときに使用します。文字のストリームを書き込むときは、FileWriterを使用してください。

導入されたバージョン:

JDK1.0

関連項目:

File、FileDescriptor、FileInputStream、Files.newOutputStream(java.nio.file.Path, java.nio.file.OpenOption...)

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`FileOutputStream(File file)` 指定された`File`オブジェクトによって表されるファイルに書き込むためのファイル出力ストリームを作成します。
`FileOutputStream(File file, boolean append)` 指定された`File`オブジェクトによって表されるファイルに書き込むためのファイル出力ストリームを作成します。
`FileOutputStream(FileDescriptor fdObj)` ファイル・システムの実際のファイルへの既存の接続を表す、指定されたファイル記述子に書き込むためのファイル出力ストリームを作成します。
`FileOutputStream(String name)` 指定された名前のファイルに書き込むためのファイル出力ストリームを作成します。
`FileOutputStream(String name, boolean append)` 指定された名前のファイルに書き込むためのファイル出力ストリームを作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`void`	`close()` ファイル出力ストリームを閉じ、このストリームに関連するすべてのシステム・リソースを解放します。
`protected void`	`finalize()` ファイルへの接続をクリーンアップし、このストリームへの参照がなくなったときにこのファイル出力ストリームの`close`メソッドが呼び出されるようにします。
`FileChannel`	`getChannel()` このファイル出力ストリームに関連付けられている一意の`FileChannel`オブジェクトを返します。
`FileDescriptor`	`getFD()` ストリームに関連したファイル記述子を返します。
`void`	`write(byte[] b)` 指定されたバイト配列の`b.length`バイトをこのファイル出力ストリームに書き込みます。
`void`	`write(byte[] b, int off, int len)` 指定されたバイト配列のオフセット位置`off`から始まる`len`バイトをこのファイル出力ストリームに書き込みます。
`void`	`write(int b)` 指定されたバイトをこのファイル出力ストリームに書き込みます。

クラス java.io.OutputStreamから継承されたメソッド
flush

クラス java.lang.Objectから継承されたメソッド
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - FileOutputStream
```
public FileOutputStream(String name)
                 throws FileNotFoundException
```
    指定された名前のファイルに書き込むためのファイル出力ストリームを作成します。このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。
    まず、セキュリティ・マネージャが存在する場合は、checkWriteメソッドがnameをその引数に指定して呼び出されます。
    ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合は、FileNotFoundExceptionがスローされます。
    
    パラメータ:
    
    name - システムに依存するファイル名
    
    例外:
    
    FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckWriteメソッドがファイルへの書込みアクセスを拒否した場合。
    
    関連項目:
    
    SecurityManager.checkWrite(java.lang.String)
  - FileOutputStream
```
public FileOutputStream(String name,
                        boolean append)
                 throws FileNotFoundException
```
    指定された名前のファイルに書き込むためのファイル出力ストリームを作成します。2番目の引数がtrueの場合、バイトはファイルの先頭ではなく最後に書き込まれます。このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。
    まず、セキュリティ・マネージャが存在する場合は、checkWriteメソッドがnameをその引数に指定して呼び出されます。
    ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合は、FileNotFoundExceptionがスローされます。
    
    パラメータ:
    
    name - システム依存のファイル名
    
    append - trueの場合、バイトはファイルの先頭ではなく最後に書き込まれる
    
    例外:
    
    FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合。
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckWriteメソッドがファイルへの書込みアクセスを拒否した場合。
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    SecurityManager.checkWrite(java.lang.String)
  - FileOutputStream
```
public FileOutputStream(File file)
                 throws FileNotFoundException
```
    指定されたFileオブジェクトによって表されるファイルに書き込むためのファイル出力ストリームを作成します。このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。
    まず、セキュリティ・マネージャが存在する場合、checkWriteメソッドが、file引数で表されるパスをその引数に指定して呼び出されます。
    ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合は、FileNotFoundExceptionがスローされます。
    
    パラメータ:
    
    file - 書込み用に開かれるファイル。
    
    例外:
    
    FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckWriteメソッドがファイルへの書込みアクセスを拒否した場合。
    
    関連項目:
    
    File.getPath()、SecurityException, SecurityManager.checkWrite(java.lang.String)
  - FileOutputStream
```
public FileOutputStream(File file,
                        boolean append)
                 throws FileNotFoundException
```
    指定されたFileオブジェクトによって表されるファイルに書き込むためのファイル出力ストリームを作成します。2番目の引数がtrueの場合、バイトはファイルの先頭ではなく最後に書き込まれます。このファイル接続を表すために、新しいFileDescriptorオブジェクトが作成されます。
    まず、セキュリティ・マネージャが存在する場合、checkWriteメソッドが、file引数で表されるパスをその引数に指定して呼び出されます。
    ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合は、FileNotFoundExceptionがスローされます。
    
    パラメータ:
    
    file - 書込み用に開かれるファイル。
    
    append - trueの場合、バイトはファイルの先頭ではなく最後に書き込まれる
    
    例外:
    
    FileNotFoundException - ファイルが存在するが通常ファイルではなくディレクトリである場合、存在せず作成もできない場合、またはなんらかの理由で開くことができない場合
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckWriteメソッドがファイルへの書込みアクセスを拒否した場合。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    File.getPath()、SecurityException, SecurityManager.checkWrite(java.lang.String)
  - FileOutputStream
```
public FileOutputStream(FileDescriptor fdObj)
```
    ファイル・システムの実際のファイルへの既存の接続を表す、指定されたファイル記述子に書き込むためのファイル出力ストリームを作成します。
    まず、セキュリティ・マネージャが存在する場合、checkWriteメソッドが、ファイル記述子fdObj引数を引数として呼び出されます。
    fdObjがnullの場合、NullPointerExceptionがスローされます。
    fdObjがinvalidの場合、このコンストラクタは例外をスローしません。ただし、結果となるストリームに対してそのストリームへの入出力を試みるメソッドが呼び出された場合は、IOExceptionがスローされます。
    
    パラメータ:
    
    fdObj - 書込みのために開かれるファイル記述子
    
    例外:
    
    SecurityException - セキュリティ・マネージャが存在し、そのcheckWriteメソッドがファイル記述子への書込みアクセスを拒否した場合
    
    関連項目:
    
    SecurityManager.checkWrite(java.io.FileDescriptor)
- メソッドの詳細
  - write
```
public void write(int b)
           throws IOException
```
    指定されたバイトをこのファイル出力ストリームに書き込みます。OutputStreamのwriteメソッドを実装します。
    
    定義:
    
    write、クラス: OutputStream
    
    パラメータ:
    
    b - 書き込まれるバイト。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - write
```
public void write(byte[] b)
           throws IOException
```
    指定されたバイト配列のb.lengthバイトをこのファイル出力ストリームに書き込みます。
    
    オーバーライド:
    
    write、クラス: OutputStream
    
    パラメータ:
    
    b - データ。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    OutputStream.write(byte[], int, int)
  - write
```
public void write(byte[] b,
                  int off,
                  int len)
           throws IOException
```
    指定されたバイト配列のオフセット位置offから始まるlenバイトをこのファイル出力ストリームに書き込みます。
    
    オーバーライド:
    
    write、クラス: OutputStream
    
    パラメータ:
    
    b - データ。
    
    off - データの開始オフセット。
    
    len - 書き込むバイト数。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - close
```
public void close()
           throws IOException
```
    ファイル出力ストリームを閉じ、このストリームに関連するすべてのシステム・リソースを解放します。以降は、このファイル出力ストリームをバイトの書込みに使用することはできません。
    このストリームにチャネルが関連付けられている場合は、そのチャネルも閉じます。
    
    定義:
    
    close、インタフェース: Closeable
    
    定義:
    
    close、インタフェース: AutoCloseable
    
    オーバーライド:
    
    close、クラス: OutputStream
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
  - getFD
```
public final FileDescriptor getFD()
                           throws IOException
```
    ストリームに関連したファイル記述子を返します。
    
    戻り値:
    
    このFileOutputStreamオブジェクトによって使用されているファイル・システムのファイルへの接続を表すFileDescriptorオブジェクト。
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    FileDescriptor
  - getChannel
```
public FileChannel getChannel()
```
    このファイル出力ストリームに関連付けられている一意のFileChannelオブジェクトを返します。
    返されるチャネルの初期positionは、それまでにファイルに書き込まれたバイト数と等しくなります。このストリームが追加モードの場合は、ファイルのサイズと等しくなります。このストリームにバイトを書き込むたびにチャネルの位置が増分されます。チャネルの位置が明示的に変更された場合、または書き込みよって変更された場合は、このストリームのファイル位置が変更されます。
    
    戻り値:
    
    このファイル出力ストリームに関連付けられているファイル・チャネル
    
    導入されたバージョン:
    
    1.4
  - finalize
```
protected void finalize()
                 throws IOException
```
    ファイルへの接続をクリーンアップし、このストリームへの参照がなくなったときにこのファイル出力ストリームのcloseメソッドが呼び出されるようにします。
    
    オーバーライド:
    
    finalize、クラス: Object
    
    例外:
    
    IOException - 入出力エラーが発生した場合。
    
    関連項目:
    
    FileInputStream.close()

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスFileOutputStream

コンストラクタのサマリー

メソッドのサマリー

クラス java.io.OutputStreamから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

コンストラクタの詳細

FileOutputStream

FileOutputStream

FileOutputStream

FileOutputStream

FileOutputStream

メソッドの詳細

write

write

write

close

getFD

getChannel

finalize