open (Stream - Java™)

定義位置

Stream

構文

public boolean open(String pathname)
    throws NotesException
public boolean open(String pathname, String charset)
    throws NotesException

パラメータ

String pathname

ファイルの絶対パス名。現在のプラットフォームで有効でなければなりません。

String charset

ファイルによって使用される文字セットです。 ファイルの内容を記述する文字セットです。 デフォルトでは「System」に設定されます。

戻り値

boolean 型

• ファイルが正常に開かれた場合は true。
• ファイルを開くことができなかった場合は false。「使用法」を参照してください。

使用法

このメソッドは、ファイルが存在しない場合はファイルを作成します。

ストリームを開くときのプロパティ値は次のとおりです。

• Bytes は、新規ファイルでは 0 であり、既存ファイルの場合はファイルのバイト数です。
• Charset は、指定した文字セットです。
• IsEOS は、ストリームが空の場合は true であり、その他の場合は false です。
• IsReadOnly は、ファイルが読み込み専用の場合は true であり、ファイルが読み書き可能な場合は false です。
• Position は 0

ストリームの処理が終了した場合は、Close を呼び出すことが推奨されます。

有効な文字セットには、ASCII、 Big5、Binary、EUC-JP、EUC-KR、EUC-TW、GF2312、ISO-2022-JP、ISO-2022-KR、 ISO-8859-1 から ISO-8859-9、ISO-8859-15、KOI8-R、Latin4、Shift-JIS、 System、TCVN3、Unicode、Unicode-1-1、US-ASCII、UTF-7、UTF-8、UTF-16、 UTF-16BE、UTF-16LE、Windows-1250 から Windows-1258、Windows-874 があります。 Binary では、ストリームにおけるバイト演算のみが暗黙指定されます。 Unicode は UTF-16 と同じであり、Unicode-1-1 は UTF-16 の互換性のあるサブセットです。

次の場合、このメソッドは失敗します。

• パス名が有効ではない場合
• ストリームがすでに開いている場合
• ストリームに内容がある場合
• charset パラメータが有効な文字セットでない場合。

クロスリファレンス

LotusScript® NotesStream クラスの Open メソッド

例