「Mery.iniのオプション値を取得」を編集中 (節単位)

=== 使い方 ===
 /**
  * 【使い方】
  *
  * GetIniOption3() 関数の使用は１回で済ませないと
  * その都度 '''INI ファイルの読み込み''' が発生してマクロの処理速度が落ちるので
  * 取得したい項目すべてをひとつの配列にまとめること
  *
  * ※ 要求する項目が１セットの場合も配列を '''入れ子''' にすること
  *   '''''<code>GetIniOption3( [ [ "SectionName", "KeyName" ] ] );</code>'''''
  *
  * ※ INI のオプション項目名の記述を間違えても警告ダイアログを表示して続行する
  *    記述ミスをした項目の値 ''value ''は '''''<syntaxhighlight lang="javascript" inline>undefined</syntaxhighlight>''''' で返される
  * ※ INI 内でオプションの値が空 ''<code>KeyName=</code>'' の場合は、空文字列 '''<syntaxhighlight lang="javascript" inline>""</syntaxhighlight>''' を返す
  *
  * ※ 値はすべて '''"文字列型"'''（String）で返されるので、
  *    必要に応じて ''<code>Number( value )</code>'' などのかたちで利用すること
  * 
  * <b style="color:#c00;">【注意】</b>
  * <span style="color:#c00;">※ セクション名にバックスラッシュ「'''<code>\</code>'''」が含まれる場合、</span>
  *    <span style="color:#c00;">戻り値のプロパティ名を指定するさいには '''ブラケット記法''' で記述すること</span>
  * 
  *  e.g. ''<syntaxhighlight lang="javascript" inline>[ "Themes\\Theme0", "Caption" ]</syntaxhighlight>''
  *   ⇒  ''<syntaxhighlight lang="javascript" inline>objOptions["Themes\\Theme0"]["Caption"]</syntaxhighlight>''
  *  （ドット記法で ''<syntaxhighlight lang="javascript" inline>objOptions.Themes\\Theme0.Caption</syntaxhighlight>'' とすると <b style="color:#c00;">エラー</b> になる）
  */
<syntaxhighlight lang="javascript">
// ➀ セクション名とキー名をセットにした配列 [ [section1, key2], [section2, key2] ... ]
//    セクション名に「\」がある場合は、ふたつ重ね「\\」で記述すること
var keyArray = new Array(				// ▼ 戻り値 ▼
  [ "General", "LineColumnView" ], 		// 0 or 1
  [ "General", "FileFilter" ], 			// "*.txt;*ini;*.htm; …"
  [ "General", "Untitled" ], 			// 「無題」の代替値 or ""
  [ "Display", "FallbackFonts" ], 		// フォント名 or ""
  										// → （～ Ver 2.7.4 では undefined）
  [ "View", "FontName0" ], 				// フォント名（履歴） or ""
  [ "Macros\\Macro1", "FileName" ], 	// Macros\マクロ名.js or ""
  [ "Outline\\JavaScript", "Match1" ],	// 文字列値 or 正規表現 or "..."
  [ "Themes\\Theme29", "Caption" ], 	// テーマ名 or ""
  [ "Themes", "HOGE" ],				 	// [Themes] HOGE  =  null
  [ "FUGA", "PIYO" ] 					// [FUGA] PIYO = null
);

// ➁ 関数の引数に配列をあたえて、変数 iniOption に代入する
//    関数の戻り値は入れ子状のオブジェクト
//    { section1 : { key1 : value1 }, section2 : { key2 : value2 } ... }
// ※ value は文字列値（String）で返される（数字の場合も "1"  ※ "1" !== 1 ）

var iniOptions = GetIniOption3( keyArray, true );	// 戻り値は Object 型


// ➂-1.（例１）戻り値で取得した内容をアウトプットバーに出力する

OutputBar.Writeln( "\nRun > " + ScriptName + " : function GetIniOption3()" );
var section, key;
for ( var i = 0; i < keyArray.length; i ++ ) {
  section = keyArray[i][0],  key = keyArray[i][1];
  OutputBar.Writeln( "[" + section + "]\t" + key
                   + "=" + iniOptions[ section ][ key ] );	// ブラケット記法
  // セクション名に「\」をふくむ項目があるのでブラケット記法を使用
}


// ➂-2.（例２）特定の key の値を参照して変数に格納する場合

var ff = iniOptions.General.FileFilter;			// ドット記法
var fn = iniOptions[ "View" ][ "FontName0" ];	// ブラケット記法
Alert( "[General]\nFileFilter=" + ff + "\n"
     + "[View]\nFontName0=" + fn );
</syntaxhighlight>