リストおよびプロパティリストに関するローカルプロパティとグローバルプロパティ

ここで説明するSenseTalkグローバル／ローカルプロパティは、スクリプト内におけるリストおよびプロパティリストの振る舞いを管理するものです。これらのオプションを設定したり変更したりすると、フォーマッティング方法や挿入方法、その他のアクションに作用し、環境をカスタマイズすることができます。

SenseTalkにおけるリストおよびプロパティリストの詳細情報は、リストおよびプロパティリストをご覧ください。

ローカルプロパティとグローバルプロパティの扱い方に関する追加情報は、SenseTalkにおけるローカルプロパティとグローバルプロパティをご覧ください。

the listFormatグローバルプロパティ

値：必須の値3つとオプションで追加の値2つを含んだプロパティリスト。

• prefix：テキストへの変換時にリストの先頭に付ける文字。
• separator：テキストへの変換時に各リストアイテム間に表示する文字。
• suffix：テキストへの変換時にリストの末尾に付ける文字。
• quotes（オプション）：このプロパティでは、リスト内の値への引用符の付け方を定義します。デフォルトでは、リスト用にquotesの値が設定されないため、リスト値の引用符付けはthe defaultQuoteFormatグローバルプロパティの設定によって管理されます。
• indent（オプション）：このプロパティでは、リスト内のアイテムの字下げに使用するテキスト値を設定できます。indentの値を設定すると、各リストアイテムが別々の行に表示され、値は構造のネスティングに応じた倍数のindent値によって字下げされます。

デフォルト：初期設定では、必須の3つの値のみが設定されています。

• prefix： (
• separator： ,
• suffix： )

挙動：このグローバルプロパティでは、リストをテキスト形式に変換するときに使用するフォーマットを定義します。リストをテキストとして表示する際、リストはprefixとsuffixの値によって囲まれ、各リストアイテム間にはseparatorの値が使用されます。

定義済みのthe listFormatの値としては、boxListFormat、jsonListFormatおよびstandardListFormatがあります。

例：

例：

例：

例：

例：

例：

例：

上の例からの出力は、Runウィンドウにおいて次のように表示されます。

例：

上の例の最後のputコマンドは、Runウィンドウにおいて次のように表示されます。

例：

関連：

その他の演算子で説明したsplit byおよびjoined by演算子は、テキストからリストへ、またその逆へと明示的に変換するやり方です。リストの扱い方についての詳細は、 リストおよびプロパティリストをご覧ください。

the propertyListFormatグローバルプロパティ

値：以下のプロパティ値を含むことができるプロパティリスト。

• prefix：テキストへの変換時にリストの先頭に付ける文字。
• entrySeparator：テキストへの変換時にリストのキー／値の各組同士の間に表示する文字。
• keySeparator：テキストへの変換時にキーとその値との間に表示する文字。
• suffix：テキストへの変換時にリストの末尾に付ける文字。
• quotes：テキストへの変換時に、プロパティ値の引用符付けに使用する文字または文字群。
• emptyRepresentation：テキストへの変換時、オブジェクトにプロパティがない場合に使用する文字または文字群。
• indent（オプション）：このプロパティでは、リスト内のアイテムの字下げに使用するテキスト値を設定できます。indentの値を設定すると、各リストアイテムが別々の行に表示され、値は構造のネスティングに応じた倍数のindent値によって字下げされます。
• asTextEnabled： True、False

デフォルト：以下の振る舞いのところを参照してください。

• prefix： (
• entrySeparator： 「, 」（コンマとスペース）
• keySeparator： :
• suffix： )
• quotes：Standard
• emptyRepresentation： (:)
• asTextEnabled：True

挙動：このグローバルプロパティでは、プロパティリスト（オブジェクト）をテキストに変換するときに使用するフォーマットを定義します。

オブジェクトのテキスト表現が必要になったとき、asTextEnabledがTrue（デフォルト）になっていると、オブジェクトにasText関数メッセージが送られて、そのテキスト表現を取得します。オブジェクトがこのメッセージに対応しない場合、asTextまたはasTextFormatプロパティを使ってテキスト表現を取得します。

asTextEnabledがFalseになっていたり、どのasText機構によっても値が得られなかったりする場合には、別の値が使われます。その場合、オブジェクトのプロパティ群は（キーのアルファベット順で）並べられ、先行する各キー（プロパティ名）とその値との区切りにはkeySeparator（デフォルトでは「:」）が、項目間の区切りにはentrySeparator（デフォルトでは「, 」）が使用されます。

