リスト

リストおよびプロパティリストは、スクリプト内でデータをまとめて操作するための便利で強力な方法です。このセクションでは、リストの能力を最大限活用するために知っておかなければならない主要事項を説明します。

リストの扱い方に関する詳細はチャンク式を、制御構造についてはRepeat with Eachをご覧ください。

SenseTalkには、リストとプロパティリストの他に、階層ツリー構造も用意されています。これについては、SenseTalkスクリプトでXMLおよびツリー構造を使用するで説明します。

リストを作成する

スクリプト内でリストを作成するには、2つ以上の式を列記してコンマで区切り、それを括弧で囲みます。リストは必ず括弧または波括弧に入れなければなりません。こうすることにより、リストの構文が明確で一貫したものとなり、ネストされたリストの構築も容易になります。

例：

例：

例：

例：

例：

さらに長いリストの場合、波括弧{ }で囲むことにより、複数行にまたがるリストにすることができます。

リストの中身

リストには、他のリストやプロパティリストを含む、あらゆる種類の値を入れることができます。リストを構築する際に式を使うことも可能です。

例：

例：

シングルアイテムリスト

スクリプト内で1つの値を括弧で囲むと、その括弧がグループ化演算子として扱われるため、値はリストとして扱われません。括弧に入った1つのアイテムをリストとしてSenseTalkに認識させるためには、値の後ろにコンマを入れます。

例：

ほとんどの用途では、1つのアイテムを含んだリストは、1つの（リストではない）値と同じように扱われます。例えば、myListが(4)、つまり数値4という1つのアイテムを含んだリストである場合に、put myList + 2 into theSumを使用すると、 theSumに数値6が格納されます。通常、こうしたリストにテキストとしてアクセスすると、値が括弧に入って表示されます。これを避けるためには、the listFormatのprefixおよびsuffixプロパティをemptyに設定します。

空のリスト

空のリストを作成するには、空の括弧を1組使うか、empty listというフレーズを使用します。

例：

リストにアイテムを挿入する

insertコマンドを使うと、リストまたはリストアイテムの前、中または後にアイテムを挿入することができます。putコマンドに若干似ているコマンドですが、宛先コンテナを常にリストとして扱います。

例：

例：

アイテムのリストを別のリストに挿入する場合、方法は2種類あります。デフォルトモード（「item by item」）では、元のリストの各アイテムが宛先リストに挿入されます。

例：

また、nestedキーワードを使い、別のリスト内にリストを挿入し、ネストされたリストを作成することも可能です。

例：

挿入の標準的な振る舞いを操作するには、the listInsertionModeローカルプロパティまたはthe defaultListInsertionModeグローバルプロパティをnestedかitem by itemのどちらかに設定します。

例：

より詳しい情報は、insertコマンドをご覧ください。

Push、Pull、 Pop

pushコマンドは、insertコマンドと同義です。popコマンドは、リストから最後の値を取り除いて、それを変数に格納します。pushコマンドとpopコマンドは、リストをスタックとして扱います。スタックに押し出されたアイテムは、popコマンドによって逆の順序で取り出すとができます。

例：

pullコマンドは、リストから最初の値を取り除いて、それを変数に格納します。pushコマンドとpullコマンドは、リストをキューとして扱います。pullコマンドは、pushコマンドによってキューに追加されたときと同じ順序でアイテムを1つずつ取り出します。

例：

リストからどのアイテムをpopまたはpullするかを指定することもできます。

例：

リストを結合する

2つのリストを1つ（ネストなし）のリストに結合するには、&&&演算子を使います。

例：

リストアイテムにアクセスする

リスト内のアイテム（アイテムの範囲、アイテムのリストを含む）へのアクセスはすべて、itemおよびitemsチャンク式（または、より明示的な形であるlist itemおよびlist items）を使って行うことができます。1つのアイテムにアクセスすると、そのインデックスのアイテムが得られます。アイテムの範囲にアクセスすると、必ずリストが生成されます。範囲で1つのアイテムを指定した場合でも同様です。

例：

例：

itemという語は、対象の変数がリストであると分からない場合、リストアイテムではなくテキストアイテムをデフォルトで参照します。明示的な形であるlist itemを使うと、必ず変数をリストとして扱います。これは、変数にリストでない値が格納されている場合でも同様です（その場合、その値を格納したシングルアイテムリストのように扱います）。

例：

リストをテキストに変換する

splitおよびjoinコマンド／関数、asText関数（詳細はテキストを扱うを参照）、そして対応するsplit byおよびjoined by演算子（式を参照）を使うと、テキストからリストへ、リストからテキストへの変換を明示的に行うことができます。

例：

