file.setText( )

4D v19

file.setText( )

説明

file.setText( ) メソッドは、text 引数に渡されたテキストをファイルの新しいコンテンツとして書き込みます。

File オブジェクトで参照されているファイルがディスク上に存在しない場合、このメソッドがそのファイルを作成します。ファイルが既にディスク上に存在する場合、ファイルが既に開かれている場合を除き、以前のコンテンツは消去されます。ファイルが開かれていた場合はコンテンツはロックされ、エラーが生成されます。

text 引数には、ファイルに書き込むテキストを渡します。実際のテキスト("my text"など)、あるいは4D テキストフィールドまたは変数なども渡せます。

charSet 引数には、コンテンツを書き込むのに使用する文字セットを渡します。この引数には標準の文字セット名を含んだ文字列(“ISO-8859-1” や “UTF-8” など)、またはそれらのMIBEum ID(倍長整数)を渡すことができます。4D によってサポートされている文字セットについての一覧については、CONVERT FROM TEXT コマンドの説明を参照して下さい。文字セットのためにバイトオーダーマーク(BOM)が存在する場合、4D はそれもファイルに挿入します。文字セットを指定しない場合、デフォルトで4D は"UTF-8" の文字セットとBOMを使用します。

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) で処理されます。

例題

 $myFile:=File("C:\\Documents\\Hello.txt";fk platform path)

 $myFile.setText("Hello world")

参照

file.getText( )