関数

関数とはなんぞや。
使いこなせるようになると制作の幅が広がります。

関数の基本 †

関数とは、何かを入れると何かが返ってくるものです。
変数やトークを呼び出す時と同じように、かっこ（）で使用します。
大きく違うのは、「引数」と呼ばれるオプションがついていること。

（関数名、引数1、引数2、....）

関数名が使いたい機能、引数が処理して欲しいもの...という感じ。
SAORIを使う時もこれと同じ仕組みです。

内部関数 †

里々が内部に持っていて、satori_conf.txtのSAORI定義を全て削除しても使える物。

• 内部関数

外部関数 †

いわゆるSAORIの事。

• 外部関数/ssu ゴースト「ポストと狛犬」に標準で組み込まれているSAORI。Mc157-1より内部関数と統合。
• 外部関数/yaya yayaをSAORIとして使用する方法。
• SAORI SAORIって何？　他のSAORIの組み込み方法は？
• 統合関数一覧

なお、文(yaya)や華和梨などの栞はSAORIとして運用することもできます。
具体的には、何らかのデータ（引数）や命令を文や華和梨に渡して、処理してもらう流れになります。つまり他の栞の多機能な部分だけ拝借できるというわけ。

自作関数 †

利用者が自分で作成する関数のこと。ユーザ関数。
（）やcall関数で文（トーク）＊・単語群＠を呼び出すもの全般、またはcall関数によるものを指します。

• call関数

引数区切りについて †

一般的な関数の書式では、

（関数名[,引数１,引数２,…引数ｎ]）

のように記述しますが、この関数名や引数をそれぞれ区切る文字を「引数区切り文字」と呼びます。
（上記書式では半角カンマ","）
引数区切り文字は標準で"," "，" "､" "、" バイト値１が定義されています。
これらは追加または削除が可能です。→特殊変数-引数区切り追加・削除

引数の文字列に区切り文字と同じ記号が含まれていれば、区切り文字として機能します。
ただし、引数区切り文字が実際に機能するのは、最初に現れたもの一つだけ（らしい）です。従って、さくらスクリプトで使われる半角カンマなどが誤爆するのを防ぐ・引数区切り文字を文字列として使う場合…

＃────区切り文字がさくらスクリプトでも使われていると意図通りの動作をしない
（関数名,hoge,\q[ほげ,メメタァ]）

＃────区切り文字を半角コンマ以外に書き換える
（関数名､hoge､\q[ほげ,メメタァ]）
（関数名、hoge、\q[ほげ,メメタァ]）
（関数名，hoge，\q[ほげ,メメタァ]）

これで半角カンマをただの文字列として動作させられます。

引数区切り文字問題 †

例：（Ｒ０）の中に半角カンマが含まれエラーが出る場合

（split,（Ｒ０）,（バイト値，１））

引数区切り文字を"、"に替えるとエラーを防げる

（split、（Ｒ０）、（バイト値，１））

引数の中に全ての区切り文字が含まれる可能性がある場合は一時的に引数内に含まれない文字を引数区切りとして設定する事でこの問題を回避します。参考：引数区切り追加・削除

例えばファイル名にはカンマ類の文字は全て含まれる可能性があります、ファイル名リストをバイト値１区切りで渡された場合に、ファイル名をsplit関数で分割しようとする場合は引数区切り文字を新たに定義して対処します。参考：split関数

例

＄引数区切り追加【タブ】（バイト値，２）
（split（バイト値，２）（Ｒ０）（バイト値，２）（バイト値，１））
＄引数区切り削除【タブ】（バイト値，２）

例2 上の例は非常に可読性が悪いので対策

＄,【タブ】（バイト値，２）
＄引数区切り追加【タブ】（,）
（split（,）（Ｒ０）（,）（バイト値，１））
＄引数区切り削除【タブ】（,）

when,times,while,forでバイト値を引数区切り文字にする場合の注意 †

参考：ばぐとら研究所統合ToDo
when,times,while,for関数で、区切り文字として（バイト値、１）などと書くと、関数が正しく動かなくなってしまうという現象があります。

原因 †

里々は普通、かっこ（）が入れ子になっている場合、内側のかっこから順に展開していきますが、if関数のように内側の処理系が先に実行されると逆に不都合のあるケースもあり、この対策にwhen,times,while,for関数は、内部のかっこの展開を遅延させる為の特別な処理をしています。
この処理の結果、引数区切り文字に（バイト値、１）などと書くと、そのかっこが展開されるタイミングも遅れてしまい、結果として区切り文字として認識できず、想定外の動作をしてしまうというわけです。

対応策 †

要は直接「バイト値」を書けば問題はありません。
手軽な方法として下記をreplace.txtにコピペし、以下引数区切りには（b1）を使うようにするというものがあります。

（b1）	

透明なので見た目では分かりませんが、（b1）[タブ文字][1バイト文字]と書かれています。即ち、（b1）を1バイト文字に置換するという簡単な動作です。
一見結局かっこを使っているために正しく動かないように思われるかもしれませんが 、ミソはreplace.txtの置換処理が、辞書中のかっこが展開されるよりも先に行われる事です。従ってこの場合、whenなどの関数が実行される時には既に（b1）はバイト値1に置き換わっており、区切り文字として正しく認識されます。

• 参考
  バイト値を自力で書く場合、里々同梱のまずはsatoriteを起動し、下部の「里々」のチェックボックスにチェックが入っていることを確認して、
  

  （バイト値、１）

  とだけ書いて送信します。するとsatoriteの下のほうに、

  \1
  \e

  と表示されるはずです。この\1と\eの間にある空白が紛れもなくバイト値1なので、これをコピーすればバイト値1が使えます（バイト値2以降も同様）。
  

選択肢（＿、\q[]）を含むスクリプトを関数の引数とする場合の注意 †

OnTranslateでトーク全文に対して置換などの処理を行いたい場合など、トーク全文を関数の引数として渡すケースがあると思います。

そのような場合、里々の選択肢記法「＿」や、さくらスクリプトの\q[...]タグがトーク中に存在していると、トーク中に必ずバイト値１が含まれることになります。従って、関数の区切り字には「、」や「,」だけでなく、バイト値１も使用できません。

統合関数一覧 †

• 統合関数一覧へ