入出力定数 | MQL5リファレンス

ファイルを開く際のフラグ

ファイルを開く際のフラグはファイルのアクセスモードを指定します。フラグは下記の様に定義されます。

識別子	値	説明
FILE_READ	1	ファイルは読み込むために開かれます。フラグは FileOpen() で使用されます。ファイルを開く際には FILE_WRITE 及び/または FILE_READ 仕様が必要です。
FILE_WRITE	2	ファイルは書き込むために開かれます。フラグは FileOpen() で使用されます。ファイルを開く際には FILE_WRITE 及び/または FILE_READ 仕様が必要です。
FILE_BIN	4	（文字列への変換文字列を含まない）バイナリ読み込み/書き込みモードです。フラグは FileOpen() で使用されます。
FILE_CSV	8	CSV ファイル（全ての要素が Unicode または ANSI の適切な型の文字列に変換されセパレータで区切られています）。フラグは FileOpen() で使用されます。
FILE_TXT	16	単純なテキストファイル（CSV ファイルと同じですが、セパレータを考慮しません）。フラグは FileOpen() で使用されます。
FILE_ANSI	32	ANSIタイプ（ 1 バイトのシンボル）の文字列。フラグは FileOpen() で使用されます。
FILE_UNICODE	64	UNICODE タイプ（ 2 バイトのシンボル）の文字列。フラグは FileOpen() で使用されます。
FILE_SHARE_READ	128	複数のプログラムからの読み込みのための共通のアクセス。フラグは FileOpen() で使用されますがファイルを開く時の FILE_WRITE 及び/または FILE_READ フラグは必要です。
FILE_SHARE_WRITE	256	複数のプログラムからの書き込みのための共通のアクセス。フラグは FileOpen() で使用されますがファイルを開く時の FILE_WRITE 及び/または FILE_READ フラグは必要です。
FILE_REWRITE	512	FileCopy() 及び FileMove() 関数でのファイル上書きを可能にします。ファイルが存在し、書き込み用に開かれる必要があります。さもなければ、ファイルは開かれません。
FILE_COMMON	4096	全てのクライアント端末の共有フォルダ内のファイルパス \Terminal\Common\Files。フラグは FileOpen()、FileCopy()、FileMove() 及び FileIsExist() 関数で使用されます。

ファイルを開く時には、1 つ以上のフラグを指定することが出来ます。これは、フラグの組み合わせです。フラグの組み合わせは、列挙されたフラグの間に配置され（ | ）の論理和の符号を使用して書かれます。例えば、ファイルを CSV フォーマットで読み書きするために開くには、FILE_READ|FILE_WRITE|FILE_CSV の組み合わせを指定します。

例:

int filehandle=FileOpen(filename,FILE_READ|FILE_WRITE|FILE_CSV);

読み書きのフラグの指定には、いくつかの特定の機能があります。

FILE_READ が指定されると、既存するファイルを開く試みがなされます。ファイルが存在しない場合、ファイルを開く操作は失敗し、新しいファイルは作成されません。
FILE_READ|FILE_WRITE – 指定された名称のファイルが存在しない場合は、新しいファイルが作成されます。
FILE_WRITE – ファイルは、ゼロサイズで再作成されます。

ファイルを開く際には FILE_WRITE 及び/または FILE_READ が必要です。

開いているファイルの読み込みの種類を定義するフラグには優先順位があります。最優先されるフラグは FILE_CSV 、その次が FILE_BIN で、FILE_TXT の優先度は最も低いです。複数のフラグ（FILE_TXT|FILE_CSV または FILE_TXT|FILE_BIN または FILE_BIN|FILE_CSV）が同時に指定された場合、最高の優先度のフラグが使用されます。

エンコーディングの種類を定義するフラグにも優先順位があります。FILE_UNICODE の優先度は FILE_ANSI より高いです。なので、もし FILE_UNICODE|FILE_ANSI が指定された場合 FILE_UNICODE が使用されます。

FILE_UNICODE と FILE_ANSI のどちらもが指定されない場合には、FILE_UNICODE が暗示されます。FILE_CSV、FILE_BIN、FILE_TXT の 1 つも指定されない場合には、FILE_CSV が暗示されます。