リストにテキストとしてアクセスする必要がある場合（putコマンドで表示する場合など）は、SenseTalkが自動的にテキスト表現への変換を行います。デフォルトの変換方法では、リスト全体が括弧で囲まれ、リスト内のアイテムがコンマで区切られます。このフォーマッティング方法を変更するときは、the listFormatグローバルプロパティのprefix、separatorおよびsuffix値の設定を行います。prefixはリストの前に使われるテキスト（通常は左括弧）で、separatorはアイテム間に挿入されるテキスト、suffixはリストの後に追加されるテキストです。これらの値は、emptyを含め、どんなテキストでもお好きに設定することができます。

例：

例：

リストがテキストに変換されると、リスト内の各値はテキスト表現に変換されます。これらの値の引用について操作するときは、the listFormatグローバルプロパティのquotes値の設定を行います。このプロパティの詳細は、the listFormatをご覧ください。

時にSenseTalkは、複雑なオブジェクトである対象にテキスト表現を与えることがあります。例えば、files()関数は、プロパティリストのリストを返すもので、その1つ1つのプロパティが各ファイルを表すオブジェクトになっています。この例で考えた場合、これらのファイルをやむを得ずプロパティリストとして扱う代わりに、asText表現で扱うことが可能なのです。

例：

テキストをリストに変換する

splitおよびjoinコマンド／関数、asText関数（詳細はテキストを扱うを参照）、そして対応するsplit byおよびjoined by演算子（式を参照）を使うと、テキストからリストへ、リストからテキストへの変換を明示的に行うことができます。

例：

データ駆動テストにおいてコンマ区切りの.txtまたはCSVファイルを使用する場合、SenseTalkがアクセスするデータファイルの各行は、リストではなくテキスト文字列です。これは、データファイル内でテキスト文字列がリストのごとくフォーマットされているように見える場合にも、言えることです。SenseTalkはテキスト文字列内のアイテムにアクセスし、それにわたって繰り返しを行うことができるため、ファイルの中身をリストであるかのように扱いたい場合に、ファイルからの入力に何か特別な処理が必要なわけではありません。しかし、こうしたケースにおいて扱われているのが実際にはリストではないと理解しておくことが、一部の状況においては重要な場合もあります。

例：

リストをテキストに変換する際、value関数によってテキストを評価すると元のリストが再び生成されるようなフォーマットで変換を行うには、standardFormat関数を使用します。

例：

テキスト表現をリスト構造に変換する

putまたはlogコマンドなど、リストにテキストとしてアクセスする稀な状況では、SenseTalkがリストをテキスト表現に自動変換することにより、意図とは異なる簡略化された構造が生じます。要望に沿ったリスト構造を生成し、SenseTalkに当該リストをリストに似たフォーマットで表示させるためには、asList()を使用します。詳細については、as演算子をご覧ください。

例：

チャンクの種類では、テキストアイテムを参照できますが、 これはそのテキストがリストだという意味ではありません。テキストをリストに変換することによって、アイテムの定義やアクセス方法を変更するには、asList()関数を使うことができます。

例：

リスト内の値を自動変換する

SenseTalkは型なし言語です。そのため、SenseTalkは値（リストに格納された値を含む）を適当な内部表現へと自動的に変換します。

例：

リスト内のアイテムを置き換える

insertコマンドはリストを扱うために特別に用意されたコマンドですが、リストに新しい値を追加することしかできません。リスト内の既存のアイテムを新しい値に置き換えるときは、setまたはput intoコマンドを使います。

put intoまたはsetコマンドを使って1つまたは複数の新しい値をリスト内に入れると、宛先の中身全体が新しい値に置き換わります。最終的な結果としては、次のようないくつかの形があり得ます。

宛先コンテナが変数の場合、SenseTalkは変数のそれまでの中身を破棄し、新しい値のコピーに置き換えます。

例：

ソースが1つの値で、宛先がリスト内の1つのアイテムまたはアイテムの範囲である場合、それらのアイテムが丸ごと新しい値に置き換わります。

例：

新しい値が1つの値ではなくリストであって、宛先が1つのアイテムである場合は、ネストされたリストになります。

例：

宛先がアイテムの範囲である場合は（その範囲が1アイテムであっても）、これらの値が新しい値に置き換わります。

例：

こうした結果は、「item by item」または「nested」を指定することで、明示的に操作することができます。

例：

前に説明したlistInsertionModeおよびdefaultListInsertionModeプロパティは、宛先がアイテム範囲で、「nested」または「item by item」が明示的に記載されていない場合も適用されます（上記の一部の例では、これらのプロパティにデフォルトの「item by item」が設定されていると仮定しています）。

