This is a translation of the original English documentation page. Help us make it better.

1 アイテムキーのフォーマット

キーパラメータを含む項目キーの形式は、構文規則に従う必要があります。次の図は、サポートされている構文を示しています。各ポイントで許可される要素と文字は、矢印に従って決定できます。矢印の先にあるブロックに到達できる場合は許可され、到達できない場合は許可されません。

有効なアイテムキーを作成するには、キー名を指定し、次にパラメーターの有無を選択します。

キー名

キー名自体には、使用できる文字の範囲が限られており、その文字が相互に続くだけです。 許容される文字は :

0-9a-zA-Z_-. です。

つまり、以下の文字種を指します。

  • すべての数字
  • すべての小文字
  • すべての大文字
  • アンダースコア
  • ダッシュ
  • ドット

キーパラメーター

アイテムキーは、カンマ区切りで複数のパラメータを持つことができます。

各キーパラメータは、引用符で囲まれた文字列、引用符で囲まれていない文字列、または配列のいずれかになります。

また、パラメータを空にして、デフォルト値を使用することも可能です。 その場合、さらにパラメータを指定する場合は、適切な数のカンマを追加する必要があります。 例えば、アイテムキーicmpping[,,200,,500] は、個々の ping の間隔が 200 ミリ秒、ping のタイムアウトが 500 ミリ秒、その他のパラメータはデフォルトのままです。

パラメータにマクロを含めることができます。マクロはユーザー マクロまたは組み込みマクロの一部です。アイテム キー パラメータでサポートされている特定の組み込みマクロを確認するには、サポートされているマクロページで「アイテム キー パラメータ」を検索してください。

パラメータ - 二重引用符(")で囲まれた文字列

keyパラメータが 二重引用符で囲まれた文字列の場合、任意のUnicode文字が使用可能です。

keyパラメータがカンマを含む場合、このパラメータは 二重引用符で囲む必要があります。

キーパラメータが 二重引用符を含む場合、このパラメータは 二重引用符で囲む必要があります。 また,パラメータ文字列の一部である各 二重引用符は,バックスラッシュでエスケープする必要があります。

アイテムのキーパラメータを引用する場合は、 二重引用符(")のみを使用します。
引用符(')はサポートされていません。

パラメータ - 二重引用符(")がない文字列

キーパラメータに二重引用符がない文字列の場合、カンマと右大括弧(])を除く全てのUnicode文字が使用可能です。
二重引用符で囲まれていないパラメータで、左大括弧([)で始まる文字列は使用できません。

パラメータ - 配列

キーパラメータが配列の場合は、再び角括弧で囲みます。
個々のパラメータは、複数のパラメータを指定する規則と構文に沿うようになります。

多段階のパラメータ配列、例えば
[a,[b,[c,d]],e] のような複数レベルのパラメータ配列は許可されません。