条件文

条件文を使用すると、スクリプトは選択を行い、特定の条件下でのみ一部のアクションを実行し、他の条件下で他のアクションを実行します。

If ... Then ... Else ...

振る舞い: if 文のすべての形式は条件式を評価し、それは論理値（true または false、または同等の値 yes または no、または on または off）に評価する必要があります。空の値も false として扱われます。条件が true（または yes または on）である場合、SenseTalk は単語 then に続く文または文のリストを実行します。条件が false（または no または off または空）である場合、SenseTalk は単語 else に続く文または文のリストを実行します（存在する場合）。

if 文は次のいずれかの形式をとることができます。

ノート

statement は単一の文であり、statementList は複数の文であり、それぞれが自分の行にあります。else 部分は常にオプションです。

単行

if condition
then statement

if condition then statement else statement

例:

if true then put "Yes!" -- Always puts "Yes!"

例:

if balance < 1000 then put "The balance is getting low"

例:

if the repeatIndex is greater than 5 then LogError "There is a problem." -- When used inside a repeat loop, the repeatindex() function tracks which iteration the repeat loop is on

例:

put 4..10 into numList -- Creates the list '(4,5,6,7,8,9,10)'
repeat with each item of numList -- Iterates based on each item in the list
  if it is an even number then log it -- Checks whether the value of the current item is an even number, and if so, logs the value
end repeat

出力:

4
6
8
10

複数行の単一文

構文: if condition
then statement

if condition
then statement
else statement

例:

put the date into dateoftransaction -- Stores the current date into a variable

if dateoftransaction is between date("January 1") and date("June 30")
then put "First half" into transactionperiod
else put "Second half" into transactionperiod

log transactionperiod

複数のステートメントブロック

構文: if condition {then}
statementList
end if

if condition {then}
statementList else
statementList
end if

ノート

複数のステートメントブロックと連鎖条件では、then が行の最後にある場合、必要に応じて省略することも可能です。

例:

if myString contains "testcase" then
  delete ")" from myString
  delete "(" from myString
  log myString
end if

例:

If imagefound("on")
  Click foundimagelocation() -- Clicks the location where the previous image "on" was found
else
  Click "off"
end if

連鎖条件