格納先のインデックスのリストを指定すると、一度に複数のアイテムに値を格納することができます。

例：

例：

1つの値を一度に複数のアイテムに格納することも可能です。

例：

リストからアイテムを削除する

リストから1つアイテムまたはアイテムの範囲を削除するときは、標準的なチャンク式の構文と併せてdeleteコマンドを使用します。

例：

例：

リストから文字を削除する

リストから特定の文字または文字列を削除するときも、deleteコマンドを使用します。SenseTalkは、リスト内の各アイテムから指定の文字列を削除します。

例：

リスト内のアイテムを数える

リスト内に何個のアイテムがあるか突き止めるには、number関数を使って、アイテムの数を要求するか（リストであることが分かっている場合）、またはリストアイテムの数を明示的に要求します（リストではない可能性がある場合）。

例：

例：

リスト内のアイテムの位置を決定する

item number of ... within ...式を使うと、リスト内のある値のアイテム番号が得られます。そのアイテムがリストに見つからないときはゼロが返されます。

例：

item number containing ... within ...式を使うと、リスト内で指定の値を含んだ最初のアイテムの番号が得られます。その値がリストに見つからないときはゼロが返されます。

リスト上で算術演算を行う

リストでは、ベクトル演算がサポートされています。

2つの数値リストの長さが同じであれば、その2つのリストを足したり引いたりすることが可能です。この加算／減算は、2つのリストの対応するアイテム同士で行われます。ベクトル演算は、ネストされたリストでも機能します。

例：

リスト同士の乗算や除算も、リストの長さが同じ場合に機能します。

例：

1つの値を使ってリストを掛けたり割ったりすることもできます（リスト内のすべての値をスケーリングするため「スカラー」と呼ばれることがあります）。

例：

例：

リストを比較する

比較演算子は、単独の値のときとは異なる方法でリストを扱います。=、<>、<、 >、<=および>=演算子は、リストのアイテムごとにくまなく適用され、個々の値を比較して、等価性／非等価性を判断します。等しいと判断されるには、両方のリストに同じ数のアイテムがあり、それぞれの対応する組が等しくなければなりません。等しくない場合、等価でない最初のアイテム組で序列が決まります。リスト同士の長さが等しくないものの、短い方のリスト内の各アイテムが等価の場合、長い方のリストの方が大きいと判断されます。プレーンな（リストではない）値は、リストと比較されるときには、1つのアイテムを含んだリストのように扱われます。

例：

例：

begins with、ends with、is inおよびcontains演算子はどれも、検索されている値がリストの場合は必ず、リスト内にその通りの値または値の連続があるかどうかをチェックします。これらの演算子はすべて、ネストされたリストの中まで深く検索します。検索対象の値もリストの場合、一致となるためには、リスト内またはいずれかのサブリスト内において各アイテムが同じ順序で現れる必要があります。

例：

リスト内のアイテムにわたって繰り返す

リスト内のそれぞれの値を用いてアクションを実行するときは、repeat with each itemループを使うと、リスト内の値を1つ1つ使用していくことができます。この方法では、it変数にリスト内の各値を順々に設定していきます。

例：

it以外の変数を使うときは、itemの後に変数名を入れます。

例：

リスト内のアイテムの変更（値の変更、さらには削除など）を行うには、by referenceを指定します。この方法により、ループ変数を、アイテムの値のコピーではなく、各アイテムの参照に設定します。

例：

「each」式を使ってリストアイテムを選択する

チャンクのリストを抽出するでは、each式を使って、選択したチャンクのリストを値から得る方法が説明されています。同じように、選択したアイテムのサブリストをリストから抽出する場合も、where節を伴ったeach式を使用します。

例：

例：

「each」式を使ってリストに演算を適用する

リスト内の各アイテムに演算を行い、結果の値のリストを得るには、より大きな式の要素としてeach式（where節あり／なし）を使用します。

例：

例：

これらの式は、each式からの各アイテムに複数の演算が適用され、複雑化することがあります。括弧で囲むと、each式の範囲が制限されます。括弧内の演算子はリストの各アイテムに適用され、括弧外の演算子は全体としてリストに適用されます。

リスト内のアイテムを並べ替える

リストを並べ替えるには、sortコマンドまたはsorted演算子を使用します。リストの並べ替えは、次のように簡単に行うことができます。

例：

他にも、順序を指示したり、リスト内にある各リストのプロパティ値を評価するオプションを指示したりといった、並べ替えのオプションを指定できます（詳細は Sortコマンドの説明を参照）。

例：

sorted演算子を使うと、オンザフライでリストを並べ替えることができます。

例：

 

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

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