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

String から作成される File オブジェクト。

注意事項

StringFile は読み取り専用で書き込みはできません。

プロパティ
parent-dir:self を含む Directory を返します。
アクセサ public StringFile.parent-dir:Directory
url:この File を識別する Url オブジェクトを返します。
アクセサ public StringFile.url:Url
when-last-accessed:該当する場合は最終アクセス日時を返し、そうでない場合は null を返します。
アクセサ public StringFile.when-last-accessed:#DateTime
when-last-modified:該当する場合は最終変更日時を返し、そうでない場合は null を返します。
アクセサ public StringFile.when-last-modified:#DateTime
プロパティ 継承 File: name

メソッド
append-open:追加する self を開きます。
public {StringFile.append-open
create?:bool = true,
create-mode:int = 0o666,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = 0
}:TextOutputStream
append-open-byte:バイト ストリームに追加する self を開きます。
public {StringFile.append-open-byte
create?:bool = true,
create-mode:int = 0o666,
buffer-size:int = 0
}:ByteOutputStream
clone:self の簡易コピーを返します。
public {StringFile.clone}:StringFile
object-describe-for-debugging:オブジェクトについて細部を記述します。これは主にデバッグ目的での使用が想定されています。
public {StringFile.object-describe-for-debugging
out:TextOutputStream,
locale:Locale
}:void
read-open:入力用の self を開きます。
public {StringFile.read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = 0,
unread-size:int = 0
}:TextInputStream
read-open-byte:バイト ストリーム入力用に self を開きます。
public {StringFile.read-open-byte
buffer-size:int = 0,
unread-size:int = 0
}:ByteInputStream
write-open:出力用に self を開きます。
public {StringFile.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 = 0
}:TextOutputStream
write-open-byte:バイト ストリーム出力用に self を開きます。
public {StringFile.write-open-byte
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
buffer-size:int = 0
}:ByteOutputStream
メソッド 継承 File: async-read-open, async-read-open-byte
メソッド 継承 Object: object-describe, object-serialize




プロパティ詳細
parent-dir (アクセサ)
アクセサ public StringFile.parent-dir:Directory

self を含む Directory を返します。


url (アクセサ)
アクセサ public StringFile.url:Url

この File を識別する Url オブジェクトを返します。


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

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


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

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





メソッド詳細
append-open (メソッド)
public {StringFile.append-open
create?:bool = true,
create-mode:int = 0o666,
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = 0
}: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 {StringFile.append-open-byte
create?:bool = true,
create-mode:int = 0o666,
buffer-size:int = 0
}:ByteOutputStream

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

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

戻り値

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

注意事項

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

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

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


object-describe-for-debugging (メソッド)
public {StringFile.object-describe-for-debugging
out:TextOutputStream,
locale:Locale
}:void

オブジェクトについて細部を記述します。これは主にデバッグ目的での使用が想定されています。

out: 文字が送られるストリーム。
locale: self の表示方法をコントロールする Locale。

説明

このメソッドは、一般に、"%y" フォーマット キーを使用して間接的に起動されます。"%y" フォーマット キーは、このメソッドによって生成された結果を、次のような何らかの型またはアドレス情報でラップします。
{do
    let buf:StringBuf = {StringBuf}
    {self.object-describe-for-debugging buf, {get-syntax-locale}}
    {format out = out, "[<type> @<addr> %s]", buf}
}
このメソッドの既定の実装では
{format out = out, "%w", self} を呼び出します。
(「%w」フォーマット キーの詳細については、format を参照してください)。
これが FormatFailedException を取得する場合、通常ユーザー定義のクラスのように、このメソッドは object-describe メソッドの呼び出しに戻ります。

read-open (メソッド)
public {StringFile.read-open
character-encoding:CharEncoding = CharEncoding.none-specified,
buffer-size:int = 0,
unread-size:int = 0
}: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 {StringFile.read-open-byte
buffer-size:int = 0,
unread-size:int = 0
}: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 {StringFile.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 = 0
}: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 {StringFile.write-open-byte
create?:bool = true,
create-mode:int = 0o666,
error-if-exists?:bool = false,
truncate-if-exists?:bool = true,
buffer-size:int = 0
}: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 も参照してください。