LocalFile (クラス)
public LocalFile {inherits File}
パッケージ： CURL.IO.FILE

ローカル ファイルシステムに存在する File。


コンストラクタ
clone-from:LocalFile を初期化します。
コンストラクタ public {LocalFile.clone-from from:LocalFile}

プロパティ
exists?:self で表されるファイルが基礎となるファイルシステムに実際に存在するどうかを示します。
アクセサ public LocalFile.exists?:bool
readable?:self で表されるオブジェクトを読み込み用に開くことができるかどうかを示します。
アクセサ public LocalFile.readable?:bool
url:このファイルの名前。
アクセサ public final inline LocalFile.url:Url
when-last-accessed:該当する場合は最終アクセス日時を返し、そうでない場合は null を返します。
アクセサ public LocalFile.when-last-accessed:#DateTime
when-last-modified:該当する場合は最終変更日時を返し、そうでない場合は null を返します。
アクセサ public LocalFile.when-last-modified:#DateTime
writable?:self で表されるファイルを書き込み用に開くことができるかどうかを示します。
アクセサ public LocalFile.writable?:bool
プロパティ 継承 File: name, parent-dir

メソッド
append-open:追加する self を開きます。
public {LocalFile.append-open
create?:bool = true,
create-mode:int = 0o666,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:TextOutputStream
append-open-byte:バイト ストリームに追加する self を開きます。
public {LocalFile.append-open-byte
create?:bool = true,
create-mode:int = 0o666,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream
async-read-open:テキスト入力用に self を非同期に開き、開いた TextInputStream または例外を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。
public {LocalFile.async-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener
async-read-open-byte:バイト入力用に self を非同期に開き、開いた ByteInputStream または例外を含む AsyncFileOpenEvent に対するイベント ハンドラを呼び出します。
public {LocalFile.async-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener
clone:self の簡易コピーを返します。
public {LocalFile.clone}:LocalFile
info:LocalFileInfo オブジェクトを返します。このオブジェクトにより、File の詳細情報にアクセスできます。
public {LocalFile.info
snap-symlink?:bool = true,
error-if-missing?:bool = true
}:#LocalFileInfo
read-open:入力用の self を開きます。
public {LocalFile.read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4}
}:TextInputStream
read-open-byte:バイト ストリーム入力用に self を開きます。
public {LocalFile.read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4}
}:ByteInputStream
write-open:出力用に self を開きます。
public {LocalFile.write-open
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:TextOutputStream
write-open-byte:バイト ストリーム出力用に self を開きます。
public {LocalFile.write-open-byte
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream
メソッド 継承 Object: object-describe, object-describe-for-debugging, object-serialize



コンストラクタ詳細
clone-from (コンストラクタ)
public {LocalFile.clone-from from:LocalFile}

LocalFile を初期化します。

from: self の名前は、from からコピーされます。


プロパティ詳細
exists? (アクセサ)
アクセサ public LocalFile.exists?:bool

self で表されるファイルが基礎となるファイルシステムに実際に存在するどうかを示します。

戻り値

ファイルが存在するどうかを示す bool。

説明

返される値は、self への今後の操作が何らかの形で成功または失敗することを保証するものではありません。多くの要因 (ファイルの種類、アクセス権の問題、プラットフォーム制限など) のため、完璧な正確さを確約することはできません。さらに実装では、結果の正確さを抑制してパフォーマンスを向上させることができます。

readable? (アクセサ)
アクセサ public LocalFile.readable?:bool

self で表されるオブジェクトを読み込み用に開くことができるかどうかを示します。

戻り値

オブジェクトが読み込み可能かどうかを示す bool。

説明

返される値は、self への今後の操作が何らかの形で成功または失敗することを保証するものではありません。多くの要因 (ファイルの種類、アクセス権の問題、プラットフォーム制限など) のため、完璧な正確さを確約することはできません。さらに実装では、結果の正確さを抑制してパフォーマンスを向上させることができます。

url (アクセサ)
アクセサ public final inline LocalFile.url:Url

このファイルの名前。


when-last-accessed (アクセサ)
アクセサ public LocalFile.when-last-accessed:#DateTime

該当する場合は最終アクセス日時を返し、そうでない場合は null を返します。


when-last-modified (アクセサ)
アクセサ public LocalFile.when-last-modified:#DateTime

該当する場合は最終変更日時を返し、そうでない場合は null を返します。


writable? (アクセサ)
アクセサ public LocalFile.writable?:bool

self で表されるファイルを書き込み用に開くことができるかどうかを示します。

戻り値

ファイルが書き込み可能かどうかを示す bool。

説明

返される値は、self への今後の操作が何らかの形で成功または失敗することを保証するものではありません。多くの要因 (ファイルの種類、アクセス権の問題、プラットフォーム制限など) のため、完璧な正確さを確約することはできません。さらに実装では、結果の正確さを抑制してパフォーマンスを向上させることができます。




メソッド詳細
append-open (メソッド)
public {LocalFile.append-open
create?:bool = true,
create-mode:int = 0o666,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:TextOutputStream

追加する self を開きます。

create?: true (既定値) の場合、基礎となるファイルがまだ存在しなければ、それを作成することを意味します。
create-mode: 作成された場合にファイルに割り当てられるアクセス権を示します。現在、UNIX システムでは、この引数は open() と mkdir() の呼び出しに単に直接パスされます。UNIX システムでは、最終のファイルプロテクションを実行するため create-mode は umask によって変更されます。
character-encoding: ファイルへの書き込みで使用する文字エンコーディングを示します。CharEncoding を参照してください。指定しない場合、文字エンコーディングは File.read-open などで決定されます。
buffer-size: バッファに格納される char の最小数。buffer-size が 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。

戻り値

このメソッドが開く TextOutputStream を返します。

注意事項

通常、このメソッドが返す TextOutputStream でのシークは失敗します。

注意事項

返されるストリームは、いかなる改行処理も実行しません。改行処理が必要な場合は、NewlineFilterTextOutputStream または SeekableNewlineFilterTextOutputStream を使い、返されるストリームを改行することができます。

append-open-byte (メソッド)
public {LocalFile.append-open-byte
create?:bool = true,
create-mode:int = 0o666,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream

バイト ストリームに追加する self を開きます。

create?: true (既定値) の場合、基礎となるファイルがまだ存在しなければ、それを作成することを意味します。
create-mode: 作成された場合にファイルに割り当てられるアクセス権を示します。現在、UNIX システムでは、この引数は open() と mkdir() の呼び出しに単に直接パスされます。UNIX システムでは、最終のファイルプロテクションを実行するため create-mode は umask によって変更されます。
buffer-size: バッファに格納される char の最小数。buffer-size が 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。0 でない場合、BufferedByteOutputStream が返されます。

戻り値

このメソッドが開く ByteOutputStream を返します。

注意事項

通常、このメソッドが返す ByteOutputStream でのシークは失敗します。

async-read-open (メソッド)
public {LocalFile.async-read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener

テキスト入力用に self を非同期に開き、開いた TextInputStream または例外を含む AsyncFileOpenEvent で指定されたイベント ハンドラを呼び出します。

character-encoding: ファイルの読み込みで使用する文字エンコーディングを示します。CharEncoding を参照してください。指定されない場合、可能であれば文字エンコーディングはストリーム内の最初の数バイトから解釈されます。このような解釈ができない場合、既定の CharEncoding.utf8 エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
unread-size: 効果的に読み取り不可能な char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
event-handler: AsyncFileOpenEvent を受け取る EventHandler。少なくとも 1 つを指定する必要があります。
...: AsyncFileOpenEvent を受け取るオプションの EventHandler。

戻り値

非同期オープンを制御できる AsyncFileOpener を返します。

async-read-open-byte (メソッド)
public {LocalFile.async-read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4},
event-handler:EventHandler,
...:EventHandler
}:AsyncFileOpener

バイト入力用に self を非同期に開き、開いた ByteInputStream または例外を含む AsyncFileOpenEvent に対するイベント ハンドラを呼び出します。

buffer-size: バッファに格納される char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteInputStream が作成されます。
unread-size: 効率よく読み込むことができない char の最小数。buffer-size と unread-size がどちらも 0 の場合、できるだけバッファに格納されないストリームの作成を試みます。一方が 0 でない場合には BufferedByteInputStream が作成されます。
event-handler: AsyncFileOpenEvent を受け取る EventHandler。少なくとも 1 つを指定する必要があります。
...: AsyncFileOpenEvent を受け取るオプションの EventHandler。

戻り値

非同期オープンを制御できる AsyncFileOpener を返します。

clone (メソッド)
public {LocalFile.clone}:LocalFile

self の簡易コピーを返します。


info (メソッド)
public {LocalFile.info
snap-symlink?:bool = true,
error-if-missing?:bool = true
}:#LocalFileInfo

LocalFileInfo オブジェクトを返します。このオブジェクトにより、File の詳細情報にアクセスできます。

snap-symlink?: true の場合は、LocalFileInfo オブジェクトを作成する前にファイルのパス内のシンボリック リンクを解決します。
error-if-missing?: true の場合は、File オブジェクトがファイルシステム内に存在するファイルを表していなければ、MissingFileException がスローされます。

read-open (メソッド)
public {LocalFile.read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, char },
unread-size:int = {min 4, buffer-size div 4}
}:TextInputStream

入力用の self を開きます。

character-encoding: ファイルの読み込みで使用する文字エンコーディングを示します。CharEncoding を参照してください。指定されない場合、可能であれば文字エンコーディングはストリーム内の最初の数バイトから解釈されます。このような解釈ができない場合、既定の CharEncoding.utf8 エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。
unread-size: 効果的に読み取り不可能な char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。

戻り値

このメソッドがオープンする TextInputStream を返します。

注意事項

返されるストリームは、いかなる改行処理も実行しません。改行処理が必要な場合は、NewlineFilterTextInputStream または SeekableNewlineFilterTextInputStream を使い、返されるストリームを改行することができます。

read-open-byte (メソッド)
public {LocalFile.read-open-byte
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte },
unread-size:int = {min 4, buffer-size div 4}
}:ByteInputStream

バイト ストリーム入力用に self を開きます。

buffer-size: バッファに格納される char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteInputStream が返されます。
unread-size: 効率よく読み込むことができない char の最小数。buffer-size と unread-size がどちらも 0 の場合は、できるだけバッファに格納されないストリームの作成を試みます。一方が 0 でない場合には BufferedByteInputStream が返されます。

戻り値

このメソッドがオープンする ByteInputStream を返します。

write-open (メソッド)
public {LocalFile.write-open
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:TextOutputStream

出力用に self を開きます。

create?: true (既定値) の場合、基礎となるファイルがまだ存在しなければ、それを作成することを意味します。
create-mode: 作成された場合にファイルに割り当てられるアクセス権を示します。現在、UNIX システムでは、この引数は open() と mkdir() の呼び出しに単に直接パスされます。UNIX システムでは、最終のファイルプロテクションを実行するため create-mode は umask によって変更されます。
error-if-exists?: true の場合、開こうとしているファイルがすでに存在すればこのメソッドで ExistingFileException がスローされます。
truncate-if-exists?: true (既定値) の場合、元のファイルが既に存在すれば内容は削除されることを示します。false の場合、ファイル内容は削除されず、データは現在の場所からファイルに書き込まれます。最初の場所は常にファイルの始点です。
character-encoding: ファイルへの書き込みに使用するエンコーディングを示します。CharEncoding を参照してください。指定しない場合は、既定の CharEncoding.utf8 エンコーディングが使用されます。
buffer-size: バッファに格納される char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。

戻り値

このメソッドが開く TextOutputStream を返します。

注意事項

create? = false と error-if-exists? = true を同時に指定しても意味がありません。

注意事項

File.append-open も参照してください。

注意事項

返されるストリームは、いかなる改行処理も実行しません。改行処理が必要な場合は、NewlineFilterTextOutputStream または SeekableNewlineFilterTextOutputStream を使い、返されるストリームを改行することができます。

write-open-byte (メソッド)
public {LocalFile.write-open-byte
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
buffer-size:int = {calculate-instances-per-memory-size default-buffer-memory-size, byte }
}:ByteOutputStream

バイト ストリーム出力用に self を開きます。

create?: true (既定値) の場合、基礎となるファイルがまだ存在しなければ、それを作成することを意味します。
create-mode: 作成された場合にファイルに割り当てられるアクセス権を示します。現在、UNIX システムでは、この引数は open() と mkdir() の呼び出しに単に直接パスされます。UNIX システムでは、最終のファイルプロテクションを実行するため create-mode は umask によって変更されます。
error-if-exists?: true の場合、開こうとしているファイルがすでに存在すればこのメソッドで ExistingFileException がスローされます。
truncate-if-exists?: true (既定値) の場合、元のファイルが既に存在すれば内容は削除されることを示します。false の場合、ファイル内容は削除されず、データは現在の場所からファイルに書き込まれます。最初の場所は常にファイルの始点です。
buffer-size: バッファに格納される char の最小数。buffer-size と unread-size がどちらも 0 の場合、アンバッファ ストリームの作成が可能であればこれを行います。どちらも 0 でない場合、BufferedByteOutputStream が返されます。

戻り値

このメソッドが開く ByteOutputStream を返します。

注意事項

create? = false と error-if-exists? = true を同時に指定しても意味がありません。

注意事項

File.append-open-byte も参照してください。