file.getText( )

4D v18

file.getText( )

説明

file.getText( ) メソッドはファイルのコンテンツをテキストとして返します。

file オブジェクトで参照されているファイルはディスク上に存在してなければなりません。そうでない場合、エラーが生成されます。

charSet 引数には、コンテンツを読み出すのに使用する文字セットを渡します。標準の文字セットを含んだ文字列(“ISO-8859-1” または “UTF-8”など)またはそのMIBEnum ID(倍長整数)を渡すことができます。4D によってサポートされる文字セットの一覧の詳細な情報については、CONVERT FROM TEXT コマンドの説明を参照してください。

ドキュメントにバイトオーダーマーク(BOM)が含まれている場合、4D はcharSet 引数で設定されている文字セットではなく、BOMで指定されたものを使用します(結果としてcharSet 引数の方は無視されます)。

ドキュメントにBO が含まれておらず、またcharSet 引数も省略された場合、4D はデフォルトで“UTF-8” を文字セットとして使用します。

breakMode 引数には、ドキュメント内の改行文字に対して適用する処理を表す倍長整数を渡します。"System Documents" テーマ内の以下の定数を使用することができます:

定数	型	値	コメント
Document unchanged	倍長整数	0	何も処理をしません。
Document with native format	倍長整数	1	改行はOSのネイティブフォーマットに変換されます。Mac OS環境ではCR(キャリッジリターン)に、Windows環境ではCRLF(キャリッジリターン＋ラインフィード)に変換されます。(デフォルトの動作)
Document with CRLF	倍長整数	2	改行はWindowsフォーマット(CRLF、キャリッジリターン＋ラインフィード)へと変換されます。
Document with CR	倍長整数	3	改行は Mac OSフォーマット(CR、キャリッジリターン)へと変換されます。
Document with LF	倍長整数	4	改行はUnixフォーマット(LF、ラインフィード)へと変換されます。

breakMode 引数を省略した場合、デフォルトで、改行はネイティブモード(1) で処理されます。

返される値

ファイルのテキスト

例題

以下のテキストを持つドキュメントがある場合を考えます(フィールドはタブで区切られているものとします):

id name price vat
3 thé 1.06€ 19.6
2 café 1.05€ 19.6

以下のコードを実行すると:

 $myFile:=Folder(fk documents folder).file("Billing.txt") // デフォルトでUTF-8

 $txt:=$myFile.getText()

以下の結果を得ることができます:

  // $Text = "id name price vat\r\n3 thé 1.06€\t19.6\r\n2\tcafé\t1.05€\t19.6"

  // \t = タブ

  // \r = CR(キャリッジリターン)

参照

file.setText( )