4D v14.3

TEXT TO DOCUMENT

ホーム

 
4D v14.3
TEXT TO DOCUMENT

TEXT TO DOCUMENT 


 

TEXT TO DOCUMENT ( fileName ; text {; charSet {; breakMode}} )  
引数   説明
fileName  文字 in ドキュメント名またはドキュメントへのパス名
text  テキスト in ドキュメントに保存するテキスト
charSet  テキスト, 倍長整数 in 文字コードの名前または数字
breakMode  倍長整数 in 改行の処理モード

説明   

TEXT TO DOCUMENTコマンドは、 text を直接ディスク上のファイルへと書き込みます。

fileName,引数には書き込みたいファイルへのパス名を渡します。ファイルが存在しない場合には新たに作成されます。このファイルが既にディスク上に存在する場合、以前の内容は消去されます。ただし既に開かれていた場合にはその中身はロックされエラーが静背されます。fileName に渡せるものは以下の通りです:

  • ファイル名のみ。例えば "myFile.txt" など。この場合、ファイルはアプリケーションのストラクチャーファイルの隣にある必要があります。
  • アプリケーションのストラクチャファイルからの相対パス。例えばWindowsでは "\\docs\\myFile.txt" またはOS Xでは ":docs:myFile.txt"
  • 絶対パス。例えばWindowsでは "c:\\app\\docs\\myFile.txt" またはOS Xでは "MacHD:docs:myFile.txt"

ユーザーにドキュメントの名前や場所を指定することを可能にしたい場合は、 Open document コマンドまたは Create document コマンドに加え、 Documentシステム変数を使用して下さい。

Note: デフォルトでは、このコマンドによって生成されたドキュメントは拡張子を持ちません。拡張子は fileName 内に含める必要があります。 SET DOCUMENT TYPEコマンドを使用することもできます。

text 引数には、ディスクに書き込みたいテキストを渡します。文字の定数("my text")を渡す事もできますし、4D テキストフィールドまたは変数を渡す事もできます。

charSet 引数には、ドキュメントに書き込む際の文字コードを渡します。標準の文字コード名(例えば“ISO-8859-1” や “UTF-8”)を渡す事もできますし、文字コードの MIBEnum ID (倍長整数)を渡す事もできます。4Dによってサポートされている文字コードの一覧の詳細な情報に関しては、CONVERT FROM TEXT コマンドの詳細を参照して下さい。文字コードに対してバイトオーダーマーク(BOM)が存在している場合、4Dはそれをドキュメント内に挿入します。文字コードを

charSet 引数で指定された文字コードのかわりにバイトオーダーマークが指定した文字コードを使用します(つまり、この引数は無視されます)。文字コードを指定しなかった場合、4Dはデフォルトで "UTF_8"文字コードをBOMとともに使用します。

breakMode 引数には、ドキュメントの改行文字の処理を指示する倍長整数を渡します。 "System Documents"テーマ内にある、以下の定数のどれかを渡すことが出きます。

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

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

Note: このコマンドはOK変数を変更しません。失敗した場合には ON ERR CALL コマンドによって実装されたメソッドを使用することによって割り込み可能なエラーが生成されます。

このコマンドの典型的な使用例:

 TEXT TO DOCUMENT("myTest.txt";"This is a test")
 TEXT TO DOCUMENT("myTest.xml";"This is a test")

ユーザーがファイルを作成する場所を指示できる例:

 $MyTextVar:="This is a test"
 ON ERR CALL("IO ERROR HANDLER")
 $vhDocRef :=Create document("")
  // ドキュメントを ".txt" 拡張子で保存
  // この場合、 .txt拡張子は必ずファイル名に追加され、変更することはできません。
 If(OK=1) // ドキュメントが正常に作成された場合、
    CLOSE DOCUMENT($vhDocRef//ドキュメントを閉じる
    TEXT TO DOCUMENT(Document;$MyTextVar )
  // ドキュメントに書き込みが行われます
 Else
  // エラー管理
 End ifi

 
プロパティ 

プロダクト: 4D
テーマ: システムドキュメント
番号: 1237

 
履歴 

New
初出: 4D v14

 
参照 

Document to text
System Documents

 
ARTICLE USAGE

ランゲージリファレンス ( 4D v14 R3)
ランゲージリファレンス ( 4D v14 R2)
ランゲージリファレンス ( 4D v14.3)
ランゲージリファレンス ( 4D v14 R4)