IniRead

標準フォーマットの.iniファイルから値、セクション、またはセクション名のリストを読み込みます。

Value := IniRead(Filename, Section, Key , Default)
Section := IniRead(Filename, Section)
SectionNames := IniRead(Filename)

パラメータ

Filename

型：文字列

.iniファイルの名前。絶対パスが指定されていない場合は、A_WorkingDirにあると仮定されます。

Section

型：文字列

.iniファイル内のセクション名で、角括弧内に表示される見出し語です（このパラメータに括弧は含めないでください）。

Key

型：文字列

.iniファイル内のキー名です。

デフォルト

型：文字列

省略された場合、失敗時にOSErrorが投げられます。Otherwise, specify the value to return on failure, such as if the requested key, section or file is not found.

戻り値

型：文字列

この関数は、指定されたキーの実際の値を返します。値が取得できない場合は、Defaultパラメータで示されるデフォルト値が返されます。

Keyパラメータが省略された場合は、セクション全体を返します。コメントや空行は省略されます。セクションの最初の65,533文字のみが検索されます。

KeyおよびSectionパラメータが省略された場合，セクション名をラインフィード(`n)で区切ったリストを返します．

エラー処理

Defaultが省略された場合のみ、失敗時にOSErrorが投げられます。

例外の発生有無にかかわらず、A_LastErrorにはオペレーティングシステムのGetLastError()関数の結果が設定されます。

備考

オペレーティングシステムは、取得した文字列から先頭と末尾のスペース/タブを自動的に省略します。これを防ぐには、文字列をシングルクォートまたはダブルクォートで囲んでください。最も外側にあるシングルクォートまたはダブルクォートのセットも省略されるが、クォートマーク内のスペースは保持されました。

65,535文字より長い値は、一貫性のない結果になる可能性が高いです。

標準的なiniファイルは次のようなものです：

[SectionName]
Key=Value

ユニコード：IniReadとIniWriteは、値の読み書きに外部関数GetPrivateProfileStringと WritePrivateProfileStringに依存しています。これらの関数は、UTF-16ファイルでのみUnicodeをサポートし、それ以外のファイルではシステムのデフォルトのANSIコードページを使用するものとします。

関連

IniDelete, IniWrite, RegRead, file-reading loop, FileRead

例

Value := IniRead("C:\Temp\myfile.ini", "section2", "key")
MsgBox "The value is " Value