最終的に示される「連鎖条件」は、相互に排他的な一連の条件をテストできます。else if ブロックを連鎖させて必要なだけ条件をテストし、最終的に end if の前に else ブロックを配置して、テストした条件のいずれにも一致しないケースを捉えます。より洗練されたアプローチについては、「複数のケースに対するif文」(#multi-case-if)を参照してください。

構文:
if condition1 {then}
statementList
else if condition2 {then}
statementList
end if

if condition1 {then}
statementList
else if condition2 {then}
statementList
else statementList
end if

ノート

チェーンされた条件文では、行末に単語thenが表示される場合、必要に応じて簡潔さのために省略することができます。

例:

if imageFound(image:"DashHome",waitFor:0)
  Click "DashHome"
else if imageFound(image:"StartHome",waitFor:0)
  TypeText WindowsKey,"r"
  WaitFor 8, "RunLine"
else
  throw "Image not found", "Desktop not visible." -- Neither of the two conditions are met, so an exception is thrown
end if

複数ケースのif文

挙動: 複数ケースの if 文は、多くの条件と結果を持つ条件文を明確かつシンプルに書くことを可能にします。これは、else if を使って示す通常の代替条件が多くなるときに便利で、構文を単純化します。また、フォールスルーやケースのチェックを続けるステートメントにより、実行のフローをさらに柔軟に制御することができます。

ノート

SenseTalkの複数ケースのif文は、他の言語のswitch文やcase文に似ています。

複数ケースのifの三つの形式

複数ケースの if 文には3つの形式があります。これらの構文のバリエーションは柔軟性を提供し、テストのニーズに合わせて複数ケースの if 文をカスタマイズできます。

全3つの形式では、省略記号 (…) を使用して、テストする条件を初期行とケースを定義するいくつかの後続行の間で分割します。全3つの形式は同じ基本構造に従い、次の要件を順に満たす必要があります。

• 最初の行は if で始まり、省略記号 (...) で終わる必要があります（この最初の省略記号は、通常の if ... then ... else 条件文ではなく、複数ケースの if 文を書いていることを示しています）。
• 条件が真と評価された場合（真と評価される場合）に実行されるコードを提供する、少なくとも一つの可能なマッチングケースが存在する必要があります。
• オプション: else ケース。
• end if 行。これは複数ケースの if 文の終わりを示します。

異なる形式では、条件文を2つの部分に分割できますが、文内の異なる点で、異なるレベルの柔軟性が可能です。

形式1：if value operator ... (各ケースは値)

この形式では、比較演算子の後の省略記号で条件文を分割します。これは、最初の行で初期値と比較演算子が提供され、各ケースが比較のための第2の値を提供することを意味します。

この形式では、限定的な数の比較演算子を使用できます。これらには以下のものが含まれ、いずれもその変形や否定形（つまり、「is」の他に「=」、「are」、「isn't」、「is not」など）を使用できます：

• is
• matches
• less than
• greater than
• less than or equal to
• greater than or equal to
• begins with
• ends with
• is in
• contains
• is within

構文: If expression comparisonOperator ...     {...} value [then | :] singleStatement     {...} value [then | :]         statementList     {...} {else} {:}         {statementList} end If

例：

この例は、変数に格納された情報に基づいてアクションを実行するために、マルチケース if 文をどのように使用できるかを示しています。

set monthNumber to the month of "2020-08-19" -- この値はいくつかの方法で設定できます。
> 
if monthNumber is ... -- このマルチケースif文は、提供された日付を見て月の番号を決定し、その月の名前を対応するようにログに記録します。
  1 : set monthName to "1月"
  2 : set monthName to "2月"
  3 : set monthName to "3月"
  4 : set monthName to "4月"
  5 : set monthName to "5月"
  6 : set monthName to "6月"
  7 : set monthName to "7月"
  8 : set monthName to "8月"
  9 : set monthName to "9月"
  10 : set monthName to "10月"
  11 : set monthName to "11月"
  12 : set monthName to "12月"
  else :
     throw "カレンダーが壊れています！" -- もし月がカレンダーの中のどの月とも一致しなければ、このカレンダーが壊れているという例外を投げます。
end if

log monthName -- "8月"をログに記録します。

形式2： if value ... (各ケースが条件を完成させる)

この形式では、if文の最初の行は初期値のみを提供します。その後、各ケースは条件を完成させるための演算子と、そのケースで実行うべき文を開始します。これにより、単一の値に対して複数の異なるテストを容易に行うことができます。

構文:

If value ...
    ... operator expression [then | :] singleStatement
    ... operator expression [then | :]
        statementList
    {...} {else} {:}
        {statementList}
end If

ノート

形式2を使用する際は、各ケースの前に省略記号が必要です。

例：

この例では、マルチケース if 文を使用して、同じ文の中でさまざまな演算子を使用して同じ値に対する異なるテストを行う方法を示しています。形式2では、下のコードが示すように、ケースはそれぞれがアポストロフィーs ('s) およびドット (.) 文法を使用して評価するプロパティに個別にアクセスできます。

set Wilbur to (nickName:"Wil", lastName:"Wilberforce", age:16)

put Wilbur's nickName & " は..."

if Wilbur's age ...
  ... is less than 1 then
    put "Infant"
  ... <= 3 then
    put "幼児"
  ... is between 13 and 19 :
    put "Teenager"
  ... less than 18 then put "子供"
  ... is more than 65 : put "シニア"
  else
    put "赤ん坊"
end if

出力:

Wil は...
ティーンエイジャー

例：

この例では、アポストロフィーs('s)とドット(.)構文を使用して、個々の名前と年齢のプロパティ（person変数に保存）にアクセスします。

put (name : samantha, age:10) into person

if person…
  … 's name begins with "S" then -- アポストロフィーs ('s) 構文を使用して name プロパティにアクセスします。
    put "Sで始まる名前"
    keep checking cases -- 一つが真と評価されるまで順にケー確します。詳細については、「Keep Checking Cases」を参照してくさい。
 … .age < 18 then put "人は未成年" -- ドット(.)構文を使用してageプロパティにアクセスします。
end if

出力:

Sで始まる名前
人は未成年

形式3：if ...（各ケースは完全な条件式）

実行するコードは、一つのコマンドだけを実行する必要がある場合、ケース条件と同じ行に表示することができます。複数のコマンドを実行するには、ステートメントリストを使用します。ステートメントリストは次の行から始まります。これをアクションで見るには、マルチケース if ステートメントの三つの形式のいずれかの構文を参照してください。

構文: If ...

    {...} condition [then | :] singleStatement     {...} condition [then | :] statementList     {...} {else} {:} {singleStatement}         {statementList} end If

例：

この例では、マルチケース if 文の形式3を使用して、ランダムに生成された値に基づいて異なる出力を生成します。この例をスクリプトにコピーしてペーストして、自分で実行することができます。

set x to random (-5,5)
set y to random (-5,5)
put x,y
 
If ...
  ... x = 0 and y = 0 :
    put "原点にあります！"
  ... x = 0 :
    put "y軸上"
  ... y = 0 :
    put "x軸上"
  ... x > 0 and y > 0:
    put "第一象限"
  else
    put "他の象限"
End if

ケース作成と実行フロー

マルチケース if ステートメントの典型的な実行フローは、各ケースが順番に確認され、真と評価されるか（提供された条件が満たされるか）を確認します。真と評価されたケースが見つかった後、そのケースのコードが実行され、マルチケース if ステートメントの最後の end if に続くスクリプトの次のステートメントに制御がジャンプします。

マルチケース if ステートメントを使用すると、ケース内で実行フローを変更することができ、スクリプトの結果が大幅に変わる可能性があります。詳細については、以下のケース、次のケースを実行するためのFall Through、ケースの確認を続けるを参照してください。

ケースステートメント

ケースステートメントは、マルチケース if ステートメントの条件を完成させ、そのケースが真と評価されたときに取るべき行動を概説します。全ての形式のケースは、... completedConditional [then|:] に続いて、そのケースが真と評価されたときに実行されるコードから成ります。各ケースの最初の省略記号は通常はオプションです（これは形式2では利用できません）。これは、マルチケース if ステートメントの最初の行の必須の省略記号とは異なります。

1つのコマンドを実行するだけの場合、実行するコードはケースの条件と同じ行に表示されることがあります。複数のコマンドを実行するには、ステートメントリストを使用します。ステートメントリストは次の行から開始されます。これを実際に見るには、マルチケースのif文の3つの形式のいずれかの構文を参照してください。

この例では、スクリプトにテキストを追加しないで Fall Through to Execute Next Case を実行する方法を示しています。この複数のケースを一つに組み合わせる方法は、実行をステートメントなしのケースの数に関わらず、最初のケースステートメントにフォールスルーします。

次のケースステートメントを実行するためのFall Through

Fall Through to Execute Next Caseは、Fall Through to Execute、Fall Through、Execute Next Caseとも略され、ステートメントまたはステートメントリストを持つ次のケースへの実行を移すことを指します。このプロセスではケースは評価されず、単に次の利用可能なコード行が実行されます。

実行可能なコードを持たないケースを記述することで、同様の効果をもたらすこともできます。これらは自動的に次の実行可能なコードのインスタンスへフォールスルーを引き起こします。

[構文:} Fall Through { to Execute {{the} Next Case} }

Execute {the} Next Case

例：

この例では、提供された祝日と年齢に基づいて異なる挨拶を実行するために Fall Through が使われています。年齢に基づいて実行を決定するためにネストされた if ... then ... else conditional を使用しています。全体のマルチケース if ステートメントは、ハンドラを介して実行されます。

put "Halloween" into holiday
Put 25 into age

HolidayGreetings holiday, age

to Handle HolidayGreetings holiday, age -- 与えられた祝日に基づいて挨拶を生成する "to" ハンドラ
  if holiday ...
    ... is "Christmas" then
      Put "家族と一緒にビールを飲んで食事を      します。"
    ... is "Thanksgiving" then
      put "Happy Autumn"
    ... is "Halloween" then
      put "BOO!"
      if age is less than 21 then -- マルチケースifステートメント内にネストされた標準的なif...then...else条件文は、フォールスルーが条件付きで実行されるようにする。
        put "Go trick-or-treating!"
      else
        fall through to next case -- 年齢が21歳を超えている場合、これはフォールスルーし、"St. Patrick's Day"に関連するコードを実行します。そのケースは評価されません。
      end if
    ... is "St. Patrick's Day" then
      put "友達とビールを飲んで食事をします。"
      fall through -- このフォールスルーのステートメントは、評価されずに "else" を実行します。
    ... else
      put holiday & "を素敵に過ごしましょう！"
  end if
end HolidayGreetings

出力:

BOO!
友達とビールを飲んで食事をします。
ハロウィンを素敵に過ごしましょう！

例：

この例では、スクリプトにテキストを追加しないことで次のケースを実行に移す方法を示しています。このように複数のケースを1つに組み合わせる方法では、ステートメントのないケースの後に続く最初のケース文に実行を移すことができます。

put 9 into x
if x ...
  ... = 9: -- この行に実行するコードステートメントがないため、デフォルトの動作はFall ThroughしてExecuteです。
  ... = 10: -- 9がFall Throughとして実行されたため、この値はチェックされません。
  ... = 11: -- この値も同じ理由でチェックされません。
    put "Hooray!" -- xの値が9, 10, または11のいずれかであれば、このステートメントが実行され、"Hooray!"が表示されます。
  ...>= 12:
    put "Boo" -- 値が12以上の場合、このステートメントが実行され、"Boo"が表示されます。
end if

出力:

Hooray!

Keep Checking Cases ステートメント

複数のケースが真と評価される可能性がある場面では、Keep Checking Cases を使用して、真と評価されたケースを見つけた後もケースの評価を続けることができます。Keep Checking Cases は、真と評価される別のケースに出会うまで実行を続けます。その後もケースのチェックを続けるには、別の Keep Checking Cases を含める必要があります。Keep Checking Cases はケースの任意の地点に含めることができますが、通常は最後になります。

構文： keep checking cases

例：

set Wilbur to (nickName:"Wil", lastName:"Wilberforce", age:13)

put Wilbur's nickName & " is a ..."

if Wilbur's age ... -- このマルチケースifステートメントの開始は値、すなわちウィルバーの年齢を指定します。
  ... is less than 1 then -- このケースは演算子と値を提供します。
  put "Infant" -- 上記のケースが真であると判断されたときに実行されるコード。
  ... <= 3 then
    put "Toddler"
  ... less than 14: -- ウィルバーが13歳なので、この例ではこれが真と判断されます。
    put "child"
    keep checking cases -- ウィルバーが14歳未満であると判断された場合、実行は続き、次のケースが真であると判断されるまでチェックされます
  ... is between 13 and 19 : -- ウィルバーが13歳なので、この例ではこれが真と判断されます。
    put "Teenager"
    keep checking cases-- このケースが真であると判断された場合（この例では真である）、通常はここでスクリプトが停止します（たとえ彼が13歳未満であっても）。このKeep Checking Casesラインは、別の真のケースが見つかるまでケースのチェックを続けることを意味します。
    ... less than 18 then put "Minor" -- このケースは真と判断されます。なぜなら、ウィるバーは13歳だからです。
    ... is more than 65 : put "Senior"
  else
    put "Grown-up"
end if