もしファイルがテキストとして読まれるために開かれれ（FILE_TXT または FILE_CSV）ファイルの始めに特別な 2 バイトの印 0xff,0xfe がある場合、FILE_ANSI が指定されたとしても、エンコーディングフラグは FILE_UNICODE となります。

参照

ファイル関数

ファイルプロパティ

FileGetInteger() 関数はファイルプロパティの取得に使用されます。ENUM_FILE_PROPERTY_INTEGER 列挙からの必要なプロパティの識別子は、呼び出し時に渡されます。

ENUM_FILE_PROPERTY_INTEGER

ID	ID 説明
FILE_EXISTS	ファイルの存在をチェック。
FILE_CREATE_DATE	作成日。
FILE_MODIFY_DATE	最終更新日。
FILE_ACCESS_DATE	最終アクセス日。
FILE_SIZE	ファイルのバイトサイズ。
FILE_POSITION	ファイル内のポインタ位置。
FILE_END	ファイル終了の記号を取得。
FILE_LINE_END	行終了の記号を取得。
FILE_IS_COMMON	ファイルを全ての端末の共有フォルダ（ FILE_COMMON を参照）で開きます。
FILE_IS_TEXT	ファイルをテキスト（ FILE_TXT を参照）として開きます。
FILE_IS_BINARY	ファイルをバイナリ（ FILE_BIN を参照）として開きます。
FILE_IS_CSV	ファイルを CSV（ FILE_CSV を参照）として開きます。
FILE_IS_ANSI	ファイルを ANSI（ FILE_ANSI を参照）として開きます。
FILE_IS_READABLE	開かれたファイルが読み込み可能（ FILE_READ を参照）。
FILE_IS_WRITABLE	開かれたファイルが書き込み可能（ FILE_WRITE を参照）。

FileGetInteger() には 2 つの呼び出し方があります。1 つ目はファイルプロパティの取得に使用され、FileOpen() 関数でファイルを開く際に取得されるハンドルが指定されます。これで、ファイルの全てのプロパティの取得が出来ます。

2 番目の呼び出しでは FileGetInteger() はファイル名でファイルのプロパティの値を返します。このオプションを使用して取得出来るのは次の一般的なプロパティのみです。

FILE_EXISTS – 指定された名称のファイルの存在
FILE_CREATE_DATE – 指定された名称のファイルの作成日
FILE_MODIFY_DATE – 指定された名称のファイルの更新日

FILE_ACCESS_DATE – 指定された名称のファイルの最終アクセス日

FILE_SIZE – 指定された名称のファイルサイズ

上記に指定された以外のプロパティを取得しようとすると FileGetInteger() の2 番目の呼び出しオプションは、エラーを返します。

ファイル内の位置

ファイル関数の多くは、データの読み込み/書き込み動作に関連します。同時に、FileSeek() を使用すれば、次の読み込みまたは書き込み操作が実行されるファイル内の位置にファイルポインタの位置を指定することが出来ます。ENUM_FILE_POSITION 列挙は、次の演算のためのバイトの相対的なシフトを指定出来る有効なポインタの位置を含みます。

ENUM_FILE_POSITION

識別子	説明
SEEK_SET	ファイルの始め。
SEEK_CUR	ファイルポインタの現在位置。
SEEK_END	ファイルの終わり。

参照

FileIsEnding、FileIsLineEnding

文字列の変換操作でのコードページの使用

string 変数を char 型の変数と相互に変換する場合、MQL5 は、デフォルトでは、Windows オペレーティングシステムの現在の ANSI エンコーディング（CP_ACP）を使用します。異なる種類のエンコーディングは CharArrayToString()、StringToCharArray() 及び FileOpen() 関数の追加パラメータとして指定することが出来ます。

表は、いくつかの最も人気のあるコードページのための内蔵された定数を示します。他のコードページは、ページに対応するコードで指定することが出来ます。

コードページの内蔵定数

