file.setText( )

4D v19.8

file.setText( )


file.setText ( text {; charSet {; breakMode}} )

引数	型	説明
text	テキスト	ファイルに保存するテキスト
charSet	テキスト, 倍長整数	文字セットの名前または番号
breakMode	倍長整数	改行の処理モード

説明

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

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

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

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

breakMode 引数には、ファイルを保存する前に改行文字として適用する文字を指定する倍長整数を渡します。"System Documents" テーマ内にある、以下の定数を使用することができます:

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

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

例題

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

 $myFile.setText("Hello world")

参照

file.getText( )