INIファイル

キー(プロパティ)の編集

INIファイルに含まれる基本的な要素は、キーまたはプロパティです。 キーには、名前と値があり、等号(=)で区切られています。 名前は等号の左に表示されます。 Windowsの実装では、等号とセミコロンは予約文字であり、キーには含まれません。 値は任意の文字を含むことができます。

name=value

SectionsEdit

キーは任意の名前のセクションにグループ化することができますが、その必要はありません。 セクション名は角括弧()で囲まれた1行に表示されます。 セクション宣言の後のすべてのキーは、そのセクションに関連付けられます。 明示的な「セクションの終わり」という区切り文字はありません。セクションは次のセクション宣言で終わるか、ファイルの終わりで終わります。

a=ab=b

大文字小文字の区別

Windows の実装では、セクション名とプロパティ名は大文字小文字を区別しませんが、他のアプリケーションでは異なる動作をする可能性があります。

コメント

行頭のセミコロン (;) はコメントを表します。 コメント行は無視されます。

; comment text

Varying featuresEdit

このセクションは検証のために追加の引用が必要です。 信頼できるソースへの引用を追加して、この記事を改善してください。 出典のないものは異議を唱えられ、削除されることがあります。 (2012年4月) (Learn how and when to remove this template message)

INIファイルのフォーマットは、普遍的に厳密に定義されているわけではありません。 多くのコンピュータプログラムは、すでに説明した基本的な機能以外の機能をサポートしています。

CommentsEdit

一部のソフトウェアでは、コメントを示すセミコロンの代わりに、数字記号 (#) の使用をサポートしています。 ただし、キー名に含まれていても構いません。

#var=a

さらに一般的には、以下の行のように、数字記号の使用は予測不可能です (2行目の数字記号の後のスペースに注意してください)。

## var=a

一部の実装では、コメントは行のどこからでも始められ、プロパティやセクション宣言の後の同じ行でもよいことになっています。

Duplicate namesEdit

ほとんどの実装では、1 つのセクションに指定された名前のプロパティを 1 つだけ持つことをサポートしています。 プロパティ名が 2 番目に出現した場合は、中止されるか、無視されるか (値は破棄される)、1 番目に出現したプロパティを上書きするか (最初の値は破棄される) のいずれかになります。 プログラムによっては、複数の値を持つプロパティを実装するために、重複したプロパティ名を使用しています。 一部の実装では、重複するセクションは、あたかも連続して発生したかのように、単純にそのプロパティをマージします。

エスケープ キャラクター 編集

一部の実装では、バックスラッシュ (\) に代表されるエスケープ キャラクターのサポートもさまざまなものがあります。 一部の実装では「行の継続」をサポートしており、バックスラッシュの後にすぐにEOL(End-of-Line)を入力すると、改行が無視され、INIファイルの次の実際の行に「論理的な行」が継続されます。 エスケープ シーケンスによるさまざまな「特殊文字」の実装も見られます。

mg src=”/FileUpload/Features/2/Photo/2.0″.

td

一般的なエスケープシーケンス
シーケンス シーケンス 意味
\\ \(シングルバックスラッシュ。 エスケープ文字)
\' アポストロフィ
\" ダブルクォート
\0 Null character
\a Bell/Alert/Audible
\b Backspaceです。
\t タブ文字
\r キャリッジリターン
\n ラインフィード
\; セミコロン
\# 数字記号
\= イコール記号
\: コロン
\x???? に対応する16進コードポイントを持つUnicode文字 ????

Global propertiesEdit

オプションとして、セクションが宣言される前に宣言される「グローバル」プロパティも許可されます。

HierarchyEdit

一般的に、INIファイルはセクションの中にセクションの階層を持ちません。 しかし、いくつかのファイルは、階層的な命名規則を持っているように見えます。 セクション A、サブセクション B、サブセクション C、プロパティ P、値 V に対して、P=V (Windows の xstart.iniP=V(IBM Windowsのドライバーファイルdevlist.iniB,C,P = V(Microsoft Visual StudioのファイルAEMANAGR.INI)。

これらが、アプリケーションがたまたま階層を見せるために使用した単なる命名規則なのか、それとも、この階層をアプリケーション プログラマーに実際に提示するモジュールによってファイルが読み取られているのかは不明です。

名前/値の区切り記号編集

一部の実装では、名前/値の区切り記号として (等号の代わりに) コロン (:) を使用することができます。

値の引用編集

一部の実装では、通常二重引用符やアポストロフィを使用して値を引用することができます。 これにより、空白を明示的に宣言したり、特殊文字 (イコール、セミコロンなど) を引用したりすることができます。 Windows の標準関数である GetPrivateProfileString は、この機能をサポートしており、値を囲む引用符を削除します。 ほとんどの実装では、プロパティ名の外側にある先頭および末尾のホワイトスペースを無視します。 また、値の中のホワイトスペースを無視するものもあります (たとえば、「host name」と「hostname」を同じ意味にしています)。

セクションとプロパティの順序

ほとんどの場合、セクション内のプロパティの順序やファイル内のセクションの順序は関係ありませんが、実装はさまざまです。

コメントを残す

メールアドレスが公開されることはありません。 * が付いている欄は必須項目です