KIS リファレンス¶

概要¶

華和梨インラインスクリプト(KIS : Kawari Inline Script)は、華和梨の辞書ファイル中で使用できる簡易言語です。インラインスクリプトを使用することにより、華和梨実行中に辞書へ単語を追加したり、本体から通知されるイベントに応じた処理を行ったりすることができます。

書式¶

インラインスクリプトは、単語中に「$(～)」で囲んで記述します。一つの「$(～)」で囲まれた塊を、「インラインスクリプトブロック」と呼びます。一つのブロックの中には、複数の文を記述できます。文と文の間は「;」(セミコロン)で区切ります。一つの文は、一つのコマンドと零個以上の引数から構成されます。コマンド、セミコロン、各引数の間は、それぞれ一つ以上の空白で区切ります。

インラインスクリプト:
  ブロック

ブロック:
  $(文)
  $(文 ; 文 ; …)

文:
  コマンド名 引数1 引数2 …

評価、戻り値、真偽の判定¶

ブロックがイベント呼び出し、発話要求等を通じて華和梨に解釈されることを、「評価」と呼びます。ブロックは評価されると、「戻り値」を返します。戻り値は一つの文字列で、どのような戻り値を返すかはコマンドによって異なります。コマンドによっては、つねに「""」(空文字列)を返すこともあります。

ブロックが複数の文から成る場合、ブロックの戻り値は、ブロック中の全ての文の戻り値を順に繋げたものです。なお、ブロックから戻り値を返したくない場合、silentコマンドを使用すれば抑制できます。

華和梨が戻り値を評価し、ブール代数における「真」か「偽」かを判定する際、次のような基準で判定します。

• 空文字列「""」、文字列「"0"」、文字列「"false"」ならば「偽」
• 「偽」以外ならば「真」("ほげ"、"1"、"true"、" "(空白)...)

この真偽の判定は、後述する構文コマンド、関数コマンド問わず共通です。コマンドを独自に追加する場合、真偽の判定はこの基準に合わせて下さい。

コマンドの種類¶

コマンドは大きく分けて、ifコマンドやwhileコマンドのような「構文コマンド」と、adddictコマンドやdateコマンドのような「関数コマンド」の二つに分類できます。構文コマンドは与えられた条件の真偽に従い、処理の流れを制御します。一方、関数コマンドは与えられた引数に従い、実際の処理を行います。注1 注2

混同する恐れの無い場合、構文コマンドは「構文」、関数コマンドは単に「コマンド」と呼ぶことがあります。

構文コマンドと関数コマンドの違い¶

構文と関数の、実用上最も重要な違いは、

• 構文の評価は引数評価以前に行われる
• 関数の評価は引数評価以後に行われる

という点です。引数評価以前は、引数は「${npw}」や「$(echo Hello)」等の「書いたまま」の状態です。一方、引数評価以後は、引数は展開されて、「カルロス・ゴーン」や「Hello」等の「文字列だけ」の状態となります。引数が通常の文字列だけである場合はさほど問題になりませんが、引数にsetコマンド等の、戻り値よりも機能が目的となるコマンドがあった場合、この差が意味を持つことになります。

true : 真です。$(set tmp OK)
# 下記の二つは、表示上は恐らく同じ結果だが…
$(entry true ${cond})      # true文はcondが不成立でも実行されてしまう。
$(if ${cond} else ${true}) # true文はcondが不成立なら実行されない。

インラインスクリプトに渡される引数の数¶

コマンドに引数を与える時、エントリ呼び出しで与える場合を考えます。

$(echo $(entry ${EntryName}) "Hello")

このケースで、EntryNameエントリに何もセットされていない場合を考えます。この場合、echoコマンドの第1引数は""で、第2引数が「Hello」になります。第1引数が「Hello」ということはありません。インラインスクリプトに渡される引数の数と位置は、エントリ解釈の前に確定します。

コマンド一覧¶

構文コマンド¶

辞書操作¶

辞書操作コマンドに共通の特徴は、辞書操作コマンド共通事項を参照してください。

ファイル操作¶

カウンタ¶

文字列操作¶

正規表現¶

正規表現コマンド共通の仕様(パターン・オプション・サブルーチン呼び出し)は、正規表現コマンド共通の仕様を参照してください。

SAORI¶

本体との連携¶

コミュニケート機能¶

出力¶

補助機能¶

その他¶