プロパティ値の引用符付けはquotesの値に従います（プロパティリストの場合、デフォルトはStandard。後述のthe defaultQuoteFormatグローバルプロパティを参照）。テキスト全体は、prefixとsuffix（デフォルトでは「(」と「)」）で囲まれます。オブジェクトにプロパティがない場合は、emptyRepresentationプロパティの値（デフォルトでは「(:)」）がそのテキスト表現として使われます。

keySeparatorがemptyに設定されている場合、オブジェクトのキーはリストに記載されず、その値だけが記載されます。

indentの値には、オブジェクト内の項目の字下げに使用するテキスト値を設定することができます。これをempty以外に設定すると、各項目が別々の行に表示され、各行は構造のネスティングに応じた倍数のindent値によって字下げされます。

例：

例：

例：

例：

例：

例：

関連：

プロパティリストをテキスト表現に変換する際の詳細については、リストおよびプロパティリストをご覧ください。

the listInsertionModeローカルプロパティ

値：item by item、nested

デフォルト：the defaultListInsertionModeグローバルプロパティ（初期設定はitem by item）

挙動：このローカルプロパティでは、アイテムのリストが別のリストに追加されるときのアイテムの振る舞いを管理します。このプロパティをitem by itemに設定すると、追加元のリストからの各アイテムが別々に追加されます。nestedに設定すると、追加元のリストがネストされたリストとして追加されます。

the listInsertionModeの値は、ハンドラごとのローカルな値です。ハンドラの実行開始時、そのハンドラ内のthe listInsertionModeは、the defaultListInsertionModeグローバルプロパティの値に初期設定されます。

例：

例：

例：

例：

関連：

• the defaultListInsertionModeグローバルプロパティ
• insertコマンド

the defaultListInsertionModeグローバルプロパティ

値：item by item、nested

デフォルト：item by item

挙動：このグローバルプロパティでは、アイテムのリストが別のリストに追加されるときのアイテムの振る舞いを管理します。このプロパティをitem by itemに設定すると、追加元のリストからの各アイテムが別々に追加されます。nestedに設定すると、追加元のリストがネストされたリストとして追加されます。

例：

例：

例：

例：

関連：

• the listInsertionModeローカルプロパティ
• insertコマンド

the DuplicatePropertyKeyModeグローバルプロパティ

値：error、first、last、list

デフォルト：error

挙動：このグローバルプロパティでは、1つのプロパティリスト内で同じキーが繰り返し使用されていたときの処理方法を管理します。

• このプロパティをerrorに設定すると、例外が投げられます。
• firstまたはlastに設定すると、当該キーに与えられた最初（または最後）の値だけが使用され、重複のキーは無視されます。
• listに設定すると、当該キーに与えられたすべての値が受け入れられ、リストに統合されます。

例：

例：

例：

関連：

プロパティリストの扱い方についての詳細は、 プロパティリストをご覧ください。

the strictPropertiesグローバルプロパティ

値：True、False

デフォルト：False

挙動：このプロパティでは、プロパティリスト内で未設定のプロパティにアクセスしようとしたときの振る舞いを管理します。the strictPropertiesをfalseに設定すると、SenseTalkが未定義のプロパティの値としてemptyを返します。the strictPropertiesをtrueに設定すると、未定義のプロパティへのアクセスによって例外が投げられます。

例：

例：

例：

the objectContainsItemDefinitionグローバルプロパティ

値：AsTextContains、NestedValueContains、KeyOrValueEquals

デフォルト：AsTextContains

挙動：このプロパティでは、演算子または関数によるプロパティリスト内のキーおよび値へのアクセス方法を管理します。このプロパティをAsTextContains（デフォルト）に設定すると、オブジェクトのテキスト値に検索値が含まれている場合にcontainsItem関数がtrueを返します。NestedValueContainsに設定すると、オブジェクトの各値に演算子が適用され、そのどれかに検索値が含まれている場合に式がtrueを生成します。そして最後のKeyOrValueEquals設定の場合、オブジェクトのキーまたは値のどれか1つと検索値が等しい場合にtrueが返されます。

例：

例：

例：

関連：

• オブジェクトの中身をチェックする

 

This topic was last updated on 2月 01, 2019, at 11:13:23 午前.

Eggplant.io | Documentation Home | User Forums | Support | Copyright © 2019 Eggplant