File

4D v18

File


File ( path \| 4Dfile {; pathType \| *} ) -> 戻り値

引数	型	説明
path \| 4Dfile	テキスト, 倍長整数	ファイルパスまたは4Dファイル定数
pathType \| *	倍長整数, 演算子	path 指定時: fk posix path (デフォルト) または fk platform path 4Dfile 指定時: ホストデータベースのファイルを返すには* を渡す
戻り値	Object	新規ファイルオブジェクト

説明

File コマンドはFile 型の新しいオブジェクトを作成して返します。このコマンドは二種類のシンタックスを受け入れます。

File (path{; pathType})

path 引数には、ファイルパス文字列を渡します。カスタムの文字列やfilesystem (例: "/DATA/myfile.txt")を渡すことができます。

注: File コマンドでは絶対パス名のみがサポートされます。詳細な情報については、ファイルおよびフォルダオブジェクトパス名のページを参照してください。

デフォルトで、4D はPOSIX シンタックスで表現されたパスを期待します。プラットフォームパス名(Windows またはmacOS)を使用した場合、pathType 引数を使用してそのことを宣言する必要があります。File and Folder 定数テーマ内の以下の定数を使用することができます:

定数	型	値	コメント
fk platform path	倍長整数	1	プラットフォーム特有のシンタックスで表現されたパス(プラットフォームパス名の場合には必須)
fk posix path	倍長整数	0	POSIX シンタックスで表現されたパス(デフォルト)

File (4Dfile{; *})

4Dfile 引数には、以下の定数のどれか一つを使用して4D ビルトインの、またはシステムファイルを渡します:

定数	値	コメント
Backup history file	19	バックアップ保存先フォルダに保存されているバックアップ履歴ファイル(バックアップジャーナル参照)。
Backup log file	13	カレントのバックアップのログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。ログファイルが作成されていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。
Backup settings file	1	データベースの Settings フォルダーにある、デフォルトの backup.4DSettings ファイル (xml 形式)
Backup settings file for data	17	データフォルダーの Settings フォルダーにある、backup.4DSettings ファイル (xml 形式)
Build application log file	14	アプリケーションビルダーのカレントのログファイル(xmlフォーマット)。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。ログファイルが作成されていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。
Build application settings file	20	データベースの Settings フォルダーに保存された、アプリケーションビルダーのデフォルト設定ファイル ("buildApp.4DSettings")。
Compacting log file	6	Compact data file コマンドによって、あるいはメンテナンス&セキュリティセンター(MSC)によって作成された、直近の圧縮のログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。ログファイルが作成されていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。
Current backup settings file	18	アプリケーションが現在使用している backup.4DSettings ファイル。使用されるのはデフォルトのバックアップ設定ファイル、または、データファイル用のユーザーバックアップ設定ファイルです。
Debug log file	12	SET DATABASE PARAMETER(Debug log recording) コマンドによって作成されたログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。デバッグログファイルが作成されていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。
Diagnostic log file	11	SET DATABASE PARAMETER(Diagnostic log recording) コマンドによって作成されたログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。診断が実行されていない、あるいはログファイルが存在しない場合には空のパスが返されます。エラーは生成されません。
Directory file	16	プロジェクトデータベースにおいて、ユーザーとグループ (あれば) の定義が格納された directory.json ファイル。このファイルは、データベースの user settings フォルダー (デフォルト、プロジェクトに対してグローバル)、または data settings フォルダー (データファイル専用) に保管されます。
HTTP debug log file	9	WEB SET OPTION(Web debug log) コマンドによって作成されたログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。デバッグログファイルが作成されていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。
HTTP log file	8	WEB SET OPTION(Web log recording) コマンドによって作成されたログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。ログファイルが作成されていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。
Last backup file	2	任意の場所に格納されている、最終バックアップファイル (名称は: <databaseName>[bkpNum].4BK)
Repair log file	7	メンテナンス&セキュリティセンター(MSC)内からデータベースに対して行われたデータベース修復のログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。修復オペレーションが実行されていない、あるいはログファイルが存在しない場合には空のパスが返されます。エラーは生成されません。
Request log file	10	SET DATABASE PARAMETER(4D Server log recording) あるいは SET DATABASE PARAMETER(Client log recording) コマンドによって作成された標準のクライアント/サーバーログファイル(Webリクエストは除かれます)。サーバー上で実行された場合にはサーバーログが返されます(ログファイルはサーバー上のLogsフォルダーに保存されています)。クライアントで実行された場合にはクライアントのログが返されます(ログファイルはクライアントのLogsフォルダーに保存されています)。
SMTP log file	15	SET DATABASE PARAMETER(SMTP Log) コマンドによって作成されたログファイル。データベースのストラクチャーファイルと隣に保存されます。SMTP ログファイルが作成されていない、あるいは存在しない場合、空のパスが返されます。エラーは発生しません。
User settings file	3	設定が有効化されている場合、データベースストラクチャーファイルと同じ場所にある Preferences フォルダーに格納された、全データファイルの settings.4DSettings ファイル
User settings file for data	4	データファイルと同じ場所にある Preferences フォルダーに格納された、カレントデータファイルの settings.4DSettings ファイル。
Verification log file	5	VERIFY CURRENT DATA FILE および VERIFY DATA FILE コマンドによって、あるいはメンテナンス&セキュリティセンター(MSC)によって作成されたログファイル。データベースのストラクチャーファイルのとなりにあるLogsフォルダに保存されています。検証がなされていない、あるいは存在しない場合には空のパスが返されます。エラーは生成されません。