定数	値	説明
CP_ACP	0	現在の Windows ANSI コードページ。
CP_OEMCP	1	現在のシステムの OEM コードページ。
CP_MACCP	2	現在のシステムの Macintosh コードページ。注意事項：現代の Macintosh コンピュータはエンコーディングに Unicode を使用しているため、この値は、主に以前に作成したプログラムコードで使用され、今は使用されていません。
CP_THREAD_ACP	3	現在のスレッドの Windows ANSI コードページ。
CP_SYMBOL	42	シンボルコードページ。
CP_UTF7	65000	UTF-7 コードページ。
CP_UTF8	65001	UTF-8 コードページ。

参照

クライアント端末プロパティ

メッセージボックスダイアログウィンドウ定数

このセクションは MessageBox() 関数のリターンコードを含みます。メッセージウィンドウに「キャンセル」ボタンがあって、ESCキーまたは「キャンセル」ボタンが押された場合、この関数は IDCANCEL を返します。メッセージウィンドウに「キャンセル」ボタンがない場合、ESC を押すことで変化はありません。

定数	値	説明
IDOK	1	「OK」ボタンが押されました。
IDCANCEL	2	「キャンセル」ボタンが押されました。
IDABORT	3	「中止（A)」ボタンが押されました。
IDRETRY	4	「再試行（R)」ボタンが押されました。
IDIGNORE	5	「無視（I)」ボタンが押されました。
IDYES	6	「はい」ボタンが押されました。
IDNO	7	「いいえ」ボタンが押されました。
IDTRYAGAIN	10	「再試行する」ボタンが押されました。
IDCONTINUE	11	「続行（C)」ボタンが押されました。

MessageBox() 関数のメインフラグはダイアログウィンドウの内容と動作を定義します。この値は、次のフラグのグループの組み合わせであることが出来ます。

定数	値	説明
MB_OK	0x00000000	メッセージウィンドウには、「OK」ボタンが 1 つあります。（デフォルト）。
MB_OKCANCEL	0x00000001	メッセージウィンドウには、「OK」と「キャンセル」の 2 つのボタンがあります。
MB_ABORTRETRYIGNORE	0x00000002	メッセージウィンドウには、「中止（A)」「再試行（R)」「無視（I)」の 3 つのボタンがあります。
MB_YESNOCANCEL	0x00000003	メッセージウィンドウには、「はい」、「いいえ」と「キャンセル」の 3 つのボタンがあります。
MB_YESNO	0x00000004	メッセージウィンドウには、「はい」と「いいえ」の 2 つのボタンがあります。
MB_RETRYCANCEL	0x00000005	メッセージウィンドウには、「再試行（R)」と「キャンセル」の 2 つのボタンがあります。
MB_CANCELTRYCONTINUE	0x00000006	メッセージウィンドウには、「キャンセル」「再試行（R)」「続行（C)」の 3 つのボタンがあります。

メッセージウィンドウにアイコンを表示するには、追加のフラグを指定する必要があります。

定数	値	説明
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND	0x00000010	STOP アイコン。
MB_ICONQUESTION	0x00000020	はてなマークのアイコン。
MB_ICONEXCLAMATION, MB_ICONWARNING	0x00000030	感嘆/警告記号アイコン。
MB_ICONINFORMATION, MB_ICONASTERISK	0x00000040	丸で囲まれた i サイン。

デフォルトボタンは、次のフラグによって定義されています。

定数	値	説明
MB_DEFBUTTON1	0x00000000	MB_DEFBUTTON2、MB_DEFBUTTON3 及び MB_DEFBUTTON4 が指定されてない場合、最初のボタンである MB_DEFBUTTON1 がデフォルトです。
MB_DEFBUTTON2	0x00000100	2 番目のボタンがデフォルト。
MB_DEFBUTTON3	0x00000200	3 番目のボタンがデフォルト。
MB_DEFBUTTON4	0x00000300	4 番目のボタンがデフォルト。

Originally posted 2019-07-29 22:50:36.

ファイルを開く際のフラグ

ファイルプロパティ

ファイル内の位置

文字列の変換操作でのコードページの使用

メッセージボックスダイアログウィンドウ定数

Leave a Reply